Skip to main content
POST

Autenticación y encabezados

string
requerido
Los endpoints de generación y consulta de tareas usan una API Key de la plataforma para la autenticación Bearer Token. Obtén una clave en la página de gestión de API Keys.
Para consultar la tarea, usa una API Key que pertenezca al mismo usuario de la plataforma.
string
requerido
Usa application/json al enviar la solicitud. Tanto la generación a partir de texto como la basada en imágenes utilizan un cuerpo de solicitud JSON.

Selección de versión

Parámetros de la solicitud

string
requerido
Valor fijo: gpt-image-2.5-ext.
string
predeterminado:"flare"
Versión del modelo. Opciones: flare, sunburst.
string
requerido
Prompt para generar o editar imágenes. No puede quedar vacío después de eliminar los espacios al principio y al final.Para generar a partir de imágenes, describe qué elementos de las referencias deben conservarse y cuáles deben cambiarse.
string
predeterminado:"1K"
Nivel de resolución de salida. Opciones: 1K, 2K, 4K.
string
predeterminado:"auto"
Relación de aspecto de salida. Elige auto o una de las siguientes 10 relaciones:1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, 21:9.
integer
predeterminado:"1"
Número de imágenes que se generarán por solicitud. Debe ser un entero entre 1 y 4.
string[]
Array de hasta 16 imágenes de referencia. Sin referencias, se genera a partir de texto; con referencias, se genera a partir de imágenes. Las referencias no tienen un cargo adicional.Formatos de entrada admitidos:
  • URL de imágenes accesibles
  • Data URL: data:image/...;base64,...

Ejemplos de uso

Los siguientes ejemplos son cuerpos de solicitud JSON para POST /v1/images/generations. Usa la autenticación y los encabezados recomendados anteriormente. Sustituye las direcciones de referencia de los ejemplos por URL de imágenes reales y accesibles.

Generación a partir de texto

Generación a partir de imágenes con Sunburst

Varias imágenes de referencia y de salida

Relación de aspecto automática y resolución 4K

Consultar los resultados de la tarea

Usa el ID de tarea para llamar al endpoint de consulta de tareas:

Tarea completada correctamente

El ID de tarea, las marcas de tiempo, las URL y los importes siguientes solo ilustran la estructura de la respuesta. No representan una tarea real ni precios efectivos.

Respuesta

integer
Código de estado de la respuesta. Un envío correcto en el formato unificado devuelve 200.
string
Identificador de esta solicitud, utilizado para diagnosticar problemas.
object
La tarea asíncrona aceptada.