Skip to Content
ModelleGPT ImageBilder bearbeiten und kombinieren

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.

POST/v1/images/editsGemeinsame Parameter

Vorbereitung

Sie benötigenDetails
API-SchlüsselErstellen Sie einen in der OfoxAI-Konsole  und ersetzen Sie YOUR_OFOX_API_KEY im Code
UmgebungcURL benötigt jq zum Dekodieren des Bildes; Python benötigt pip install openai; Node.js 18 oder neuer, keine Abhängigkeiten
BilderLegen Sie eine input.png in das aktuelle Verzeichnis; zum Kombinieren zusätzlich eine input2.png. PNG oder JPEG, jeweils ≤ 15 MB
TimeoutSetzen Sie das Client-Timeout auf 600 Sekunden. Hohe Qualität, große Formate oder Bearbeitungen können mehrere Minuten dauern
Im Code verwendete Werte
API-URLhttps://api.ofox.io/v1
Modell-IDopenai/gpt-image-2.5-sunburstDie Beispiele verwenden flare; für die Bearbeitung wird sunburst empfohlen
API-SchlüsselErsetzen Sie YOUR_OFOX_API_KEY im Code durch Ihren Schlüssel
Python-Abhängigkeitenpip install openai

Ein Bild bearbeiten

Jedes der folgenden Beispiele wurde unverändert ausgeführt. Das Ergebnis wird als output.png im aktuellen Verzeichnis gespeichert.

Terminal
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.png

Wenn 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.

AnwendungsfallBeispiel-Prompt
Ein Bild bearbeitenErsetze den Hintergrund durch eine Holztischplatte und lasse das Motiv unverändert
Bilder kombinierenSetze das Motiv des ersten Bildes auf den Hintergrund des zweiten Bildes

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.

Terminal
# 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.png

Anbieter

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.

Erforderlich
imageerforderlichfileform

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
X-OfoxAI-Provider-Typestringheader· Werteazure_foundryopenai

In der Regel nicht erforderlich — das Gateway leitet automatisch weiter. Verwenden Sie ihn nur, um einen bestimmten Anbieter festzulegen.

Upload-Grenzen

PunktGrenze
Jedes Referenzbild≤ 15 MB
Gesamte Anfrage≤ 50 MB
Anzahl der BilderKeine Gateway-Grenze; halten Sie sie bei 16 oder weniger
FormatPNG, JPEG

Das Modell skaliert Referenzbilder auf etwa 1024 px. Dateien über 5 MB verlangsamen nur den Upload; sie verbessern das Ergebnis nicht.

Häufige Fehler

FehlerUrsacheLösung
Invalid image file or modeDas hochgeladene Bild ist kein Standard-PNG oder -JPEGErneut als PNG oder JPEG exportieren
Invalid file 'image[0]': unsupported mimetypeDie hochgeladene Datei ist kein BildLaden Sie ein PNG-, JPEG- oder WebP-Bild hoch
does not support the 'input_fidelity' parameterinput_fidelity wurde gesendetEntfernen Sie den Parameter; diese Reihe verarbeitet Referenzbilder stets mit hoher Detailtreue
moderation_blockedPrompt oder Referenzbild wurde vom Sicherheitssystem des Upstream-Anbieters blockiertÄndern Sie Prompt oder Referenzbild und versuchen Sie es erneut
provider_type_unavailableDer manuell festgelegte Anbieter stellt dieses Modell nicht bereitEntfernen Sie den Header X-OfoxAI-Provider-Type
Invalid sizeDie angegebene Größe verstößt gegen eine der vier RegelnSiehe Größe
404 model_not_foundModell-ID falsch geschrieben oder falsche Groß-/KleinschreibungKopieren Sie die Modell-ID von dieser Seite

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.

Last updated on