Saltar al contenido principal
Usa /v1/images/generations para la generación de imágenes en producción.
La respuesta devuelve una tarea:

Variante síncrona

/v1/images/generations/sync crea una tarea y espera hasta el tiempo máximo de espera configurado. Úsala para compatibilidad y demos. Usa el endpoint asíncrono para cargas de trabajo de producción.

Edición de imágenes

/v1/images/edits admite flujos de edición de imágenes estilo OpenAI cuando el modelo seleccionado admite imágenes de referencia.

Calidad y enrutamiento de GPT Image 2.5

gpt-image-2.5 es un alias fijo de Flare; usa gpt-image-2.5-sunburst para edición precisa. quality (auto/low/medium/high/xhigh/max) y resolution (1K/2K/4K) son independientes. Los píxeles explícitos deben coincidir con la resolución y APIAny elige solo rutas compatibles ordenadas por coste sin eliminar campos.
La edición admite hasta 16 referencias y una máscara opcional.

GPT Image 2.6

gpt-image-2.6 usa los endpoints de imagen existentes para PNG y GIF animados; no hay una API GIF separada. Cada solicitud correcta cuesta 30 créditos y devuelve un resultado. Compruebe la disponibilidad en GET /v1/models antes de llamar. Use output_format: "png" (predeterminado) o "gif", quality: "auto", resolution: "1K" y n: 1. size admite auto, 1:1, 3:2, 2:3, 1024x1024, 1536x1024 o 1024x1536. Se acepta como máximo una referencia. Los mismos límites se aplican a alias y model_params; los valores contradictorios devuelven HTTP 400. No se admiten SVG, JPEG, WebP, 2K/4K, máscaras, compresión, frame_count ni frame_duration_ms. Las dimensiones, los fotogramas y los intervalos del GIF no se pueden configurar. background puede omitirse y solo admite auto. Las solicitudes SVG devuelven HTTP 400, no un PNG.

PNG con espera síncrona

GIF con una imagen de referencia

El endpoint de edición acepta JSON con una entrada image_urls o un archivo multipart image. No añada una máscara. output_format selecciona el formato de salida; la edición GIF también devuelve un único archivo animado.
También puede subir un archivo de referencia con multipart/form-data:
Los endpoints síncronos y de edición devuelven HTTP 200 con data[0].url al completarse, o HTTP 202 con task_id y poll_url mientras siguen pendientes. Consulte /v1/tasks/{task_id} hasta completed o failed, manteniendo el mismo ID en pending o processing. La generación asíncrona usa /v1/images/generations y el archivo completado está en result.data[0].url. Los resultados GIF no válidos o estáticos fallan y siguen la política normal de reembolso de créditos para tareas fallidas. Parámetros completos, ejemplos PNG/GIF asíncronos y respuestas de consulta