Nano Banana Pro API Ontwikkelaarsgids
Volledige ontwikkelaarsreferentie voor het Nano Banana Pro API Visual Production Platform, aangedreven door geavanceerde machine learning
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.orgoverview.api_version
v1.0.0Nano Banana Pro API Snel aan de slag
- 1. Maak een Nano Banana Pro API-account aan en haal inloggegevens op via onze officiële website
- 2. Voeg je Nano Banana Pro API authenticatietoken toe in de Authorization-header
- 3. Stuur een POST-verzoek naar het beeldgeneratie-eindpunt van Nano Banana Pro API
- 4. Gebruik het teruggegeven taak-ID van Nano Banana Pro API om de verwerkingsstatus te controleren
- 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-1234567890abcdefVoorbeeldaanvraag
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/genAanvraagparameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| model | string | Yes | Model identifier (e.g., "google/gempix2") |
| prompt | string | Yes | Text prompt describing the image |
| images | array | No | Reference image URLs (max 4) |
| callback_url | string | No | Webhook 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
| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | Yes | Unique 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 verwerkingsubmitted - De taak is in de wachtrij geplaatst voor verwerkingin_progress - De taak wordt nu verwerktsuccess - De taak is met succes voltooid en de gegenereerde afbeeldingen zijn klaarfailed - Er trad een fout op en de taak kon niet worden voltooidFoutreacties
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"
}| Field | Type | Description |
|---|---|---|
| image | string | Image 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
}
}| Field | Type | Description |
|---|---|---|
| result | array | Array of ImageGenResult objects (null if failed) |
| status | string | Final task status (success/failed) |
| task_id | string | Unique task identifier |
| consumed | string | Credits consumed by the task |
| status_reason | object | Status details including error message if failed |
Ondersteunde modellen van Nano Banana Pro API
google/gempix2Nano Banana image generation modelgoogle/gemini-2.5-flash-imageGemini 2.5 Flash image modelFoutafhandeling
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
OK
Request was successful
Bad Request
Invalid request parameters or malformed JSON
Unauthorized
Invalid, missing, or expired API key
Not Found
Task not found or endpoint doesn't exist
Internal Server Error
Server-side error occurred
Beste praktijken voor foutafhandeling
- Controleer altijd HTTP-statuscodes voordat u de respons verwerkt
- Implementeer exponentiële backoff als retry-strategie bij 500-fouten
- Log foutmeldingen met volledige context voor het debuggen
- Valideer parameters voordat u verzoeken verzendt om 400-fouten te voorkomen
- Los authenticatieproblemen op door clients de API-referenties te laten vernieuwen
- Controleer taakvoortgang met redelijke tussenpozen in plaats van de status te vaak op te vragen
- 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;
}
}