Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
Übersicht

Erstellt ein bearbeitetes oder erweitertes Bild auf Basis eines Originalbilds und eines Prompts. Die Route unterstützt sowohl:
  • den unten dokumentierten klassischen DALL-E-Stil mit multipart/form-data
  • JSON-Anfragen mit image_url, image_urls oder offiziellen images-Referenzen für unterstützte Image-to-Image-Familien
gpt-image-2 wird hier unterstützt. Akzeptiert werden multipart-image-Uploads, JSON image_url / image_urls und offizielle images[]-Referenzen (image_url oder file_id) mit bis zu 16 Quellbildern. file_id-Werte zuerst über /v1/files erstellen. Mit async: true wird zuerst eine Aufgabe zurückgegeben; offizielle FLUX/BFL-Edit-Modelle verwenden denselben Polling-Ablauf.gpt-image-2-Edits akzeptieren weder resolution noch background; verwenden Sie size für die Ausgabemaße. Für Multi-Image- oder latenzstarke Edits wird async: true empfohlen; pollen Sie anschließend die zurückgegebene Aufgabe.Nano-Banana-Referenzbild-Anfragen (nano-banana, nano-banana-2 und nano-banana-pro) sind auf /v1/images/generations mit operation: "image-to-image" und image_urls verfügbar, nicht auf diesem /v1/images/edits-Endpunkt.xAI-Grok-Imagine-Bildbearbeitungsmodelle (grok-imagine-image, grok-imagine-image-quality und das legacy grok-imagine-image-pro) akzeptieren höchstens 3 Quellbilder. Anfragen mit mehr als 3 Quellbildern schlagen vor der Weiterleitung an den Upstream mit 400 too_many_images fehl.Kompatibilitätshinweis: Wenn eine gpt-image-2-Anfrage input_fidelity enthält, entfernt TokenLab das Feld vor der Weiterleitung, weil GPT Image 2 Bildeingaben bereits automatisch mit hoher Treue verarbeitet.

​
Anfragekörper

Timeout für synchrone Anfragen: Einige geroutete Bildanbieter geben das endgültige Bild inline zurück und warten dafür, bis die Generierung abgeschlossen ist. Hochauflösende oder hochwertige Anfragen können fast eine Minute oder länger dauern; setzen Sie das Timeout Ihres HTTP-Clients daher auf mindestens 120s. Wenn die Create-Antwort status: "pending", task_id oder poll_url enthält, folgen Sie stattdessen der zurückgegebenen poll_url. Remote-Bild-URLs: Wenn der geroutete Anbieter multipart-Eingaben verlangt, ruft TokenLab JSON image_url, image_urls oder images[].image_url ab und leitet die Bytes als multipart-image-Teile weiter. URLs müssen öffentliche http/https-Ressourcen sein, ohne eingebettete Zugangsdaten oder Fragmente, und dürfen nicht auf localhost, private oder reservierte IP-Bereiche auflösen; jede Weiterleitung wird erneut geprüft. Die geladene Nutzlast muss ein echtes PNG-, JPEG- oder WebP-Bild sein. Grenzen: 50MB pro Bild, 200MB insgesamt für per URL geladene Bilder pro Anfrage, 10s Fetch-Timeout und bis zu 3 Weiterleitungen.
​
image
file
Multipart-Quellbilder. Wiederhole image, um mehrere GPT-Image-Quellen zu senden. Dateien müssen PNG, JPEG oder WebP sein, bis zu 16 Quellbilder und jeweils 50MB. xAI-Grok-Imagine-Edit-Modelle verwenden dieselben Eingabefelder, begrenzen Quellbilder aber auf 3. Legacy-DALL-E-2-Maskenbearbeitungen erwarten weiterhin PNG-Eingaben mit transparenten Bereichen oder ein separates mask.
​
prompt
string
erforderlich
Eine Textbeschreibung der gewünschten Bearbeitung.
​
mask
file
Ein zusätzliches Bild, dessen vollständig transparente Bereiche angeben, wo das Bild bearbeitet werden soll. Muss eine gültige PNG-Datei sein, kleiner als 50MB und die gleichen Abmessungen wie image haben.
​
model
string
Standard:"dall-e-2"
Das Modell für Bildbearbeitungen. gpt-image-2 wird unterstützt; klassische DALL-E-Edits können weiterhin dall-e-2 verwenden.
​
n
integer
Standard:"1"
Die Anzahl der zu generierenden Bilder. Muss zwischen 1 und 10 liegen.
​
size
string
Die Größe des erzeugten Bildes. Für gpt-image-2 verwenden Sie auto oder WIDTHxHEIGHT; beide Abmessungen müssen Vielfache von 16 sein, die längste Kante höchstens 3840px, das Verhältnis lange/kurze Kante höchstens 3:1, und die Gesamtpixelzahl zwischen 655,360 und 8,294,400. Klassische DALL-E-Edits unterstützen 256x256, 512x512 oder 1024x1024.
​
response_format
string
Standard:"url"
Format, in dem die erzeugten Bilder zurückgegeben werden. Muss url oder b64_json sein; Standard ist url.Bei Azure Official- oder Azure-kompatiblen gpt-image-2-Routen leitet TokenLab response_format nicht an upstream weiter. Das Gateway erhält die Bilddaten upstream immer als b64_json; bei url-Anfragen lädt es jedes Bild in das CDN hoch und gibt data[].url zurück. Wenn der CDN-Speicher nicht verfügbar ist oder der Upload fehlschlägt, schlägt die Anfrage fehl, statt auf Base64 zurückzufallen. Bei b64_json wird das rohe Base64 zurückgegeben.
​
async
boolean
Standard:"false"
Auf true setzen, um mit gpt-image-2 oder offiziellen FLUX/BFL-Edit-Modellen eine Aufgabe zurückzugeben, bevor das endgültige Bild bereit ist. Abgeschlossene Async-Edits liefern unabhängig vom angeforderten response_format URLs; verwenden Sie synchrone Anfragen, wenn Sie b64_json benötigen.
​
user
string
Eine eindeutige Kennung für Ihren Endbenutzer zur Missbrauchsüberwachung.

