Image API

Генерация и редактирование изображений

Запускайте GPT Image 2, GPT Image 2.5 Flare, GPT Image 2.5 Sunburst, Nano Banana, Nano Banana 2, Nano Banana 2 Lite, Nano Banana 2.1, Nano Banana Pro, Seedream 4.0, Seedream 4.5, Seedream 5.0, Seedream 5 Pro с единым форматом запроса.

Эндпоинты

Используйте /v1/images/generations для создания изображений по промпту. Принимает JSON.

POSThttps://api.mlmux.com/v1/images/generations

Используйте /v1/images/edits для редактирования или объединения изображений. Передавайте URL изображений в JSON или загружайте файлы через multipart-поля image и mask. Принимается до 16 изображений размером до 50 MB каждое.

POSThttps://api.mlmux.com/v1/images/edits

Пример запроса

curl https://api.mlmux.com/v1/images/generations \
  -H "Authorization: Bearer $MLMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "nano-banana-2",
  "prompt": "Editorial product photo of a ceramic mug on linen, soft window light",
  "aspect_ratio": "4:3",
  "resolution": "2K",
  "output_format": "png",
  "route_mode": "official-cheap"
}'

По умолчанию запросы синхронны и возвращают изображения в ответе. Добавьте "async": true, чтобы вместо этого получить задачу.

Параметры

Поле	Тип	Обязательно	Описание
`model`	string	Да	Идентификатор модели из таблицы ниже. Префикс провайдера можно опустить, если короткое имя уникально, например `gpt-image-2`.
`prompt`	string	Да	Что сгенерировать или изменить, до 20 000 символов.
`image_urls`только редактирование	string[]	Да	Публичные http(s) URL входных изображений по порядку. Для одного изображения также принимается `image_url`.
`mask_url`только редактирование	string	Нет	URL изображения маски для моделей, поддерживающих редактирование по маске.
`route_mode`	string	Нет	`official` или `official-cheap`. По умолчанию используется режим маршрутизации ключа, затем `official-cheap`.
`resolution`	string	Нет	`1K`, `2K` или `4K` для поддерживающих это моделей Gemini. В Nano Banana и Nano Banana 2 Lite настройка разрешения отсутствует.
`size`	string	Нет	Выходной размер для GPT Image и Seedream, например `1024x1024`, `2K` или `auto`.
`aspect_ratio`	string	Нет	Например, `1:1`, `16:9` или `match_input_image`. Допустимые значения зависят от модели.
`output_format`	string	Нет	`png`, `jpg`, `jpeg` или `webp`, если модель это поддерживает.
`n`	integer	Нет	Количество изображений, от 1 до 4. По умолчанию 1.
`async`	boolean	Нет	Значение `true` возвращает задачу (HTTP 202) для поллинга вместо ожидания изображений.

Идентификаторы моделей

Используйте эти значения в model. Запрос GET /v1/models возвращает идентификаторы, доступные вашему аккаунту.

Модель	ID модели
GPT Image 2	`openai/gpt-image-2`
GPT Image 2.5 Flare	`weavy/gpt-image-2.5-flare`
GPT Image 2.5 Sunburst	`weavy/gpt-image-2.5-sunburst`
Nano Banana	`nano-banana`
Nano Banana 2	`nano-banana-2`
Nano Banana 2 Lite	`nano-banana-2-lite`
Nano Banana 2.1	`google/gemini-nano-banana-2.1`
Nano Banana Pro	`nano-banana-pro`
Seedream 4.0	`weavy/doubao-seedream-4-0-250828`
Seedream 4.5	`weavy/doubao-seedream-4-5-251128`
Seedream 5.0	`weavy/doubao-seedream-5-0-260128`
Seedream 5 Pro	`weavy/doubao-seedream-5-0-pro-260628`

GPT Image 2, GPT Image 2.5 Flare и GPT Image 2.5 Sunburst в настоящее время работают только на official. Передавайте "route_mode": "official" для этих моделей; без этого запрос использует значение по умолчанию official-cheap и завершается ошибкой.

Ответ

Синхронный запрос возвращает HTTP 200 с одним URL на изображение в data и количеством токенов в usage. Выходные URL размещаются на серверах MLMux; скачайте файлы, которые хотите сохранить.

200 OK

{
  "created": 1767225600,
  "data": [
    { "url": "https://.../generated/9f2c....png" }
  ],
  "usage": {
    "input_tokens": 18,
    "output_tokens": 1120,
    "total_tokens": 1138,
    "input_tokens_details": { "text_tokens": 18, "image_tokens": 0 }
  }
}

Асинхронные запросы

При "async": true запрос возвращает HTTP 202 и задачу. Опрашивайте ее poll_url, пока status не станет succeeded; затем изображения будут перечислены в data.

GEThttps://api.mlmux.com/v1/images/generations/{task_id}

202 Accepted

{
  "id": "task_7c1e...",
  "object": "image.generation.task",
  "status": "queued",
  "created": 1767225600,
  "model": "nano-banana-2",
  "api_method": "images.generations.create",
  "poll_url": "/v1/images/generations/task_7c1e...",
  "progress": 0,
  "message": "queued",
  "estimated_charge_credits": 0.067
}

Успешно

{
  "id": "task_7c1e...",
  "object": "image.generation.task",
  "status": "succeeded",
  "progress": 100,
  "message": "completed",
  "estimated_charge_credits": 0.067,
  "data": [
    { "url": "https://.../generated/7c1e....png" }
  ]
}

Задачи редактирования изображений опрашиваются по адресу /v1/images/edits/{task_id}. GET /v1/tasks/{task_id} работает для любой задачи.