Bild bearbeiten

ÜbersichtCopy Anchor Link

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_urls oder offiziellen images-Referenzen für unterstützte Image-to-Image-Familien

AnfragekörperCopy Anchor Link

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 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 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: 50 MiB pro Bild, 200 MiB insgesamt für per URL geladene Bilder pro Anfrage, 30s Fetch-Timeout und bis zu 3 Weiterleitungen.

JSON-Anfragen müssen genau eines der Felder image_url, image_urls oder images enthalten. Jedes images[]-Objekt muss genau image_url oder file_id enthalten. Die Gesamtgrenze von 200 MiB umfasst alle Ausgangsbilder und die Maske.

AntwortCopy Anchor Link

Antwort für asynchrone AufgabenCopy Anchor Link

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 "model=gpt-image-2" \
  -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://..."
    }
  ]
}

HinweiseCopy Anchor Link

{
  "model": "hy-image-v3.5-preview",
  "prompt": "Change the table to pale blue",
  "image_url": "https://example.com/reference.png",
  "size": "1024x1024",
  "n": 1,
  "response_format": "url"
}