​
Antwort

​
created
integer
Unix-Zeitstempel der Bilderstellung.
​
data
array
Array der generierten Bilder.Jedes Objekt enthält:
  • url (string): URL des bearbeiteten Bildes, wenn response_format auf url gesetzt ist
  • b64_json (string): Base64-kodiertes Bild, wenn response_format auf b64_json gesetzt ist

​
Antwort für asynchrone Aufgaben

Setzen Sie async: true mit gpt-image-2 oder offiziellen FLUX/BFL-Edit-Modellen, um eine Aufgabe zu erstellen, statt im Request auf das bearbeitete Bild zu warten. Die Antwort enthält status: "pending", task_id und poll_url. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe completed oder failed erreicht. Asynchrone Edit-Aufgaben liefern nur die endgültigen Bild-URLs. Wenn Sie rohe b64_json-Bilddaten benötigen, verwenden Sie eine synchrone Anfrage. Beim Erstellen der Aufgabe kann der geschätzte Betrag reserviert werden. Abgeschlossene Aufgaben werden nach tatsächlicher Nutzung abgerechnet; fehlgeschlagene oder abgelaufene Aufgaben werden freigegeben oder erstattet. 
curl -X POST "https://api.tokenlab.sh/v1/images/edits" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "image=@sunlit_lounge.png" \
  -F "mask=@mask.png" \
  -F "prompt=A sunlit indoor lounge area with a pool" \
  -F "n=1" \
  -F "size=1024x1024"

{
  "created": 1706000000,
  "data": [
    {
      "url": "https://..."
    }
  ]
}

​
Hinweise

Fehler beim Abrufen von Remote-Bildern werden als Eingabefehler zurückgegeben, bevor die Upstream-Anfrage gesendet wird. Nicht erreichbare URLs, Timeouts, 403/404-Antworten, private/interne Hosts, Zugangsdaten oder Fragmente in der URL, Nicht-Bild-Inhalte, nicht unterstützte Formate und Größenüberschreitungen liefern 400 oder 413 und verweisen auf image_url / image_urls[n]. Für private oder header-geschützte Assets lade multipart-image-Dateien direkt hoch oder erstelle /v1/files-Referenzen.