Felo API PlatformFelo API Platform
Назад до моделей

MiniMax H3 Image API

MiniMax-H3-Image — генеративна модель MiniMax, яка створює та редагує зображення роздільністю до 4096 на 4096 пікселів, підтримуючи до 16 референсних зображень і текстовий ввід.

MiniMax-H3-Image — це модель від MiniMax для генерації та редагування зображень. Вона приймає текст і зображення на вхід, а на виході видає зображення роздільністю до 4096 на 4096 пікселів (16 мегапікселів). Модель підтримує генерацію зображень із тексту, а також редагування з кількома референсними зображеннями — до 16 штук. За документацією, H3-Image-Context-IR розширює короткі запити іншими мовами в детальні англійські описи, а серед відкритих моделей ця демонструє найкраще дотримання інструкцій.

Модель добре підходить для реклами та брендингу, електронної комерції, продуктового дизайну, UI/UX, ігор, концепт-арту, дослідження продуктів і ітерацій макетів. Завдяки багатим референсам можна виконувати точкові редагування, зберігаючи частини кадру незмінними. Вихідні зображення вирізняються насиченою деталізацією та реалістичністю.

Параметри інференсу фіксовані: num_inference_steps 6 і guidance_scale 1; інші значення повертають помилку HTTP 400. Негативні запити не підтримуються й відхиляються. Запит обрізається до 4096 токенів. Параметр min_generation_area охоплює від 1024 до 16777216 пікселів, типове значення — 4194304 (2048 на 2048). Менші запитані розміри генеруються на більшому полотні з тим самим співвідношенням сторін і змінюються інтерполяцією LANCZOS. Для відтворюваності зерна рекомендується встановлювати пристрій генератора на CPU, а response_format — на b64_json. Модель випущено за ліцензією MiniMax-H3-Image Community License Agreement; комерційне використання, що потребує окремого письмового дозволу, запитується через platform.minimax.io/license.

ОбмеженоБезкоштовний пробний період

Оновлено:

MODEL ID

minimax-h3-image
Вхід
text / image
Вихід
image

Ключові можливості

  • Роздільність до 4096 на 4096 пікселів (16 Мп)
  • Редагування з до 16 референсними зображеннями
  • Фіксовані num_inference_steps 6 і guidance_scale 1
  • Запит обрізається до 4096 токенів
  • H3-Image-Context-IR розширює короткі запити іншими мовами
  • Ліцензія MiniMax-H3-Image Community License Agreement

Постачальники

1 постачальників

Порівняйте ціни API у різних постачальників. Виберіть постачальника, щоб переглянути всі тарифи й умови.

Постачальник · Деталі тарифів
Доступність

Швидкий старт

Надішліть завдання зображення, перевіряйте стан і збережіть зображення. Приклади використовують curl і стандартну бібліотеку Python 3.

POST https://openapi.felo.ai/api/v1/images/generations

1Отримайте API-ключ

Створіть ключ у своєму обліковому записі Felo API Platform і встановіть його як змінну середовища.

export FELO_API_KEY="YOUR_API_KEY"

2Зробіть перший запит

Необов’язкові значення залежать від моделі та тут не задані. Перевірте їх у Playground. Поля розташовані поруч із model і prompt, без обгортки input.

curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -o created.json \
  -d '{
  "prompt": "A studio product photo of a ceramic coffee cup on warm linen, soft morning light",
  "model": "minimax-h3-image"
}'

3Опитувати завдання

Надсилання повертає task_id. При queued або running перевіряйте кожні 3 секунди; при succeeded, failed або interrupted зупиніться. Очікуйте до 30 хвилин. Збережіть created.json для продовження без повторного надсилання.

python3 - <<'PY'
import json, os, time
from pathlib import Path
from urllib.parse import quote
from urllib.request import Request, urlopen

task = json.loads(Path("created.json").read_text())
task_id = task["task_id"]
url = "https://openapi.felo.ai/api/v1/images/generations/" + quote(task_id, safe="")
headers = {"Authorization": "Bearer " + os.environ["FELO_API_KEY"]}
deadline = time.monotonic() + 1800

while task["status"] in ("queued", "running"):
    if time.monotonic() >= deadline:
        raise TimeoutError(f"Keep task_id={task_id} to resume polling")
    time.sleep(3)
    with urlopen(Request(url, headers=headers), timeout=60) as response:
        task = json.load(response)
    if task.get("task_id") != task_id or task.get("kind") != "image":
        raise ValueError("Unexpected task response")
    print(task["status"])

if task["status"] != "succeeded":
    raise RuntimeError(task.get("error") or task["status"])
if not task.get("outputs"):
    raise ValueError("Task succeeded without image outputs")
Path("task.json").write_text(json.dumps(task))
print("Saved task.json")
PY

4Завантажити вихід

