Gempix 2 API

GemPix2 API-Dokumentation

Vollständige API-Dokumentation für den GemPix2 Bildgenerierungsdienst mit Google Gemini AI-Modellen

Preis erhaltenGemPix2 Preispläne anzeigen

GemPix2 API-Übersicht

Die GemPix2 Bildgenerierungs-API bietet Zugang zu Google Gemini AI-Modellen für die Generierung hochwertiger Bilder aus Textprompts und Referenzbildern. Unser GemPix2-Dienst bietet eine einfache RESTful-Schnittstelle mit umfassendem Aufgabenmanagement und Callback-Unterstützung.

GemPix2 Hauptfunktionen

  • • GemPix2 Text-zu-Bild-Generierung mit Google Gemini AI-Modellen
  • • GemPix2 Unterstützung für Referenzbilder (bis zu 4 Bilder)
  • • GemPix2 asynchrone Aufgabenverarbeitung mit Statusverfolgung
  • • GemPix2 Webhook-Callback-Unterstützung für Echtzeitbenachrichtigungen
  • • GemPix2 RESTful API mit JSON-Antworten
  • • GemPix2 Bearer-Token-Authentifizierung

overview.base_url

https://api.defapi.org

overview.api_version

v1.0.0

GemPix2 Erste Schritte

  1. 1. Registrieren Sie sich für einen GemPix2 API-Schlüssel auf unserem Produktionsserver
  2. 2. Fügen Sie Ihren GemPix2 API-Schlüssel in den Authorization-Header ein
  3. 3. Senden Sie eine POST-Anfrage an den GemPix2 Bildgenerierungs-Endpunkt
  4. 4. Verwenden Sie die zurückgegebene GemPix2 task_id, um den Generierungsstatus zu überprüfen
  5. 5. Rufen Sie Ihre GemPix2 generierten Bilder ab, wenn die Aufgabe abgeschlossen ist

Authentifizierung

Alle API-Anfragen müssen mit Bearer-Token-Authentifizierung authentifiziert werden. Fügen Sie Ihren API-Schlüssel in den Authorization-Header jeder Anfrage ein.

Authentifizierungsmethode

Verwenden Sie HTTP Bearer-Token-Authentifizierung, indem Sie Ihren API-Schlüssel in den Authorization-Header einfügen:

Authorization: Bearer <your-api-key>

Beispiel für API-Schlüssel-Format

Authorization: Bearer dk-1234567890abcdef

Anfrage-Beispiel

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-Schlüssel ist gültig
  • ✅ Benutzerkonto ist aktiv
  • ✅ Ausreichend Credits verfügbar

Häufige Fehler

  • ❌ Fehlender API-Schlüssel
  • ❌ Ungültiges API-Schlüssel-Format
  • ❌ Abgelaufenes oder inaktives Konto

GemPix2 Bildgenerierungs-API

Generieren Sie Bilder mit GemPix2 unter Verwendung von Google Gemini AI-Modellen und anpassbaren Prompts und Referenzbildern.

Endpunkt

POST /api/image/gen

Anfrage-Parameter

ParameterTypeRequiredDescription
modelstringYesModel identifier (e.g., "google/gempix2")
promptstringYesText prompt describing the image
imagesarrayNoReference image URLs (max 4)
callback_urlstringNoWebhook URL for completion notifications

Anfrage-Beispiele

Grundlegende GemPix2 Bildgenerierung

{
  "model": "google/gempix2",
  "prompt": "A beautiful girl dancing in a garden"
}

GemPix2 bildbasierte Generierung mit Referenzbildern

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

Antwort-Format

{
  "code": 0,
  "message": "ok",
  "data": {
    "task_id": "ta12345678-1234-1234-1234-123456789abc"
  }
}

Fehler-Antworten

400 - Bad Request

{"code": 1, "message": "failed", "detail": "prompt is required"}

401 - Unauthorized

{"code": 1, "message": "Invalid API key"}

GemPix2 Aufgaben-Abfrage API

Abfrage des Status und der Ergebnisse von GemPix2 Bildgenerierungs-Aufgaben mit der Aufgaben-ID, die vom GemPix2 Bildgenerierungs-Endpunkt zurückgegeben wird.

Endpunkt

GET /api/task/query?task_id=<task_id>

Abfrage-Parameter

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"

GemPix2 Aufgaben-Status Werte

pending - GemPix2 Aufgabe wurde erstellt und wartet auf Bearbeitung
submitted - GemPix2 Aufgabe wurde an die Generierungs-Warteschlange übermittelt
in_progress - GemPix2 Aufgabe wird derzeit bearbeitet
success - GemPix2 Aufgabe erfolgreich mit generierten Bildern abgeschlossen
failed - GemPix2 Aufgabe aufgrund eines Fehlers fehlgeschlagen

Fehler-Antworten

404 - Task Not Found

{"code": 1, "message": "task not found"}

401 - Unauthorized

{"code": 401, "message": "Invalid API key"}

GemPix2 Datenmodelle

Vollständige Referenz für alle GemPix2 Datenmodelle und Schemas, die in den API-Antworten und -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

GemPix2 Verfügbare Modelle

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

Fehlerbehandlung

Umfassender Leitfaden zur Behandlung von Fehlern und zum Verstehen von API-Antwortcodes. Alle Fehlerantworten folgen einem einheitlichen Format, um Ihnen bei der effektiven Fehlerbehebung zu helfen.

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

Best Practices für Fehlerbehandlung

  1. 1. Überprüfen Sie immer HTTP-Statuscodes, bevor Sie den Antwortinhalt verarbeiten:
  2. 2. Implementieren Sie exponentielles Backoff für Wiederholungslogik bei 500-Fehlern:
  3. 3. Protokollieren Sie Fehlerantworten mit detaillierten Informationen für das Debugging:
  4. 4. Validieren Sie Eingaben, bevor Sie Anfragen senden, um 400-Fehler zu vermeiden:
  5. 5. Behandeln Sie Authentifizierungsfehler, indem Sie Benutzer auffordern, API-Schlüssel zu aktualisieren:
  6. 6. Überwachen Sie den Aufgabenstatus regelmäßig, anstatt zu häufig abzufragen:
  7. 7. Verwenden Sie Webhooks, wenn möglich, um Abfragen für Aufgabenabschluss zu vermeiden:

Beispiel für 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;
  }
}