Nano Banana Pro API Entwicklerreferenz

Vollständiges Entwicklerhandbuch zur Nano Banana Pro API der visuellen Produktionsplattform, gestützt auf fortschrittliches maschinelles Lernen

Preise ansehenAbonnementpläne der Nano Banana Pro API entdecken

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

overview.api_version

v1.0.0

Nano Banana Pro API Schnellstart

  1. 1. Erstellen Sie ein Nano Banana Pro API-Konto und holen Sie Ihre Zugangsdaten auf unserer offiziellen Website.
  2. 2. Fügen Sie Ihr Nano Banana Pro API-Authentifizierungs-Token in den Authorization-Header ein.
  3. 3. Senden Sie eine POST-Anfrage an den Bildgenerierungs-Endpunkt der Nano Banana Pro API.
  4. 4. Verwenden Sie die zurückgegebene Task-ID, um den Verarbeitungsstatus zu prüfen.
  5. 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-1234567890abcdef

Anfragebeispiel

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/gen

Anfrageparameter

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

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

Unterstützte Modelle der Nano Banana Pro API

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

Fehlerverwaltung

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

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

Fehlerbehandlung - Best Practices

  1. Prüfen Sie immer die HTTP-Statuscodes, bevor Sie Antwortdaten verarbeiten
  2. Bei 500-Fehlern Exponential-Backoff für Wiederholungen verwenden
  3. Fehlermeldungen mit vollem Kontext protokollieren, um zu debuggen
  4. Eingabeparameter validieren, bevor Anfragen gesendet werden, um 400-Fehler zu vermeiden
  5. Authentifizierungsprobleme lösen, indem Clients ihre API-Zugangsdaten erneuern
  6. Aufgabenfortschritt in angemessenen Abständen überwachen, statt ständig den Status abzufragen
  7. 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;
  }
}