Image API

Generar y editar imágenes

Ejecute 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 con un solo formato de solicitud.

Endpoints

Usa /v1/images/generations para crear imágenes a partir de un prompt. Acepta JSON.

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

Usa /v1/images/edits para editar o combinar imágenes. Envía las URL de las imágenes en JSON o sube archivos con los campos multipart image y mask. Se admiten hasta 16 imágenes de 50 MB cada una.

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

Ejemplo de solicitud

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"
}'

Las solicitudes son síncronas de forma predeterminada y devuelven las imágenes en la respuesta. Añade "async": true para obtener una tarea en su lugar.

Parámetros

Campo	Tipo	Obligatorio	Descripción
`model`	string	Sí	Un ID de modelo de la tabla a continuación. El prefijo del proveedor se puede omitir cuando el nombre corto es único, por ejemplo `gpt-image-2`.
`prompt`	string	Sí	Qué generar o modificar, hasta 20.000 caracteres.
`image_urls`solo ediciones	string[]	Sí	URL públicas http(s) de las imágenes de entrada, en orden. También se acepta `image_url` para una sola imagen.
`mask_url`solo ediciones	string	No	URL de una imagen de máscara para modelos que admiten ediciones con máscara.
`route_mode`	string	No	`official` u `official-cheap`. El valor predeterminado es el route mode de la clave y luego `official-cheap`.
`resolution`	string	No	`1K`, `2K` o `4K` en los modelos Gemini que lo admiten. Nano Banana y Nano Banana 2 Lite no tienen ajuste de resolución.
`size`	string	No	Tamaño de salida para GPT Image y Seedream, como `1024x1024`, `2K` o `auto`.
`aspect_ratio`	string	No	Como `1:1`, `16:9` o `match_input_image`. Los valores permitidos dependen del modelo.
`output_format`	string	No	`png`, `jpg`, `jpeg` o `webp`, si el modelo lo admite.
`n`	integer	No	Número de imágenes, de 1 a 4. El valor predeterminado es 1.
`async`	boolean	No	`true` devuelve una tarea (HTTP 202) para consultar mediante sondeo en lugar de esperar las imágenes.

ID de modelos

Usa estos valores en model. GET /v1/models devuelve los ID disponibles para tu cuenta.

Modelo	ID del modelo
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`

Actualmente, GPT Image 2, GPT Image 2.5 Flare y GPT Image 2.5 Sunburst solo funcionan en official. Envía "route_mode": "official" con estos modelos; sin él, la solicitud utiliza el valor predeterminado official-cheap y falla.

Respuesta

Una solicitud síncrona devuelve HTTP 200 con una URL por imagen en data y el conteo de tokens en usage. Las URL de salida están alojadas en MLMux; descarga los archivos que quieras conservar.

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 }
  }
}

Solicitudes asíncronas

Con "async": true, la solicitud devuelve HTTP 202 y una tarea. Sondea su poll_url hasta que status sea succeeded; las imágenes se mostrarán entonces en 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
}

Completado

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

Las tareas de edición de imágenes se consultan en /v1/images/edits/{task_id}. GET /v1/tasks/{task_id} funciona para cualquier tarea.