Skip to main content

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 menos 120s. Si la respuesta de creación incluye status: "pending", task_id o poll_url, sigue el poll_url devuelto en su lugar.
file
requerido
La imagen a usar como base para la variacion. Debe ser un archivo PNG valido, menor de 50MB y cuadrado.
string
requerido
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.
integer
predeterminado:"1"
El numero de imagenes a generar. Debe estar entre 1 y 10.
string
Tamaño de las imágenes generadas para rutas legacy compatibles con variaciones. Los valores admitidos dependen del modelo seleccionado.
string
predeterminado:"url"
El formato en que se devuelven las imagenes generadas. Debe ser url o b64_json.
string
Un identificador unico que representa a su usuario final para monitoreo de abuso.

Respuesta

integer
Marca de tiempo Unix de cuando se crearon las imagenes.
array
Array de variaciones de imagen generadas.Cada objeto contiene:
  • url (string): URL de la imagen de variacion (si response_format es url)
  • b64_json (string): Imagen codificada en Base64 (si response_format es b64_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.