Nano Banana Pro API Ontwikkelaarsgids

Volledige ontwikkelaarsreferentie voor het Nano Banana Pro API Visual Production Platform, aangedreven door geavanceerde machine learning

Prijzen bekijkenOntdek abonnementsplannen voor Nano Banana Pro API

Overzicht Nano Banana Pro API

De Nano Banana Pro API Visual Production-service stelt ontwikkelaars in staat verbinding te maken met geavanceerde machine learning-engines om hoogwaardige beelden te maken vanuit tekstprompts en referentiefoto's. Onze Nano Banana Pro API biedt een eenvoudige REST-interface met volledig taakbeheer en realtime meldingen.

Belangrijkste functies van Nano Banana Pro API

  • Nano Banana Pro API tekst-naar-beeld conversie met geavanceerde machine learning-engines
  • Nano Banana Pro API ondersteunt referentieafbeeldingen (tot 4)
  • Nano Banana Pro API asynchrone taakverwerking met realtime voortgangsweergave
  • Nano Banana Pro API webhook-meldingen voor directe statusupdates
  • Nano Banana Pro API REST-interface die gestructureerde JSON retourneert
  • Nano Banana Pro API Bearer-token authenticatie

overview.base_url

https://api.defapi.org

overview.api_version

v1.0.0

Nano Banana Pro API Snel aan de slag

  1. 1. Maak een Nano Banana Pro API-account aan en haal inloggegevens op via onze officiële website
  2. 2. Voeg je Nano Banana Pro API authenticatietoken toe in de Authorization-header
  3. 3. Stuur een POST-verzoek naar het beeldgeneratie-eindpunt van Nano Banana Pro API
  4. 4. Gebruik het teruggegeven taak-ID van Nano Banana Pro API om de verwerkingsstatus te controleren
  5. 5. Haal je door Nano Banana Pro API gegenereerde afbeeldingen op zodra de verwerking klaar is

Toegangsverificatie

Alle API-aanvragen moeten geldige authenticatie bevatten met een Bearer-token. Voeg uw API-sleutel toe aan de Authorization-header bij elke aanvraag.

Authenticatiemethode

Gebruik HTTP Bearer-tokenauthenticatie door uw API-gegevens in de Authorization-header op te nemen:

Authorization: Bearer <your-api-key>

Voorbeeld API-sleutelformaat

Authorization: Bearer dk-1234567890abcdef

Voorbeeldaanvraag

curl -X POST "https://api.defapi.org/api/image/gen" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key-here" \
  -d '{
    "model": "google/gempix2",
    "prompt": "A beautiful landscape"
  }'

Geldige authenticatie

  • De API-gegevens zijn niet verlopen
  • De accountregistratie is in orde
  • Er is voldoende accounttegoed

Veelvoorkomende problemen

  • API-gegevens ontbreken in de aanvraag
  • Ongeldige of verkeerd geformatteerde API-sleutel
  • Account is uitgeschakeld of toegang is ingetrokken

Afbeeldingsgeneratie Nano Banana Pro API

Maak afbeeldingen met de Nano Banana Pro API met geavanceerde machine learning, flexibele tekstprompts en referentieafbeeldingen.

API-eindpunt

POST /api/image/gen

Aanvraagparameters

ParameterTypeRequiredDescription
modelstringYesModel identifier (e.g., "google/gempix2")
promptstringYesText prompt describing the image
imagesarrayNoReference image URLs (max 4)
callback_urlstringNoWebhook URL for completion notifications

Voorbeelden

Basis: afbeeldingen maken met Nano Banana Pro API

{
  "model": "google/gempix2",
  "prompt": "A beautiful girl dancing in a garden"
}

Geavanceerd: referentiegebaseerde generatie met voorbeeldafbeeldingen

{
  "model": "google/gempix2",
  "prompt": "Put them in a basket",
  "images": [
    "https://cdn.openai.com/API/docs/images/body-lotion.png",
    "https://cdn.openai.com/API/docs/images/soap.png"
  ],
  "callback_url": "https://example.com/webhook/image-callback"
}

Responsformaat

{
  "code": 0,
  "message": "ok",
  "data": {
    "task_id": "ta12345678-1234-1234-1234-123456789abc"
  }
}

Foutafhandeling

400 - Bad Request

