Bilder bearbeiten und kombinieren
Ein oder mehrere Bilder hochladen und per Prompt verändern oder zusammenführen.
Sie schreiben keinen Code? Siehe Bilder in Ihren eigenen Tools generieren.
Vorbereitung
https://api.ofox.io/v1openai/gpt-image-2.5-sunburstDie Beispiele verwenden flare; für die Bearbeitung wird sunburst empfohlenpip install openaiEin Bild bearbeiten
Jedes der folgenden Beispiele wurde unverändert ausgeführt. Das Ergebnis wird als output.png im aktuellen Verzeichnis gespeichert.
cURL
curl -s https://api.ofox.io/v1/images/edits \
-H "Authorization: Bearer YOUR_OFOX_API_KEY" \
-F "model=openai/gpt-image-2.5-flare" \
-F "image=@input.png" \
-F "prompt=Replace the background with a wooden table, keep the subject unchanged" \
-F "quality=low" \
-o response.json
jq -r '.data[0].b64_json' response.json | base64 --decode > output.pngWenn Sie size weglassen, wählt das Modell die Ausgabegröße, die vom Original abweichen kann. Um die Originalgröße beizubehalten, geben Sie sie explizit an, z. B. size=1024x1024.
Den Prompt formulieren
Benennen Sie zwei Dinge klar: was geändert werden soll und was erhalten bleiben soll.
Bei mehreren Bildern beziehen Sie sich in Upload-Reihenfolge auf „das erste Bild“ und „das zweite Bild“. Um nur einen kleinen Teil des Bildes zu ändern, ist Inpainting zuverlässiger.
Mehrere Bilder kombinieren
Senden Sie mehrere Referenzbilder auf einmal. Die Upload-Reihenfolge bestimmt, worauf sich „das erste Bild“ und „das zweite Bild“ in Ihrem Prompt beziehen. Legen Sie input.png und input2.png in das aktuelle Verzeichnis.
cURL
# Up to 16 images per request, ≤ 15 MB each
curl -s https://api.ofox.io/v1/images/edits \
-H "Authorization: Bearer YOUR_OFOX_API_KEY" \
-F "model=openai/gpt-image-2.5-flare" \
-F "image[]=@input.png" \
-F "image[]=@input2.png" \
-F "prompt=Place the subject of the first image onto the background of the second" \
-F "quality=low" \
-o response.json
jq -r '.data[0].b64_json' response.json | base64 --decode > output.pngAnbieter
Sie müssen keinen Anbieter festlegen. Für alle drei Modelle stellen sowohl Azure als auch OpenAI den Bearbeitungs-Endpunkt bereit, und das Gateway leitet Anfragen automatisch weiter.
Bei Anforderungen an die Inhaltsmoderation können Sie einen Anbieter auswählen; der Bearbeitungs-Endpunkt akzeptiert jedoch nur den Header X-OfoxAI-Provider-Type, extra_body im Formular wird ignoriert. Ist ein Anbieter ausgewählt, wird bei dessen Nichtverfügbarkeit nicht auf einen anderen Anbieter ausgewichen. Siehe Anbieter auswählen.
Parameterwerte
Parameter, die spezifisch für den Bearbeitungs-Endpunkt sind. model, n, output_format und die übrigen Parameter funktionieren wie bei Text zu Bild — siehe Text zu Bild · Parameterwerte.
Das zu bearbeitende Bild. Bei mehreren Bildern wiederholen Sie das Feld als image[]; mit dem Python SDK übergeben Sie eine Liste.
▸ Details
Auch Referenzbilder werden als Tokens abgerechnet: Ein Referenzbild mit 1024×1024 ergab gemessen 1.024 Eingabe-Tokens. Deshalb kostet die Bearbeitung bei gleicher Größe mehr als Text zu Bild.
▶Erweitert · 1X-OfoxAI-Provider-TypeExpand
In der Regel nicht erforderlich — das Gateway leitet automatisch weiter. Verwenden Sie ihn nur, um einen bestimmten Anbieter festzulegen.
Upload-Grenzen
Das Modell skaliert Referenzbilder auf etwa 1024 px. Dateien über 5 MB verlangsamen nur den Upload; sie verbessern das Ergebnis nicht.
Häufige Fehler
Weitere Fehler finden Sie in der vollständigen Fehlertabelle.
Offizielle Dokumentation
Die Dokumentation von OpenAI beschreibt das Verhalten bei direktem Aufruf von OpenAI. Beim Aufruf über OfoxAI haben die gemessenen Ergebnisse auf diesen Seiten Vorrang. So müssen Sie beispielsweise für die Bearbeitung keinen Anbieter festlegen.