API

GPT Image 2.5 API

Afbeelding

De GPT Image 2.5 API brengt de meest geavanceerde modellen van OpenAI voor beeldgeneratie en beeldbewerking naar je toepassing. Maak afbeeldingen op basis van tekst of bewerk referentiebeelden, met flexibele beeldverhoudingen en uitvoer in 1K, 2K of 4K. Kies flare voor snelle, hoogwaardige dagelijkse generatie of sunburst voor veeleisend creatief werk en nauwkeurige beeldbewerking.

Autorisaties

Bearerstringheaderverplicht

API-sleutel om requests te autoriseren

Body

application/json

modelstringverplicht

gpt-image-2-5

input.promptstringverplicht

Beschrijf de afbeelding die je wilt maken, inclusief onderwerp, compositie, stijl en belichting. Geef bij beeldbewerking aan wat moet veranderen en wat uit de referenties behouden moet blijven. Witruimte aan het begin en einde wordt verwijderd.

input.modestringoptioneel

Selecteer de GPT Image 2.5 variant. flare is de standaardmodus en geeft prioriteit aan snelheid voor hoogwaardige dagelijkse generatie en snelle iteraties. sunburst geeft prioriteit aan hoge kwaliteitseisen en nauwkeurige bewerking, vooral wanneer exacte wijzigingen aan referentiebeelden belangrijk zijn.

Beide modi ondersteunen tekst-naar-beeld en beeldbewerking. Laat input.images weg om vanuit tekst te genereren of geef referentiebeelden op om te bewerken. Gebruik bij een vergelijking dezelfde prompt, referenties, beeldverhouding en resolutie.

Standaard: flare

flaresunburst

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 breedte en hoogte van de uitvoer. Met auto kiest het model een geschikte compositie. Kies een verhouding uit de lijst om het formaat te bepalen, zoals 1:1 voor vierkante afbeeldingen, 9:16 voor staande of 16:9 voor liggende afbeeldingen.

Standaard: auto

auto1:12:33:23:44:39:1616:921:9

input.resolutionstringoptioneel

Resolutieniveau van de uitvoer. Gebruik de waarden in kleine letters 1k, 2k of 4k om het bijbehorende niveau te selecteren. Stel dit veld expliciet in wanneer je een specifieke uitvoerresolutie nodig hebt.

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": "gpt-image-2-5",
  "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": "gpt-image-2-5",
    "status": "processing",
    "credits": 5
  }
}

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": "gpt-image-2-5",
    "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": "gpt-image-2-5",
    "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	36	50

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