Bildgenerierung

​

Wann Jeder Endpunkt Verwendet Werden Soll

​

Wählen Sie Ein Modell

curl "https://api.tokenlab.sh/v1/models?recommended_for=image" \
  -H "Authorization: Bearer sk-your-api-key"

• Die unterstützte Operation, wie text-to-image, image-to-image oder image-edit.
• Den vom Modell erwarteten Anfrageendpunkt.
• Welche Form für Referenzen verwendet werden soll, wie image_url, image_urls, reference_image_urls, multipart image oder JSON images[].
• Ob das Modell size, aspect_ratio, resolution, quality, background, output_format oder response_format akzeptiert.

​

Regeln Für Die Anfrageform

• Anfragen im Stil von gpt-image-2 verwenden OpenAI-ähnliche Felder wie size, quality und Bearbeitungsfelder. Für Erzeugung und Bearbeitung akzeptiert background auto oder opaque; transparent wird nicht unterstützt. Lassen Sie optionale Felder weg, wenn Sie möchten, dass das Modell oder TokenLab automatische Standardwerte verwendet.
• Die Bildfamilien Gemini und Nano Banana verwenden normalerweise aspect_ratio; senden Sie resolution nur, wenn der Modelldetails es offenlegt.
• Nano Banana Bild-zu-Bild gehört zu /v1/images/generations mit operation: "image-to-image" und Referenzbild-URLs.
• /v1/images/generations akzeptiert keine obersten images[] oder file_id; das sind Formen für den Bearbeitungsfluss.
• Remote-Bildreferenzen müssen öffentliche http oder https URLs sein. Senden Sie keine privaten Netzwerk-URLs, eingebetteten Anmeldeinformationen, URL-Fragmenten oder signierten URLs, die vor Beginn der Verarbeitung ablaufen könnten.

​

Text-Zu-Bild Beispiel

curl https://api.tokenlab.sh/v1/images/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Ein sauberes Produktfoto einer keramischen Kaffeetasse auf einem Walnusstisch",
    "size": "1024x1024",
    "response_format": "url"
  }'

​

Referenzbild Beispiel

curl https://api.tokenlab.sh/v1/images/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana",
    "operation": "image-to-image",
    "prompt": "Behalten Sie die Produktform bei, ändern Sie den Hintergrund in ein helles Studio-Setup",
    "image_urls": ["https://example.com/input/product.png"],
    "aspect_ratio": "1:1"
  }'

​

Ergebnisse Verarbeiten

• Synchrone Antworten geben endgültige data[] mit url oder b64_json zurück.
• Asynchrone Antworten geben id, task_id, status und normalerweise poll_url zurück.
• Bevorzugen Sie poll_url, wenn es vorhanden ist. Wenn Sie eine feste Route benötigen, poll GET /v1/tasks/{id}.
• Verwenden Sie synchrone Anfragen, wenn Sie speziell b64_json benötigen; asynchrone Bildresultate sind URL-orientiert.

curl "https://api.tokenlab.sh/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer sk-your-api-key"

​

Produktions-Checkliste

• Validieren Sie Benutzereingaben, bevor Sie TokenLab aufrufen: Prompt-Länge, Bildanzahl, URL-Erreichbarkeit und Dateityp.
• Setzen Sie HTTP-Timeouts hoch genug für synchrone hochauflösende Anfragen. Verwenden Sie den asynchronen Modus, wo verfügbar, für lange Arbeiten.
• Speichern Sie request_id, task_id, poll_url, Modell, Endpunkt und bereinigte Anfrageform für den Support.
• Überprüfen Sie bei einem Client-Timeout, ob eine Aufgabe erstellt wurde, bevor Sie die Erstellungsanfrage erneut versuchen.
• Versöhnen Sie die Kosten mit den Nutzungsaufzeichnungen und billing_transaction_id, wenn vorhanden, nicht mit den Anbieter-Task-IDs.

​

Häufige Fehler

​

API-Referenz