Nano Banana Pro API Entwicklerreferenz
Vollständiges Entwicklerhandbuch zur Nano Banana Pro API der visuellen Produktionsplattform, gestützt auf fortschrittliches maschinelles Lernen
Nano Banana Pro API Übersicht
Der Visual-Production-Dienst der Nano Banana Pro API erlaubt Entwicklern, sich mit modernen Machine-Learning-Engines zu verbinden. So entstehen hochwertige Bilder aus Text-Prompts und Referenzfotos. Unsere Lösung bietet eine einfache REST-Schnittstelle, umfassendes Task-Management und Echtzeit-Benachrichtigungen.
Hauptfunktionen der Nano Banana Pro API
- • Text-zu-Bild-Erzeugung mit modernen Machine-Learning-Engines
- • Unterstützung für bis zu 4 Referenzbilder
- • Asynchrone Aufgabenverarbeitung mit Echtzeit-Fortschrittsanzeige
- • Webhook-Benachrichtigungen bei Statusänderungen
- • REST-API, die strukturierte JSON-Daten zurückgibt
- • Authentifizierung per Bearer-Token
overview.base_url
https://api.defapi.orgoverview.api_version
v1.0.0Nano Banana Pro API Schnellstart
- 1. Erstellen Sie ein Nano Banana Pro API-Konto und holen Sie Ihre Zugangsdaten auf unserer offiziellen Website.
- 2. Fügen Sie Ihr Nano Banana Pro API-Authentifizierungs-Token in den Authorization-Header ein.
- 3. Senden Sie eine POST-Anfrage an den Bildgenerierungs-Endpunkt der Nano Banana Pro API.
- 4. Verwenden Sie die zurückgegebene Task-ID, um den Verarbeitungsstatus zu prüfen.
- 5. Rufen Sie die erzeugten Bilder ab, wenn die Verarbeitung abgeschlossen ist.
Zugriffs-Authentifizierung
Alle API-Anfragen müssen eine gültige Authentifizierung mit Bearer-Token enthalten. Fügen Sie Ihren API-Schlüssel im Authorization-Header bei jeder Anfrage hinzu.
Authentifizierungsmethode
HTTP-Bearer-Token verwenden. API-Zugangsdaten im Authorization-Header angeben:
Authorization: Bearer <your-api-key>Beispiel: API-Schlüssel-Format
Authorization: Bearer dk-1234567890abcdefAnfragebeispiel
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"
}'Gültige Authentifizierung
- ✅ API-Zugangsdaten sind nicht abgelaufen
- ✅ Konto ist ordnungsgemäß registriert
- ✅ Genügend Kontoguthaben vorhanden
Häufige Probleme
- ❌ API-Zugangsdaten fehlen in der Anfrage
- ❌ Ungültiger oder falsch formatierter API-Schlüssel
- ❌ Konto deaktiviert oder Zugriff entzogen
Nano Banana Pro API Bildgenerierung
Erstellen Sie Bilder mit der Nano Banana Pro API. Nutzt fortschrittliche Machine-Learning-Technik und flexible Text-Prompts sowie Referenzbilder.
API-Endpunkt
POST /api/image/genAnfrageparameter
| 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 |
Nutzungsbeispiele
Einfache Bilderstellung mit Nano Banana Pro API
{
"model": "google/gempix2",
"prompt": "A beautiful girl dancing in a garden"
}Referenzbasierte Generierung mit Beispielbildern (Nano Banana Pro API)
{
"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"
}Antwortformat
{
"code": 0,
"message": "ok",
"data": {
"task_id": "ta12345678-1234-1234-1234-123456789abc"
}
}Fehlerbehandlung
400 - Bad Request
{"code": 1, "message": "failed", "detail": "prompt is required"}401 - Unauthorized
{"code": 1, "message": "Invalid API key"}Nano Banana Pro API Auftragsstatus
Abfragen von Status und Ergebnissen von Bildgenerierungs-Aufträgen der Nano Banana Pro API mit der Task-ID, die der Bildgenerierungs-Endpunkt zurückgibt.
API-Endpunkt
GET /api/task/query?task_id=<task_id>Abfrageparameter
| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | Yes | Unique task identifier returned from generation endpoint |
Anfragebeispiel
curl -X GET "https://api.defapi.org/api/task/query?task_id=ta823dfb-eaac-44fd-aec2-3e2c7ba8e071" \ -H "Authorization: Bearer your-api-key-here"
Nano Banana Pro API Auftragsstatus-Typen
pending - Der Nano Banana Pro API-Auftrag wurde erstellt und wartet auf die Verarbeitung.submitted - Der Nano Banana Pro API-Auftrag wurde zur Verarbeitung in die Warteschlange gestellt.in_progress - Der Nano Banana Pro API-Auftrag wird derzeit verarbeitet.success - Der Nano Banana Pro API-Auftrag wurde erfolgreich abgeschlossen und die erzeugten Bilder sind bereit.failed - Beim Nano Banana Pro API-Auftrag ist ein Fehler aufgetreten und er konnte nicht abgeschlossen werden.Fehlerantworten
404 - Task Not Found
{"code": 1, "message": "task not found"}401 - Unauthorized
{"code": 401, "message": "Invalid API key"}Nano Banana Pro API Datenstrukturen
Vollständige Referenz aller Datenformate und Schemata der Nano Banana Pro API, die in Anfragen und Antworten verwendet werden.
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 |
Unterstützte Modelle der Nano Banana Pro API
google/gempix2Nano Banana image generation modelgoogle/gemini-2.5-flash-imageGemini 2.5 Flash image modelFehlerverwaltung
Vollständige Anleitung zum Umgang mit Fehlern und zur Interpretation von API-Antwortcodes. Alle Fehlermeldungen haben ein einheitliches Format, damit die Fehlersuche einfacher wird.
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
Fehlerbehandlung - Best Practices
- Prüfen Sie immer die HTTP-Statuscodes, bevor Sie Antwortdaten verarbeiten
- Bei 500-Fehlern Exponential-Backoff für Wiederholungen verwenden
- Fehlermeldungen mit vollem Kontext protokollieren, um zu debuggen
- Eingabeparameter validieren, bevor Anfragen gesendet werden, um 400-Fehler zu vermeiden
- Authentifizierungsprobleme lösen, indem Clients ihre API-Zugangsdaten erneuern
- Aufgabenfortschritt in angemessenen Abständen überwachen, statt ständig den Status abzufragen
- Wo möglich Webhooks nutzen, um ständiges Abfragen des Abschlussstatus zu vermeiden
Beispiel: Fehlerbehandlung (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;
}
}