API

Seedream 5.0 Pro API

Immagine

L’API Seedream 5.0 Pro supporta la generazione di immagini da testo e la modifica di immagini di riferimento, con proporzioni flessibili e output in 1K o 2K.

Autorizzazioni

Bearerstringheaderobbligatorio

Chiave API per autorizzare le richieste

Corpo

application/json

modelstringobbligatorio

seedream-5-0-pro

input.promptstringobbligatorio

Descrivi l’immagine da creare o le modifiche da applicare alle immagini di riferimento. Gli spazi bianchi iniziali e finali vengono rimossi.

input.imagesstring[]opzionale

URL opzionali delle immagini di riferimento. Usa solo URL HTTPS accessibili pubblicamente. Ometti questo campo per generare immagini da testo.

Massimo: 16 elementi.

input.aspect_ratiostringopzionale

Rapporto tra larghezza e altezza dell’immagine. Valore predefinito: 1:1.

Predefinito: 1:1

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

input.resolutionstringopzionale

Risoluzione dell’immagine. Usa i valori minuscoli 1k o 2k. Valore predefinito: 1k.

Predefinito: 1k

1k2k

Esempi di richiesta

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 prodotto cinematografica di una fotocamera futuristica a forma di banana",
    "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
  }
}

Interroga questo endpoint usando l’ID attività restituito finché l’attività non viene completata o fallisce. Consigliamo un polling ogni 5 secondi per controllare lo stato più recente.

POST /api/v1/check

{
  "task_id": "task_example"
}

Risposta

Stato dell’attività restituito da POST /api/v1/check. ID, URL e timestamp seguenti sono esempi.

idstringobbligatorio

Identificatore dell’attività in data.id, uguale al task_id inviato nella richiesta di verifica.

statusstringobbligatorio

completed indica che la generazione è riuscita e data.data contiene i risultati. Negli altri stati, data.data è null.

failed_reasonstringopzionale

Restituito solo quando status è failed, per spiegare il motivo dell’errore. Il campo è omesso per completed e processing.

Completata · completed

Gli URL di download sono in 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
    }
  }
}

Altri stati

Con processing o failed, data.data è null. Questo esempio mostra failed: solo failed include failed_reason. Continua le verifiche con processing; interrompile 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 di crediti

Crediti consumati per una richiesta che genera un’immagine.

Crediti consumati per una richiesta che genera un’immagine.
Risoluzione	1K	2K
Un’immagine	50	100

Parametri facoltativi omessi: 50 crediti

Invia esplicitamente i parametri input indicati per usare la tariffa corrispondente. Le richieste che generano più immagini possono consumare più crediti.

Il campo credits restituito da POST /api/v1/create mostra i crediti addebitati per l’attività.