MiniMax H3 Image Highspeed

Краткий пример

Отправь один запрос на изображение, сохрани полученный id и опрашивай статус, пока задача не перейдёт в completed или failed. Этот API использует асинхронные задачи и возвращает результаты в виде URL.

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"minimax-h3-image-highspeed","prompt":"An amber bottle on pale limestone in soft morning light","area":"1K","aspect_ratio":"3:2"}'

Конечная точка и заголовки

POST https://api.seedrouter.ai/v1/images/generations

Храни ключ на своём сервере. Успешный HTTP-ответ подтверждает приём задачи, но не означает, что изображение готово.

Параметры

Принимаются 13 полей. Обязательны только model и prompt. Опусти необязательные поля, чтобы использовать значения по умолчанию; ни одно поле не принимает null. Playground предоставляет фиксированную модель и десять редактируемых полей ввода. Формат ответа URL и непотоковая передача задач фиксированы.

Зависимости размера и промпта

Явно заданный size должен содержать положительные целочисленные размеры с площадью от 655 360 до 20 000 000 пикселей включительно. Ширина, делённая на высоту, должна быть от 1/3 до 3. Например, 2048x1152 — допустимое значение. При явном указании размеров опусти и aspect_ratio, и area, даже если их значением было бы auto.

Если размер опущен или равен auto, используй aspect_ratio и area вместе. Площадь — целевой размер; проверь полученный файл, чтобы узнать точные размеры. Это не фиксированная цена за одно изображение.

Для установки disable_prompt_enhanced: true нужен явный размер в пикселях или фиксированное соотношение сторон. При отключённом улучшении модель читает примерно первые 4 096 токенов промпта. Ограничение отправки в 32 000 символов по-прежнему действует. При редактировании промпты всегда улучшаются, поэтому true отклоняется, если присутствует images.

Поля маски, seed, стиля, качества, негативного промпта, фона или отдельного разрешения не принимаются. Неизвестные параметры возвращают ошибку до отправки. Этот API не предоставляет потоковую передачу, изображения base64 и вывод WebP.

Референсные изображения

Используй общедоступные URL HTTP(S) без встроенных учётных данных. Каждое изображение должно быть в формате JPEG, PNG, WebP, HEIC или HEIF; размером не более 64 MiB; с каждой стороной 128–8 192 пикселя; с отношением длинной стороны к короткой не более 4. Размер тела JSON не должен превышать 64 MiB. Файлы изображений указываются через URL; их байты не встраиваются в тело JSON.

Задай чёткое назначение каждому референсу и опиши, что должно остаться неизменным. Порядок в массиве определяет <Picture 1>, <Picture 2> и так далее.

{
  "model": "minimax-h3-image-highspeed",
  "prompt": "Use <Picture 1> as the product and <Picture 2> as the setting. Preserve the product's shape and label. Match the setting's light and perspective.",
  "images": [
    {"image_url": "https://example.com/product.jpg"},
    {"image_url": "https://example.com/setting.jpg"}
  ],
  "aspect_ratio": "3:2",
  "area": "2K",
  "n": 1,
  "output_format": "png"
}

Замени URL для примера своими доступными файлами изображений.

Оплата

Оплата включает три категории токенов: текстовый ввод, ввод изображений и вывод изображений. Умножь фактическое использование в каждой категории на её текущий тариф. Количество результатов, размеры изображений и референсные изображения влияют на использование; названия разрешений не определяют фиксированную сумму счёта. Неудачные запросы не оплачиваются. См. текущие цены.

Ответ задачи и опрос статуса

Принятый запрос возвращает асинхронную задачу:

{"id":"task_example","model":"minimax-h3-image-highspeed","status":"processing"}

curl https://api.seedrouter.ai/v1/tasks/task_example \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Завершённый ответ содержит URL изображений в output.data. Каждое полученное изображение содержит свой size и может содержать revised_prompt (улучшенное описание). output.created — время создания в секундах Unix, а output.output_format обозначает полученный формат. output.usage предоставляет количество токенов текстового ввода, ввода изображений и вывода изображений, а также количество полученных generated_images. URL и ID ниже приведены для примера:

{
  "id": "task_example",
  "model": "minimax-h3-image-highspeed",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.jpg"}]}
}

Опрашивай статус каждые 10–20 секунд. Тайм-аут клиента не означает сбой задачи: сохрани её ID и продолжай опрос вместо отправки дублирующего запроса. Публичные ответы не содержат баланса счёта или стоимости.

Ошибки

Ошибки HTTP используют {"error":{"code":integer,"message":string}}. Неудачная задача имеет status: "failed" и ошибку. Исправь недопустимые параметры перед новой отправкой. См. общий справочник ошибок и жизненный цикл задачи.

Связанные страницы

• MiniMax H3 Image Highspeed Playground и цены
• MiniMax H3 Image