Bilder in Ihren eigenen Tools generieren

Ich möchte mit den GPT-Image-Modellen von OfoxAI Bilder generieren. Ich habe bereits einen API-Schlüssel in der OfoxAI-Konsole erstellt. Ich bin technisch nicht sehr versiert, bitte führen Sie mich daher Schritt für Schritt durch den Vorgang. Erklären Sie mir vor jedem Schritt in einfachen Worten, was Sie tun und was als Nächstes folgt.

[Schritt 1: den Schlüssel sicher speichern]
1. Erstellen Sie im aktuellen Ordner eine Datei .env mit einer Zeile: OFOX_API_KEY= (Wert leer lassen). Wenn der aktuelle Ordner ein Code-Repository ist, fügen Sie .env zu .gitignore hinzu.
2. Sagen Sie mir, wo die Datei liegt und wie ich sie öffne, damit ich den Schlüssel selbst nach dem Gleichheitszeichen einfügen und speichern kann.
3. Bitten Sie mich nicht, den Schlüssel in diesem Chat zu senden. Falls ich ihn versehentlich einfüge, erinnern Sie mich daran, diesen Schlüssel in der Konsole zu löschen und einen neuen zu erstellen.
4. Warten Sie, bis ich „fertig“ schreibe, bevor Sie fortfahren.

[Schritt 2: die Bildgenerierung vorbereiten]
5. Schreiben Sie ein kleines Skript, das OFOX_API_KEY aus .env liest und POST https://api.ofox.ai/v1/images/generations aufruft, um ein Bild zu generieren.
6. Verwenden Sie das Modell openai/gpt-image-2.5-flare, quality low, size 1024x1024, und setzen Sie das Client-Timeout auf 600 Sekunden.
7. Das zurückgegebene data[0].b64_json ist reines Base64. Dekodieren Sie es und speichern Sie es als PNG in einem Ordner images im aktuellen Ordner.
8. Geben Sie den Schlüssel nicht aus und schreiben Sie ihn nicht in das Skript.

[Schritt 3: ein Bild testen]
9. Generieren Sie zuerst „einen roten Apfel auf einem weißen Tisch“ und sagen Sie mir dann, wo das Bild gespeichert wurde und wie ich es öffne.
10. Generieren Sie danach jedes Mal, wenn ich ein Bild beschreibe, eines mit diesem Skript und sagen Sie mir, wo es gespeichert wurde. Wenn ich „höhere Qualität“ sage, ändern Sie quality auf medium oder high und weisen Sie mich darauf hin, dass dies mehr kostet und länger dauert.

[Wenn etwas fehlschlägt]
11. Geben Sie den HTTP-Status und den vollständigen Fehler aus (einschließlich error.message und request_id), suchen Sie die Ursache unter https://ofox.ai/de/docs/develop/models/gpt-image#errors und ändern Sie vor dem nächsten Versuch nur eine Sache.
12. Wenn derselbe Fehler nach zwei Korrekturen bestehen bleibt, halten Sie an, erklären Sie mir das Problem in einfachen Worten und geben Sie mir die request_id sowie die genaue Fehlermeldung, damit ich OfoxAI kontaktieren kann.
13. Generieren Sie jeweils nur ein Bild und wiederholen Sie Anfragen nicht eigenständig in Serie (jede Anfrage wird abgerechnet).

Ich möchte die Bildgenerierung mit OfoxAI GPT Image in dieses Projekt einbauen. Ich habe bereits einen API-Schlüssel in der OfoxAI-Konsole erstellt. Ich bin technisch nicht sehr versiert, bitte führen Sie mich daher Schritt für Schritt durch den Vorgang. Erklären Sie mir vor jedem Schritt in einfachen Worten, was Sie tun und was als Nächstes folgt.

