Nano Banana 2 API Technischer Leitfaden

Detaillierte technische Dokumentation für Nano Banana 2 Visual Production Service mit fortschrittlichen KI-Funktionen

Preise anzeigenNano Banana 2 Abonnement-Optionen erkunden

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.org

overview.api_version

v1.0.0

Nano Banana 2 Implementierungsleitfaden

  1. 1. Registrieren Sie sich für Nano Banana 2 API-Zugangsdaten über unsere Hauptplattform
  2. 2. Fügen Sie Ihr Nano Banana 2 Access-Token in den Authorization-Parameter ein
  3. 3. Senden Sie eine POST-Anfrage an den Nano Banana 2 Bilderstellungs-Endpunkt
  4. 4. Nutzen Sie die bereitgestellte Nano Banana 2 Job-ID für die Statusüberprüfung
  5. 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

ParameterTypeRequiredDescription
modelstringYesModel identifier (e.g., "google/gempix2")
promptstringYesText prompt describing the image
imagesarrayNoReference image URLs (max 4)
callback_urlstringNoWebhook 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

ParameterTypeRequiredDescription
task_idstringYesUnique 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 Verarbeitungsstart
submitted - Nano Banana 2 Job in Produktionssequenz eingegeben
in_progress - Nano Banana 2 Job wird derzeit aktiv verarbeitet
success - Nano Banana 2 Job erfolgreich abgeschlossen mit erstellten Grafiken
failed - Nano Banana 2 Job aufgrund technischer Probleme beendet

Fehlerantworten

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"
}
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

Nano Banana 2 unterstützte Konfigurationen

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

Fehlerverwaltung

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

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

Empfohlene Ansätze zur Problemlösung

  1. Überprüfen Sie immer HTTP-Antwort-Indikatoren vor der Analyse des Ausgabeinhalts
  2. Verwenden Sie progressive Verzögerungsalgorithmen für Wiederholungsmechanismen bei 500er Komplikationen
  3. Dokumentieren Sie Problembenachrichtigungen mit umfassenden Details für Fehlerbehebungszwecke
  4. Bestätigen Sie die Eingabegültigkeit vor der Anfrage-Übermittlung, um 400er Komplikationen zu verhindern
  5. Beheben Sie Verifizierungsprobleme durch Anforderung von API-Credential-Updates von Kunden
  6. Verfolgen Sie den Aufgabenfortschritt in angemessenen Intervallen statt übermäßiger Statusanfragen
  7. 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;
  }
}