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
Постачальники
Порівняйте ціни 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")
PY4Завантажити вихід
Після успіху збережіть 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)
PYinput_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.