Nano Banana 2 API Technischer Leitfaden
Detaillierte technische Dokumentation für Nano Banana 2 Visual Production Service mit fortschrittlichen KI-Funktionen
Nano Banana 2 API Einführung
Die Nano Banana 2 Visual Production API ermöglicht die Integration mit ausgeklügelten KI-Systemen zur Erstellung hochwertiger Bilder aus Textbeschreibungen und Beispielgrafiken. Unsere Nano Banana 2 Plattform bietet eine unkomplizierte REST-Architektur mit umfangreichen Job-Koordinations- und Benachrichtigungsfunktionen.
Nano Banana 2 Kernfunktionen
- • Nano Banana 2 Text-zu-Bild-Umwandlung mit modernsten KI-Systemen
- • Nano Banana 2 Kompatibilität mit Beispielgrafiken (maximal 4 Bilder)
- • Nano Banana 2 asynchrone Job-Ausführung mit Fortschrittsüberwachung
- • Nano Banana 2 Webhook-Integration für sofortige Status-Updates
- • Nano Banana 2 REST-Architektur mit JSON-formatierten Antworten
- • Nano Banana 2 Bearer-Token-Verifizierungssystem
overview.base_url
https://api.defapi.orgoverview.api_version
v1.0.0Nano Banana 2 Implementierungsleitfaden
- 1. Registrieren Sie sich für Nano Banana 2 API-Zugangsdaten über unsere Hauptplattform
- 2. Fügen Sie Ihr Nano Banana 2 Access-Token in den Authorization-Parameter ein
- 3. Senden Sie eine POST-Anfrage an den Nano Banana 2 Bilderstellungs-Endpunkt
- 4. Nutzen Sie die bereitgestellte Nano Banana 2 Job-ID für die Statusüberprüfung
- 5. Erhalten Sie Ihre Nano Banana 2 generierten Bilder nach Aufgabenabschluss
Identitätsprüfung
Jede API-Anfrage erfordert eine Authentifizierung über Bearer-Token-Verifikation. Fügen Sie Ihre Zugangsdaten in den Authorization-Parameter für jede Übertragung ein.
Verifikationsansatz
Implementieren Sie HTTP Bearer-Token-Validierung, indem Sie Ihre Zugangsdaten in den Authorization-Parameter einbetten:
Authorization: Bearer <your-api-key>Beispiel-Zugriffsschlüssel-Struktur
Authorization: Bearer dk-1234567890abcdefÜbertragungsdemonstration
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"
}'Erfolgreiche Verifikation
- ✅ Zugangsdaten bleiben aktuell
- ✅ Client-Registrierung behält aktiven Status
- ✅ Ausreichende Service-Credits vorhanden
Häufige Probleme
- ❌ Fehlende Zugangsdaten
- ❌ Falsche Zugriffsschlüssel-Konfiguration
- ❌ Deaktivierte oder gesperrte Registrierung
Nano Banana 2 Bildgenerierungs-API
Erstellen Sie Bilder mit Nano Banana 2 unter Verwendung fortschrittlicher KI-Systeme und anpassbarer Textanweisungen sowie Beispielbildern.
Verbindungsterminal
POST /api/image/genÜbertragungsvariablen
| 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 |
Implementierungsbeispiele
Grundlegende Nano Banana 2 Bilderstellung
{
"model": "google/gempix2",
"prompt": "A beautiful girl dancing in a garden"
}Nano Banana 2 Referenzbasierte Produktion mit Beispielgrafiken
{
"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"
}Ausgabestruktur
{
"code": 0,
"message": "ok",
"data": {
"task_id": "ta12345678-1234-1234-1234-123456789abc"
}
}Problembehandlung
400 - Bad Request
{"code": 1, "message": "failed", "detail": "prompt is required"}401 - Unauthorized
{"code": 1, "message": "Invalid API key"}Nano Banana 2 Job Status API
Den Fortschritt und die Ergebnisse von Nano Banana 2 visuellen Produktionsjobs mithilfe der Task-ID untersuchen, die vom Nano Banana 2 visuellen Erstellungsterminal bereitgestellt wird.
Verbindungsterminal
GET /api/task/query?task_id=<task_id>Untersuchungsvariablen
| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | Yes | Unique task identifier returned from generation endpoint |
Anfrage-Beispiel
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 2 Job Status-Kategorien
pending - Nano Banana 2 Job-Initialisierung abgeschlossen, wartet auf Verarbeitungsstartsubmitted - Nano Banana 2 Job in Produktionssequenz eingegebenin_progress - Nano Banana 2 Job wird derzeit aktiv verarbeitetsuccess - Nano Banana 2 Job erfolgreich abgeschlossen mit erstellten Grafikenfailed - Nano Banana 2 Job aufgrund technischer Probleme beendetFehlerantworten
404 - Task Not Found
{"code": 1, "message": "task not found"}401 - Unauthorized
{"code": 401, "message": "Invalid API key"}Nano Banana 2 Datenstrukturen
Umfassende Dokumentation für alle Nano Banana 2 Datenkonfigurationen und Vorlagen, die in der API-Kommunikation und bei Anfragen 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 |
Nano Banana 2 unterstützte Konfigurationen
google/gempix2Nano Banana image generation modelgoogle/gemini-2.5-flash-imageGemini 2.5 Flash image modelFehlerverwaltung
Umfassendes Handbuch zur Verwaltung von Komplikationen und Interpretation von API-Antwort-Indikatoren. Alle Problembenachrichtigungen folgen standardisierten Formatierungen für effiziente Lösungsmethoden.
HTTP-Antwort-Indikatoren
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
Empfohlene Ansätze zur Problemlösung
- Überprüfen Sie immer HTTP-Antwort-Indikatoren vor der Analyse des Ausgabeinhalts
- Verwenden Sie progressive Verzögerungsalgorithmen für Wiederholungsmechanismen bei 500er Komplikationen
- Dokumentieren Sie Problembenachrichtigungen mit umfassenden Details für Fehlerbehebungszwecke
- Bestätigen Sie die Eingabegültigkeit vor der Anfrage-Übermittlung, um 400er Komplikationen zu verhindern
- Beheben Sie Verifizierungsprobleme durch Anforderung von API-Credential-Updates von Kunden
- Verfolgen Sie den Aufgabenfortschritt in angemessenen Intervallen statt übermäßiger Statusanfragen
- Verwenden Sie Webhook-Integration wann immer möglich, um ständige Fertigstellungsüberwachung zu vermeiden
Beispiel Fehlerverwaltung (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;
}
}