Referencia para desarrolladores

Documentación de la API GPT Image 2.6

Crea una clave API, envía una solicitud de generación y consulta la tarea para obtener tu imagen.

Crea tu clave API

Inicia sesión y crea una clave en tu cuenta. Antes de ejecutar los ejemplos, establece GPT_IMAGE_API_KEY con esa clave en el entorno de tu servidor.

Gestionar claves API

Guarda la clave en tu servidor. Ambos puntos de acceso usan tu clave API de usuario mediante Authorization: Bearer y no requieren cookies del navegador.

Las solicitudes de generación consumen créditos de tu cuenta. Con la misma configuración, Flare y Sunburst cuestan los mismos créditos. Ver los costes actuales

Envía una solicitud de generación

POST /api/generate

Guarda el siguiente JSON como request.json. Este ejemplo genera una imagen a partir de texto. Para editar con imágenes de referencia, añade el arreglo images descrito más abajo.

Cuerpo de la solicitud: `request.json`

{
  "model": "gpt-image-2.6",
  "variant": "flare",
  "prompt": "Una taza de cerámica azul sobre una mesa de madera, con un fondo de papel de tonos cálidos.",
  "quality": "medium",
  "resolution": "1k",
  "complexity": "high",
  "output_format": "png"
}

Enviar desde tu servidor

curl --request POST https://gptimage-26.com/api/generate \
  --header "Authorization: Bearer $GPT_IMAGE_API_KEY" \
  --header "Content-Type: application/json" \
  --data @request.json

Una solicitud aceptada devuelve code 200, data.task_id, data.status con el valor IN_PROGRESS y data.consumed_credits. Guarda data.task_id para consultar el estado.

Campos de la solicitud

Campo	Significado y valores admitidos
`model`	Usa gpt-image-2.6. También es el valor predeterminado si se omite.
`variant`	Opcional: flare, sunburst. Valor predeterminado: flare. Indica sunburst para usar Sunburst.
`prompt`	Texto obligatorio de 1 a 20000 caracteres tras eliminar los espacios al principio y al final.
`quality`	Opcional: low, medium, high, xhigh, max. Valor predeterminado: medium.
`resolution`	Opcional: 1k, 2k, 4k. Valor predeterminado: 1k.
`complexity`	Planificación de la composición, opcional: low, medium, high. Valor predeterminado: high.
`output_format`	Opcional: png, jpeg, webp. Valor predeterminado: png.
`images`	Arreglo opcional de hasta 16 URL de imágenes HTTP(S). Al incluir al menos una referencia se activa la edición; omite este campo para generar a partir de texto.

Consulta la tarea

GET /api/status

Establece TASK_ID con el data.task_id recibido. Envíalo como parámetro de consulta task_id con la misma clave API de usuario.

curl --get https://gptimage-26.com/api/status \
  --header "Authorization: Bearer $GPT_IMAGE_API_KEY" \
  --data-urlencode "task_id=$TASK_ID"

PENDING / IN_PROGRESS: La tarea sigue en curso. Vuelve a consultar este punto de acceso para comprobar su progreso.
SUCCESS: Obtén las URL de las imágenes generadas del arreglo data.response.
FAILED: Lee los detalles del fallo en data.error_message antes de decidir si envías otra solicitud.

Ejemplo de una tarea completada

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "<TASK_ID>",
    "status": "SUCCESS",
    "response": [
      "<IMAGE_URL>"
    ],
    "error_message": null
  }
}

Los valores entre corchetes angulares representan el ID de tarea y la URL de imagen que devuelve tu solicitud.