Після успіху збережіть outputs із task.json. Підтримуються HTTPS URL, об’єкти URL і b64_json. Підписані посилання завантажуйте вчасно; для зображень API-ключ не потрібен.

python3 - <<'PY'
import base64, json
from pathlib import Path
from urllib.request import urlopen

task = json.loads(Path("task.json").read_text())
if task.get("status") != "succeeded" or not task.get("outputs"):
    raise ValueError("No completed image outputs")
extensions = {"image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp", "image/gif": ".gif", "image/avif": ".avif"}

for index, output in enumerate(task["outputs"], 1):
    item = output if isinstance(output, dict) else {}
    url = output if isinstance(output, str) else item.get("url") or item.get("unsigned_url")
    mime = item.get("media_type") or "image/png"
    if url and url.startswith("https://"):
        with urlopen(url, timeout=60) as response:
            data = response.read()
            mime = response.headers.get_content_type()
    elif url and url.startswith("data:image/") and ";base64," in url:
        header, encoded = url.split(",", 1)
        mime = header[5:].split(";", 1)[0]
        data = base64.b64decode(encoded, validate=True)
    elif item.get("b64_json"):
        data = base64.b64decode(item["b64_json"], validate=True)
    else:
        raise ValueError("Unrecognized image output")
    path = Path(f"image-{index}" + extensions.get(mime, ".bin"))
    path.write_bytes(data)
    print(path)
PY
input_references

Для редагування замініть URL прикладу своїм HTTPS URL зображення або base64 data URL. Надішліть один раз, далі використовуйте ті самі кроки перевірки та збереження.

curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -o created.json \
  -d '{
  "prompt": "Keep the product and framing. Replace the background with a sunlit marble countertop.",
  "model": "minimax-h3-image",
  "input_references": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/product.png"
      }
    }
  ]
}'

Підтримувані параметри

  • n
  • size
  • resolution
  • aspect_ratio
  • output_format
  • input_references

Потрібна повна довідка?

Довідка API →

Часті запитання

Що таке MiniMax H3 Image?

MiniMax-H3-Image — це модель від MiniMax для генерації та редагування зображень. Вона приймає текст і зображення на вхід, а на виході видає зображення роздільністю до 4096 на 4096 пікселів (16 мегапікселів). Модель підтримує генерацію зображень із тексту, а також редагування з кількома референсними зображеннями — до 16 штук. За документацією, H3-Image-Context-IR розширює короткі запити іншими мовами в детальні англійські описи, а серед відкритих моделей ця демонструє найкраще дотримання інструкцій. Модель добре підходить для реклами та брендингу, електронної комерції, продуктового дизайну, UI/UX, ігор, концепт-арту, дослідження продуктів і ітерацій макетів. Завдяки багатим референсам можна виконувати точкові редагування, зберігаючи частини кадру незмінними. Вихідні зображення вирізняються насиченою деталізацією та реалістичністю. Параметри інференсу фіксовані: num_inference_steps 6 і guidance_scale 1; інші значення повертають помилку HTTP 400. Негативні запити не підтримуються й відхиляються. Запит обрізається до 4096 токенів. Параметр min_generation_area охоплює від 1024 до 16777216 пікселів, типове значення — 4194304 (2048 на 2048). Менші запитані розміри генеруються на більшому полотні з тим самим співвідношенням сторін і змінюються інтерполяцією LANCZOS. Для відтворюваності зерна рекомендується встановлювати пристрій генератора на CPU, а response_format — на b64_json. Модель випущено за ліцензією MiniMax-H3-Image Community License Agreement; комерційне використання, що потребує окремого письмового дозволу, запитується через platform.minimax.io/license.

Як нараховується оплата за використання?

Рахунок залежить від обраного постачальника, його цін і вашого використання. Довші вхідні дані або інші умови можуть мати інші ціни. Оплата за фактичною вартістю генерації. Остаточну суму дивіться в рахунку.

Які типи вводу підтримує MiniMax-H3-Image?

Модель приймає текст і зображення на вхід та видає зображення на виході. Вона підтримує генерацію зображень із тексту й редагування з кількома референсними зображеннями.

Скільки референсних зображень можна використати?

Під час редагування підтримується до 16 референсних зображень.

Які обмеження на довжину запиту?

Запит обрізається до 4096 токенів.

Чи можна змінювати кроки інференсу та guidance scale?

Ні, ці параметри фіксовані: num_inference_steps 6 і guidance_scale 1. Інші значення повертають помилку HTTP 400.

Чи підтримуються негативні запити?

Ні, негативні запити не підтримуються й відхиляються.

Чим MiniMax-H3-Image-PE відрізняється від MiniMax-H3-Image?

MiniMax-H3-Image-PE — це локально розгортуваний варіант, який можна запускати з локальним сервером SGLang. Основна версія MiniMax-H3-Image доступна через платформу MiniMax.

Схожі моделі