API

Nano Banana 2 Lite API

Afbeelding

Nano Banana 2 Lite API biedt snelle, efficiënte afbeeldingsgeneratie met betrouwbare karakterconsistentie, soepele multi-image blending en bewerking in natuurlijke taal voor dagelijkse creatieve workflows. Integreer Nano Banana 2 Lite API voor lichte, hoogwaardige visuele generatie.

Autorisaties

Bearerstringheaderverplicht

API-sleutel om requests te autoriseren

Body

application/json

modelstringverplicht

nano-banana-2-lite

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.

Maximale lengte: 5.000 tekens

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 aantal items: 14

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

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

POST /api/v1/create · HTTP 201

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

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-lite",
    "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-lite",
    "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.
Generatie	Credits per verzoek
Eén afbeelding	18

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.