Descripcion general
Este endpoint se conserva para clientes legacy de variaciones compatibles con OpenAI. No es la ruta recomendada para flujos image-to-image actuales; usa/v1/images/edits con gpt-image-2 o /v1/images/generations con un modelo image-to-image como nano-banana-pro cuando sea posible. Requiere multipart/form-data.
Cuerpo de la solicitud
Tiempo de espera de solicitudes síncronas: algunos proveedores de imagen enrutados devuelven la imagen final inline y esperan a que termine la generación. Las solicitudes de alta resolución o alta calidad pueden tardar cerca de un minuto o más, así que configura el timeout de tu cliente HTTP en al menos120s. Si la respuesta de creación incluye status: "pending", task_id o poll_url, sigue el poll_url devuelto en su lugar.
La imagen a usar como base para la variacion. Debe ser un archivo PNG valido, menor de 50MB y cuadrado.
Identificador de modelo obligatorio para rutas legacy compatibles con variaciones. No hay valor predeterminado implícito; para flujos image-to-image actuales, prefiere
/v1/images/edits o /v1/images/generations con un modelo actual.El numero de imagenes a generar. Debe estar entre 1 y 10.
Tamaño de las imágenes generadas para rutas legacy compatibles con variaciones. Los valores admitidos dependen del modelo seleccionado.
El formato en que se devuelven las imagenes generadas. Debe ser
url o b64_json.Un identificador unico que representa a su usuario final para monitoreo de abuso.
Respuesta
Marca de tiempo Unix de cuando se crearon las imagenes.
Array de variaciones de imagen generadas.Cada objeto contiene:
url(string): URL de la imagen de variacion (si response_format esurl)b64_json(string): Imagen codificada en Base64 (si response_format esb64_json)
Notas
Este es un endpoint de compatibilidad legacy. No está incluido en el catálogo actual de modelos de imagen recomendados. Para integraciones nuevas, usa
/v1/images/edits con gpt-image-2, o /v1/images/generations con operation: "image-to-image" y un modelo image-to-image actual.