{"code": 1, "message": "failed", "detail": "prompt is required"}

401 - Unauthorized

{"code": 1, "message": "Invalid API key"}

Nano Banana Pro API Taakstatus

Vraag de status en resultaten op van Nano Banana Pro API beeldgeneratietaken met de taak-ID die het beeldgeneratie-endpoint teruggeeft.

API-eindpunt

GET /api/task/query?task_id=<task_id>

Queryparameters

ParameterTypeRequiredDescription
task_idstringYesUnique task identifier returned from generation endpoint

Voorbeeldverzoek

curl -X GET "https://api.defapi.org/api/task/query?task_id=ta823dfb-eaac-44fd-aec2-3e2c7ba8e071" \
  -H "Authorization: Bearer your-api-key-here"

Soorten taakstatussen van Nano Banana Pro API

pending - De Nano Banana Pro API-taak is aangemaakt en wacht op verwerking
submitted - De taak is in de wachtrij geplaatst voor verwerking
in_progress - De taak wordt nu verwerkt
success - De taak is met succes voltooid en de gegenereerde afbeeldingen zijn klaar
failed - Er trad een fout op en de taak kon niet worden voltooid

Foutreacties

404 - Task Not Found

{"code": 1, "message": "task not found"}

401 - Unauthorized

{"code": 401, "message": "Invalid API key"}

Nano Banana Pro API Gegevensstructuren

Volledige referentie van alle dataformaten en schema's die de Nano Banana Pro API gebruikt in verzoeken en antwoorden.

ImageGenResult

Represents a generated image result.

{
  "image": "https://google.datas.systems/fileSystem/response_images/287/2025/08/29/1756432513771985292_2989.png"
}
FieldTypeDescription
imagestringImage URL or base64 data URI

CallbackPayload

Payload sent to the callback_url when task status changes to final states.

{
  "result": [
    {
      "image": "https://google.datas.systems/fileSystem/response_images/287/2025/08/29/1756432513771985292_2989.png"
    }
  ],
  "status": "success",
  "task_id": "ta5c9705-b8ae-4cb9-aa6f-97c4fee88c8d",
  "consumed": "0.500000",
  "status_reason": {
    "message": null
  }
}
FieldTypeDescription
resultarrayArray of ImageGenResult objects (null if failed)
statusstringFinal task status (success/failed)
task_idstringUnique task identifier
consumedstringCredits consumed by the task
status_reasonobjectStatus details including error message if failed

Ondersteunde modellen van Nano Banana Pro API

google/gempix2Nano Banana image generation model
google/gemini-2.5-flash-imageGemini 2.5 Flash image model

Foutafhandeling

Volledige gids voor het afhandelen van fouten en het interpreteren van API-responscodes. Alle foutmeldingen volgen een consistent formaat om effectief problemen op te lossen.

HTTP-statuscodes

200

OK

Request was successful

400

Bad Request

Invalid request parameters or malformed JSON

401

Unauthorized

Invalid, missing, or expired API key

404

Not Found

Task not found or endpoint doesn't exist

500

Internal Server Error

Server-side error occurred

Beste praktijken voor foutafhandeling

  1. Controleer altijd HTTP-statuscodes voordat u de respons verwerkt
  2. Implementeer exponentiële backoff als retry-strategie bij 500-fouten
  3. Log foutmeldingen met volledige context voor het debuggen
  4. Valideer parameters voordat u verzoeken verzendt om 400-fouten te voorkomen
  5. Los authenticatieproblemen op door clients de API-referenties te laten vernieuwen
  6. Controleer taakvoortgang met redelijke tussenpozen in plaats van de status te vaak op te vragen
  7. Gebruik webhooks waar mogelijk om continu pollen te vermijden

Voorbeeld foutafhandeling (JavaScript)

async function generateImage(prompt, apiKey) {
  try {
    const response = await fetch('https://api.defapi.org/api/image/gen', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${apiKey}`
      },
      body: JSON.stringify({
        model: 'google/gempix2',
        prompt: prompt
      })
    });

    if (!response.ok) {
      const errorData = await response.json();
      throw new Error(`API Error ${response.status}: ${errorData.message}`);
    }

    const data = await response.json();
    return data.data.task_id;

  } catch (error) {
    console.error('Image generation failed:', error.message);
    throw error;
  }
}