MiniMax H3 Image Highspeed API
MiniMax H3 Image Highspeed — це швидкісний варіант моделі MiniMax H3 Image, який генерує та редагує зображення з тексту й до 16 референсних картинок, працює у 3–4 рази швидше за стандартну версію та підтримує роздільну здатність до 16 мегапікселів.
MiniMax H3 Image Highspeed — це оптимізований за швидкістю варіант у лінійці MiniMax H3 Image. Модель приймає текстові запити та зображення на вхід і повертає зображення на вихід. Вона здатна генерувати картинки з текстових описів, редагувати наявні зображення та поєднувати до 16 референсних зображень в одній генерації. Крім того, модель добре відтворює довгі й щільні тексти, читає довгі запити та розповсюджується як модель з відкритими вагами.
Highspeed-режим працює у 3–4 рази швидше за стандартний режим, а стандартний режим, своєю чергою, у 1,5–2 рази швидший за деякі конкуруючі моделі. Модель видає зображення у власній роздільній здатності близько 16 мегапікселів і підтримує співвідношення сторін від 1:3 до 3:1. Вона приймає ті самі параметри й обмеження, що й стандартна версія, і може запускатися локально на помірному обладнанні. Водночас ефективний коефіцієнт просторового стиснення 32x означає, що на певних роздільних здатностях зображення можуть бути значно розмитішими, а дрібні деталі можуть бути недостатньо опрацьованими. Модель також є важкою через 32b текстовий енкодер.
Модель добре підходить для швидкого прототипування, пакетної обробки, створення складних композицій із багатьма елементами та збереження узгодженості персонажів. Вона також підходить для генерації постерів, інфографіки, екранів інтерфейсу користувача та маркетингових матеріалів. Завдяки підтримці референсних зображень і редагування вона стане в пригоді для задач, де потрібно швидко отримати візуальний результат на основі наявних матеріалів.
Оновлено:
MODEL ID
minimax-h3-image-highspeed- Вхід
- text / image
- Вихід
- image
Ключові можливості
- У 3–4 рази швидше за стандартний режим
- До 16 референсних зображень у генерації
- Роздільна здатність до 16 мегапікселів
- Співвідношення сторін від 1:3 до 3: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-highspeed"
}'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-highspeed",
"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 Highspeed?
MiniMax H3 Image Highspeed — це оптимізований за швидкістю варіант у лінійці MiniMax H3 Image. Модель приймає текстові запити та зображення на вхід і повертає зображення на вихід. Вона здатна генерувати картинки з текстових описів, редагувати наявні зображення та поєднувати до 16 референсних зображень в одній генерації. Крім того, модель добре відтворює довгі й щільні тексти, читає довгі запити та розповсюджується як модель з відкритими вагами. Highspeed-режим працює у 3–4 рази швидше за стандартний режим, а стандартний режим, своєю чергою, у 1,5–2 рази швидший за деякі конкуруючі моделі. Модель видає зображення у власній роздільній здатності близько 16 мегапікселів і підтримує співвідношення сторін від 1:3 до 3:1. Вона приймає ті самі параметри й обмеження, що й стандартна версія, і може запускатися локально на помірному обладнанні. Водночас ефективний коефіцієнт просторового стиснення 32x означає, що на певних роздільних здатностях зображення можуть бути значно розмитішими, а дрібні деталі можуть бути недостатньо опрацьованими. Модель також є важкою через 32b текстовий енкодер. Модель добре підходить для швидкого прототипування, пакетної обробки, створення складних композицій із багатьма елементами та збереження узгодженості персонажів. Вона також підходить для генерації постерів, інфографіки, екранів інтерфейсу користувача та маркетингових матеріалів. Завдяки підтримці референсних зображень і редагування вона стане в пригоді для задач, де потрібно швидко отримати візуальний результат на основі наявних матеріалів.
Як нараховується оплата за використання?
Рахунок залежить від обраного постачальника, його цін і вашого використання. Довші вхідні дані або інші умови можуть мати інші ціни. Оплата за фактичною вартістю генерації. Остаточну суму дивіться в рахунку.
Які типи вхідних і вихідних даних підтримує модель?
Модель приймає текстові запити та зображення на вхід, а на вихід повертає зображення.
Скільки референсних зображень можна передати в одній генерації?
Модель дозволяє поєднувати до 16 референсних зображень в одній генерації.
Чим Highspeed-версія відрізняється від стандартної?
Highspeed-режим працює у 3–4 рази швидше за стандартний режим, але приймає ті самі параметри й обмеження, що й стандартна версія.
Для яких задач найкраще підходить ця модель?
Вона добре підходить для генерації зображень за текстом, редагування зображень, створення постерів, інфографіки, екранів інтерфейсу, маркетингових матеріалів, швидкого прототипування та пакетної обробки.
Чи можна запускати модель локально?
Так, модель можна запускати локально на помірному обладнанні. Користувачі повідомляли про генерацію зображень розміром 5–10 мегапікселів із 16 ГБ відеопам’яті та про роздільну здатність понад 2 мегапікселі з 20+ кроками на 6 ГБ відеопам’яті й 16 ГБ системної пам’яті.