GPT Image 2.6

GPT Image 2.6 acepta prompts de texto e imágenes de referencia opcionales. Envía una sola solicitud a POST /v1/images/generations, guarda el ID de tarea y consulta GET /v1/tasks/{id} para obtener el resultado. Los archivos terminados se devuelven como URL.

IDs de modelo y precios

Usa GET /v1/models para descubrir los modelos disponibles para tu clave. Los IDs de Sunburst configurados son gpt-image-2.6-sunburst-official y gpt-image-2.6-sunburst. Los IDs de Flare, cuando aparecen en la lista, usan el mismo contrato de parámetros. El ID de modelo sin sufijo usa su grupo Default; los grupos adicionales usan el ID model:group que muestra la consulta de modelos.

Consulta los precios actuales y el Playground. Los modelos con precio por token se liquidan según el uso real; los modelos con precio por imagen usan el precio de imagen configurado. Las respuestas SVG informan por separado en svg_usage de los tokens del modelo que escribe el código, facturados al precio propio de ese modelo en SeedRouter.

Generar una imagen

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-sunburst-official",
    "prompt": "A red paper crane on a pale blue table, soft daylight",
    "size": "1024x1024",
    "quality": "low",
    "complexity": "high"
  }'

La respuesta contiene un id. Consulta ese ID en lugar de volver a enviar la generación:

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

Al terminar, output.data contiene objetos con una url. Descarga la URL para conservar el formato de archivo original y, en los GIF, todos los fotogramas de la animación. Una tarea fallida contiene un error y no se cobra. Consulta los estados de tarea y las consultas de estado.

Parámetros

Hay 18 campos de primer nivel. Solo model y prompt son obligatorios. Los campos opcionales aceptan null, que equivale a omitirlos. Los campos desconocidos se descartan. Los valores no válidos de los parámetros admitidos no superan la validación previa a la generación de imágenes.

Las URL de referencia deben usar HTTP o HTTPS y no deben contener credenciales. No se aceptan IDs de archivo, base64 en línea ni cargas multipart; sube primero los archivos y proporciona sus URL públicas. Las solicitudes usan consultas de estado de tareas asíncronas en lugar de stream o partial_images. Este contrato no expone input_fidelity, response_format ni prompt_rewriter.

Tamaño de imagen

Para la generación de PNG, JPEG e imágenes de referencia para SVG, cada dimensión debe ser divisible por 16 y no superar los 3840 píxeles. El total debe estar entre 655.360 y 8.294.400 píxeles y la relación de aspecto entre 1:3 y 3:1. Ejemplos: 1024x1024, 1536x1024, 2160x3840, 2880x2880.

Las dimensiones de un GIF deben ser múltiplos positivos de 16, o puedes usar auto. GIF tiene un límite total de píxeles independiente que comparten el número de fotogramas, sus dimensiones y n; OpenAI no ha publicado su valor numérico. Un GIF de 512x512 no está sujeto al mínimo de píxeles de las imágenes estáticas.

GIF animado

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A red paper crane flapping its wings in a seamless loop on pale blue",
  "output_format": "gif",
  "size": "512x512",
  "quality": "low",
  "frame_count": 4,
  "frame_duration_ms": 200
}

Puedes generar un GIF a partir de un prompt o solicitarlo a partir de imágenes de referencia. No lo combines con una máscara ni con compresión. La disponibilidad de la vista previa puede depender del acceso del modelo seleccionado.

Discrepancia en la documentación, comprobada el 5 de noviembre de 2026: la guía de generación de imágenes de OpenAI indica 2–64 fotogramas y 20–2000 ms, y afirma que el endpoint de edición no devuelve GIF. La referencia de Images API indica 2–16 fotogramas, sin duración máxima, e incluye salida GIF en las ediciones. Las solicitudes al servicio de origen del 5 de noviembre de 2026 coincidieron con la referencia: se rechazaron 17 fotogramas y se aceptó un fotograma de 3000 ms. Esta API sigue la referencia.

SVG

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A simple geometric red paper-crane logo, clean editable vector paths",
  "output_format": "svg",
  "n": 1
}

SVG solo está disponible para generación y requiere n: 1. No envíes imágenes, una máscara, marcas ni compresión. El archivo es XML UTF-8 estático con formas vectoriales; no admite scripts, recursos externos ni imágenes rasterizadas incrustadas.

Cuando esté disponible la selección del modelo que escribe el código, añade svg: {"model":"YOUR_AUTHOR_MODEL_ID"}. Un objeto svg proporcionado explícitamente requiere un model no vacío. También puedes establecer svg.reasoning.effort en none, minimal, low, medium, high, xhigh o max; el modelo elegido determina los valores que admite. Omite reasoning para usar su valor por defecto. OpenAI no publica una lista de modelos permitidos para escribir el código ni un valor por defecto universal. Si esa selección no está disponible, omite todo el objeto svg.

El resultado terminado puede incluir svg_usage con model, input_tokens, output_tokens, reasoning_tokens y total_tokens. Es independiente del usage de imagen, no un recuento adicional de tokens de imagen.

Imágenes de referencia, máscara y marcas

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "Replace the marked background with a pale blue studio backdrop",
  "images": [{"image_url":"https://example.com/reference.png"}],
  "markup": {"image_url":"https://example.com/transparent-markup.png"},
  "output_format": "png",
  "complexity": "low"
}

Las imágenes de referencia admiten PNG, JPEG y WebP, hasta 50 MB por imagen. La máscara y las marcas deben ser PNG y tener las mismas dimensiones que la primera imagen de referencia tras aplicar la orientación. Las marcas deben contener píxeles transparentes; tanto las marcas como la primera imagen de referencia pueden tener hasta 16.777.216 píxeles, y las marcas pueden ocupar hasta 50 MB. La máscara y las marcas son mutuamente excluyentes.

Campos de respuesta

La salida de imagen terminada contiene created, data: [{url}] y, cuando se informan, size, quality, background, output_format, usage, svg_usage y safety_identifier. usage puede desglosar los tokens de entrada y salida de texto e imagen y la entrada en caché. La salida pública no incluye bytes de imagen en base64 ni campos de coste.

Esquema OpenAPI · Referencia de generación de OpenAI · Referencia de edición de OpenAI · Guía de imágenes de OpenAI