Übersicht
Erstellt ein bearbeitetes oder erweitertes Bild auf Basis eines Originalbilds und eines Prompts. Die Route unterstützt sowohl:- den unten dokumentierten OpenAI-kompatiblen Upload per
multipart/form-data - JSON-Anfragen mit
image_url,image_urlsoder offiziellenimages-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 in der Eingabevalidierung mit 400 too_many_images fehl.input_fidelity gehört nicht zum aktuellen öffentlichen TokenLab-Vertrag für gpt-image-2; lassen Sie es weg, sonst gibt die Anfrage 400 unsupported_parameter zurück.Anfragekörper
Timeout für synchrone Anfragen: Einige Bildanfragen 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 mindestens120s. 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 multipart-Eingaben benötigt werden, ruft TokenLab JSON image_url, image_urls oder images[].image_url ab und sendet die Bytes als multipart-image-Teile. 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.
Multipart-Quellbilder. Wiederholen Sie
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.Eine Textbeschreibung der gewünschten Bearbeitung.
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.In JSON-Anfragen kann mask auch ein Objekt mit genau einem der Felder image_url oder file_id sein; file_id-Werte müssen aus /v1/files stammen und an dieselbe Bildbearbeitungskonfiguration gebunden bleiben.Das Modell für Bildbearbeitungen. Verwenden Sie
gpt-image-2 für GPT-Image-Edits oder ein anderes aktuelles Bildbearbeitungsmodell aus GET /v1/models?recommended_for=image.Die Anzahl der zu generierenden Bilder. Muss zwischen 1 und 10 liegen.
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.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-Anfragen erhält TokenLab Bilddaten als b64_json. Bei url-Anfragen lädt TokenLab 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 in eine Base64-Antwort umgewandelt zu werden. Bei b64_json wird das rohe Base64 zurückgegeben.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.Eine eindeutige Kennung für Ihren Endbenutzer zur Missbrauchsüberwachung.
Antwort
Unix-Zeitstempel der Bilderstellung.
Array der generierten Bilder.Jedes Objekt enthält:
url(string): URL des bearbeiteten Bildes, wennresponse_formataufurlgesetzt istb64_json(string): Base64-kodiertes Bild, wennresponse_formataufb64_jsongesetzt ist
Antwort für asynchrone Aufgaben
Setzen Sieasync: 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.
Hinweise
Fehler beim Abrufen entfernter Bilder werden als Eingabefehler zurückgegeben, bevor die Generierung beginnt. 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 geben
400 oder 413 zurück und markieren die Eingabe image_url / image_urls[n]. Für private oder headergeschützte Assets laden Sie multipart-image-Dateien direkt hoch oder erstellen /v1/files-Referenzen.