[Schritt 1: den Schlüssel sicher speichern]
1. Erstellen Sie im Projekt eine Datei .env mit einer Zeile: OFOX_API_KEY= (Wert leer lassen).
2. Fügen Sie .env zu .gitignore hinzu, damit die Datei nie committet oder hochgeladen wird.
3. Sagen Sie mir, wo die Datei liegt und wie ich sie öffne, damit ich den Schlüssel selbst nach dem Gleichheitszeichen einfügen und speichern kann.
4. Bitten Sie mich nicht, den Schlüssel in diesem Chat zu senden. Falls ich ihn versehentlich einfüge, erinnern Sie mich daran, diesen Schlüssel in der Konsole zu löschen und einen neuen zu erstellen.
5. Warten Sie, bis ich „fertig“ schreibe, bevor Sie fortfahren.

[Schritt 2: den Code schreiben]
6. Verwenden Sie das offizielle OpenAI SDK mit den Bild-Endpunkten von OfoxAI und base_url https://api.ofox.ai/v1; lesen Sie den Schlüssel aus OFOX_API_KEY in .env.
 - Text zu Bild: POST /v1/images/generations
 - Bearbeiten, Bilder kombinieren, Inpainting: POST /v1/images/edits (Multipart-Upload)
7. Verwenden Sie vollständige Modell-IDs: openai/gpt-image-2.5-flare (openai/gpt-image-2.5-sunburst für die Bearbeitung).
8. Übergeben Sie quality immer explizit; verwenden Sie während der Entwicklung low. Wird der Parameter weggelassen, wählt das Modell selbst eine Stufe.
9. size muss alle folgenden Bedingungen erfüllen: Breite und Höhe durch 16 teilbar, längste Kante ≤ 3840, Seitenverhältnis zwischen 1:3 und 3:1, Gesamtpixel ≥ 655.360.
10. Das Ergebnis steht in data[0].b64_json als reines Base64 ohne data:-Präfix; dekodieren Sie es und speichern Sie es als Bilddatei.
11. Setzen Sie das Client-Timeout auf 600 Sekunden.
12. Senden Sie weder response_format noch input_fidelity noch style.
13. Schreiben Sie den Schlüssel niemals in Code, Logs oder Fehlermeldungen; maskieren Sie den Authorization-Header bei der Ausgabe von Anfragen.

[Schritt 3: testen]
14. Führen Sie einen echten Aufruf mit quality=low und size=1024x1024 durch, bestätigen Sie, dass er 200 liefert und sich das Bild öffnen lässt, und sagen Sie mir dann, wo das Bild gespeichert wurde.
15. Generieren Sie beim Testen jeweils nur ein Bild; schreiben Sie keine Schleifen für Serientests (jede Anfrage wird abgerechnet).

[Wenn etwas fehlschlägt]
16. Geben Sie den HTTP-Status und den vollständigen Antwortkörper aus (einschließlich error.message und request_id) und suchen Sie die Ursache unter https://ofox.ai/de/docs/develop/models/gpt-image#errors
17. Bei 429 warten Sie und versuchen es erneut; bei anderen Fehlern korrigieren Sie zuerst die Anfrage, statt sie unverändert zu wiederholen.
18. Wenn derselbe Fehler nach zwei Korrekturen bestehen bleibt, halten Sie an, erklären Sie mir das Problem in einfachen Worten und geben Sie mir die request_id sowie die genaue Fehlermeldung, damit ich OfoxAI kontaktieren kann.

[Prüfung vor dem Livegang]
19. Wenn ich „bereit für den Livegang“ sage, prüfen Sie jeden Punkt und teilen Sie mir das Ergebnis mit: kein Schlüssel im Code oder in der Commit-Historie; .env steht in .gitignore; jede Anfrage übergibt quality; das Timeout beträgt ≥ 600 Sekunden; Fehler geben den Statuscode, den unveränderten Fehlertext und die request_id aus.

Referenzen:
- Werte und Beschränkungen dieser Reihe: https://ofox.ai/de/docs/develop/models/gpt-image
- Gemeinsame Endpunktstruktur: https://ofox.ai/de/docs/api/openai/images