API

Seedream 5.0 Pro API

Afbeelding

De Seedream 5.0 Pro API ondersteunt het genereren van afbeeldingen uit tekst en het bewerken van referentieafbeeldingen, met flexibele beeldverhoudingen en uitvoer in 1K of 2K.

Autorisaties

Bearerstringheaderverplicht

API-sleutel om requests te autoriseren

Body

application/json

modelstringverplicht

seedream-5-0-pro

input.promptstringverplicht

Beschrijf de afbeelding die je wilt maken of de wijzigingen die je wilt aanbrengen in je referentieafbeeldingen. Witruimte aan het begin en einde wordt verwijderd.

input.imagesstring[]optioneel

Optionele URL’s van referentieafbeeldingen. Gebruik uitsluitend openbaar toegankelijke HTTPS-URL’s. Laat dit veld weg om beelden uit tekst te genereren.

Maximaal 16 items.

input.aspect_ratiostringoptioneel

Verhouding tussen breedte en hoogte van de afbeelding. Standaard: 1:1.

Standaard: 1:1

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

input.resolutionstringoptioneel

Afbeeldingsresolutie. Gebruik de kleine letters 1k of 2k. Standaard: 1k.

Standaard: 1k

1k2k

Voorbeeldaanvragen

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": "Een filmische productfoto van een futuristische camera in de vorm van een banaan",
    "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
  }
}

Poll dit endpoint met de geretourneerde taak-ID totdat de taak is voltooid of mislukt. We raden aan om elke 5 seconden te pollen om de nieuwste taakstatus te controleren.

POST /api/v1/check

{
  "task_id": "task_example"
}

Respons

Taakstatus geretourneerd door POST /api/v1/check. De onderstaande ID’s, URL’s en tijdstempels zijn voorbeelden.

idstringverplicht

Taakidentificatie in data.id, gelijk aan task_id in het statusverzoek.

statusstringverplicht

completed betekent dat de generatie is geslaagd en data.data de resultaten bevat. Bij andere statussen is data.data null.

failed_reasonstringoptioneel

Alleen geretourneerd wanneer status failed is, om de fout te verklaren. Dit veld ontbreekt bij completed en processing.

Voltooid · completed

Download-URL’s staan 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
    }
  }
}

Andere statussen

Bij processing of failed is data.data null. Dit voorbeeld toont failed: alleen failed bevat failed_reason. Blijf opvragen bij processing; stop bij 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."
  }
}

Creditverbruik

Verbruikte credits voor een verzoek dat één afbeelding genereert.

Verbruikte credits voor een verzoek dat één afbeelding genereert.
Resolutie	1K	2K
Eén afbeelding	50	100

Optionele parameters weggelaten: 50 credits

Stel de vermelde input-parameters expliciet in om het bijbehorende tarief te gebruiken. Verzoeken die meerdere afbeeldingen genereren, kunnen meer credits verbruiken.

Het veld credits in het antwoord van POST /api/v1/create toont de credits die voor de taak zijn afgeschreven.