API

Nano Banana 2.1 API

Afbeelding

De Nano Banana 2.1 API levert scherpere beelden en maakt nauwkeurigere bewerking mogelijk. Genereer beelden met tekstprompts of bewerk referentiebeelden, met flexibele beeldverhoudingen en uitvoer tot 4K. Integreer de API om hoogwaardige beeldgeneratie en beeldbewerking aan je applicatie toe te voegen.

Autorisaties

Bearerstringheaderverplicht

API-sleutel om requests te autoriseren

Body

application/json

modelstringverplicht

nano-banana-2-1

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.

input.aspect_ratiostringoptioneel

Verhouding tussen uitvoerbreedte en -hoogte. Met Auto laat je het model kiezen.

Standaard: auto

auto1:12:33:23:44:34:55:49:1616:921:91:44:11:88:1

input.resolutionstringoptioneel

Resolutieniveau van het uitvoerbeeld. Gebruik de waarden 1k, 2k of 4k in kleine letters. Als dit veld ontbreekt of leeg is, wordt standaard 2k gebruikt.

Standaard: 2k

1k2k4k

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": "nano-banana-2-1",
  "input": {
    "prompt": "Een filmische productfoto van een futuristische camera in de vorm van een banaan",
    "aspect_ratio": "1:1",
    "resolution": "2k"
  }
}'

POST /api/v1/create · HTTP 201

{
  "data": {
    "task_id": "task_example",
    "model": "nano-banana-2-1",
    "status": "processing",
    "credits": 20
  }
}

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": "nano-banana-2-1",
    "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": "nano-banana-2-1",
    "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	4K
Eén afbeelding	12	20	30

Optionele parameters weggelaten: 12 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.