API

Seedream 5.0 Pro API

Imagen

La API de Seedream 5.0 Pro permite generar imágenes a partir de texto y editar imágenes de referencia, con relaciones de aspecto flexibles y salida en 1K o 2K.

Autorizaciones

Bearerstringheaderobligatorio

Clave API para autorizar solicitudes

Cuerpo

application/json

modelstringobligatorio

seedream-5-0-pro

input.promptstringobligatorio

Describe la imagen que quieres crear o los cambios que deseas aplicar a tus imágenes de referencia. Los espacios en blanco se recortan.

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.

Máximo: 16 elementos.

input.aspect_ratiostringopcional

Relación entre ancho y alto de la imagen. Valor predeterminado: 1:1.

Predeterminado: 1:1

1:116:99:163:22:33:44:321:9

input.resolutionstringopcional

Resolución de la imagen. Usa 1k o 2k en minúsculas. Valor predeterminado: 1k.

Predeterminado: 1k

1k2k

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": "seedream-5-0-pro",
  "input": {
    "prompt": "Una foto de producto cinematográfica de una cámara futurista con forma de plátano",
    "aspect_ratio": "1:1",
    "resolution": "1k"
  }
}'

POST /api/v1/create · HTTP 201

{
  "data": {
    "task_id": "task_example",
    "model": "seedream-5-0-pro",
    "status": "processing",
    "credits": 50
  }
}

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": "seedream-5-0-pro",
    "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": "seedream-5-0-pro",
    "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
Una imagen	50	100

Sin parámetros opcionales: 50 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.