API

GPT Image 2.5 API

Imagen

La API de GPT Image 2.5 incorpora a tu aplicación los modelos más avanzados de OpenAI para generar y editar imágenes. Crea imágenes a partir de texto o edita imágenes de referencia, con relaciones de aspecto flexibles y salida en 1K, 2K o 4K. Elige flare para generar imágenes cotidianas de alta calidad con rapidez, o sunburst para trabajos creativos exigentes y edición precisa.

Autorizaciones

Bearerstringheaderobligatorio

Clave API para autorizar solicitudes

Cuerpo

application/json

modelstringobligatorio

gpt-image-2-5

input.promptstringobligatorio

Describe la imagen que deseas crear, incluidos el sujeto, la composición, el estilo y la iluminación. Para editar imágenes, indica qué cambiar y qué conservar de las referencias. Se eliminan los espacios al principio y al final.

input.modestringopcional

Selecciona la variante de GPT Image 2.5. flare es el modo predeterminado y prioriza la velocidad para generar imágenes cotidianas de alta calidad y realizar iteraciones rápidas. sunburst prioriza los requisitos de calidad exigentes y la precisión de edición, ideal cuando es fundamental modificar con exactitud las imágenes de referencia.

Ambos modos admiten generación de texto a imagen y edición de imágenes. Omite input.images para generar a partir de texto o proporciona referencias para editar. Al comparar modos, mantén iguales el prompt, las referencias, la relación de aspecto y la resolución.

Predeterminado: flare

flaresunburst

input.imagesstring[]opcional

URL opcionales de imágenes de referencia. Usa únicamente URL HTTPS de acceso público. Omite este campo para generar imágenes a partir de texto.

input.aspect_ratiostringopcional

Relación entre el ancho y el alto de la imagen de salida. auto permite que el modelo elija una composición adecuada. Selecciona una proporción de la lista para controlar el formato, como 1:1 para imágenes cuadradas, 9:16 para verticales o 16:9 para horizontales.

Predeterminado: auto

auto1:12:33:23:44:39:1616:921:9

input.resolutionstringopcional

Nivel de resolución de salida. Usa los valores en minúsculas 1k, 2k o 4k para elegir el nivel correspondiente. Configura este campo explícitamente cuando necesites una resolución específica.

Predeterminado: 2k

1k2k4k

Ejemplos de solicitud

POST /api/v1/create

curl -X POST https://nanobanana.io/api/v1/create \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-2-5",
  "input": {
    "prompt": "Una foto de producto cinematográfica de una cámara futurista con forma de plátano"
  }
}'

POST /api/v1/create · HTTP 201

{
  "data": {
    "task_id": "task_example",
    "model": "gpt-image-2-5",
    "status": "processing",
    "credits": 5
  }
}

Consulta este endpoint con el ID de tarea devuelto hasta que la tarea se complete o falle. Recomendamos consultar cada 5 segundos para comprobar el estado más reciente.

POST /api/v1/check

{
  "task_id": "task_example"
}

Respuesta

Estado de la tarea devuelto por POST /api/v1/check. Los ID, URLs y marcas de tiempo siguientes son ilustrativos.

idstringobligatorio

Identificador de la tarea en data.id, igual al task_id enviado en la consulta.

statusstringobligatorio

completed indica que la generación tuvo éxito y data.data contiene los resultados. En otros estados, data.data es null.

failed_reasonstringopcional

Solo se devuelve cuando status es failed, para explicar el fallo. Se omite en completed y processing.

Completada · completed

Las URLs de descarga están en data.data.results.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "gpt-image-2-5",
    "status": "completed",
    "data": {
      "results": [
        "https://example.com/generated.png"
      ],
      "processing_time": 18
    }
  }
}

Otros estados

Con processing o failed, data.data es null. Este ejemplo muestra failed: solo failed incluye failed_reason. Continúa consultando con processing; detente con failed.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "gpt-image-2-5",
    "status": "failed",
    "data": null,
    "failed_reason": "Generation failed."
  }
}

Consumo de créditos

Créditos consumidos por una solicitud que genera una imagen.

Créditos consumidos por una solicitud que genera una imagen.
Resolución	1K	2K	4K
Una imagen	12	36	50

Sin parámetros opcionales: 5 créditos

Envía explícitamente los parámetros input indicados para usar la tarifa correspondiente. Las solicitudes que generan varias imágenes pueden consumir más créditos.

El campo credits de la respuesta de POST /api/v1/create muestra los créditos cobrados por la tarea.