Bildgenerierung

TokenLab unterstützt Text-zu-Bild, Bild-zu-Bild und Bildbearbeitung über öffentliche Bildendpunkte. Bildmodelle teilen sich kein universelles Parameterset, daher sollten Produktionsclients zuerst den Endpunkt wählen, dann das Modell auswählen und anschließend nur die von diesem Modell unterstützten Felder senden.

Wann Jeder Endpunkt Verwendet Werden SollCopy Anchor Link

Senden Sie immer model. Bildendpunkte verlassen sich absichtlich nicht auf ein historisches implizites Standardmodell für Produktionsverkehr.

Wählen Sie Ein ModellCopy Anchor Link

Beginnen Sie mit der Modellerkennung und überprüfen Sie den TokenLab-Vertrag des ausgewählten Modells:

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

Für Nicht-Chat-Modelle kann die Listenantwort GET /v1/models enthalten. Modell-Detailseiten können den umfassenderen GET /v1/models/{model} offenlegen. Verwenden Sie diese Felder zur Bestätigung:

• 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 AnfrageformCopy Anchor Link

• 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 BeispielCopy Anchor Link

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 BeispielCopy Anchor Link

curl https://api.tokenlab.sh/v1/images/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "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 VerarbeitenCopy Anchor Link

Bildantworten können synchron oder asynchron sein:

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

Bewahren Sie die zurückgegebene Bild-URL, die Task-ID, das Modell und Ihre eigene Benutzer-/Job-ID auf. Pollen Sie nicht weiter, nachdem ein terminaler Status erreicht wurde.

Produktions-ChecklisteCopy Anchor Link

• 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 FehlerCopy Anchor Link

API-ReferenzCopy Anchor Link