---
title: "Bildgenerierung einbinden"
description: "Bilder über die OpenAI Images-Schnittstelle generieren, das Base64-Ergebnis speichern und Modellberechtigungen sowie Zeitüberschreitungen überprüfen."
headingIds: {"Schnittstelle und Vorbereitung":"section-1","Ein Bild generieren und speichern":"section-2","Vor Hinzufügen von Parametern die Modellunterstützung prüfen":"section-3","Häufige Probleme":"section-4"}
---

<aside className="docs-publication" data-pagefind-ignore>

Dokumentation gepflegt von [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Quellen und Korrekturen](https://1zheai.com/en/editorial/).

Fehler gefunden? [Support kontaktieren](mailto:support@1zheai.com) mit Seitenadresse und Beschreibung. Senden Sie keine API-Schlüssel oder Kontodaten.

</aside>
Das öffentliche Modellverzeichnis dieser Website listet derzeit `gpt-image-1.5` und `chatgpt-image-latest` (geprüft am 2026-10-16). Vor der Verwendung zuerst die [verfügbaren Modelle für den Schlüssel](/de/docs/api-models/) abfragen und dann im [Konsolen-Modellverzeichnis](https://1zheai.com/model-catalog?lng=de) die Bildschnittstelle und Parameter bestätigen.

Diese Seite bietet Einbindungsbeispiele gemäß dem OpenAI Images-Protokoll; bei diesem Dokumentationsupdate wurde keine kostenpflichtige Bildgenerierung ausgeführt, daher dürfen die folgenden Beispiele nicht als getestet für alle Modell-, Größen- und Qualitätskombinationen angesehen werden.

## Schnittstelle und Vorbereitung

- Vollständige Adresse: `POST https://1zheai.com/v1/images/generations`
- OpenAI SDK Base URL: `https://1zheai.com/v1`
- Die Umgebungsvariable `ONEZHE_API_KEY` dieser Website verwenden.
- Python SDK installieren: `python -m pip install openai`.

## Ein Bild generieren und speichern

Speichern als `generate-image.py`, im Terminal ausführen `python generate-image.py`:

```python
import base64
import os
from pathlib import Path
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ONEZHE_API_KEY"],
    base_url="https://1zheai.com/v1",
    timeout=300.0,
    max_retries=0,
)
result = client.images.generate(
    model=os.environ.get("ONEZHE_IMAGE_MODEL", "gpt-image-1.5"),
    prompt="一只白色陶瓷茶杯放在浅灰色桌面上，柔和自然光，无文字。",
)
if not result.data:
    raise RuntimeError("响应没有图片数据，请检查错误信息与调用日志。")
item = result.data[0]
if item.b64_json:
    target = Path("generated-image.png")
    target.write_bytes(base64.b64decode(item.b64_json, validate=True))
    print(f"图片已保存到 {target.resolve()}")
elif item.url:
    print("返回的是图片地址，请及时下载：", item.url)
else:
    raise RuntimeError("响应没有 b64_json 或 url。")
```

Das Beispiel verwendet das Standard-Ausgabeformat. Wenn ein anderes Format wie JPEG / WebP angegeben wird, muss auch die Dateiendung beim Speichern entsprechend geändert werden. Den Base64-String nicht direkt als Textdatei schreiben und dann in PNG umbenennen.

## Vor Hinzufügen von Parametern die Modellunterstützung prüfen

Zuerst mit einer Anfrage nur mit `model` und `prompt` verifizieren. Parameter wie Größe, Qualität, transparenter Hintergrund und Ausgabeformat sind nicht bei allen Bildmodellen allgemein gültig; Modellnamen oder proprietäre Parameter anderer Anbieter nicht direkt kopieren.

Bei Rückgabe von `data[].b64_json` Base64 dekodieren; bei Rückgabe von `data[].url` rechtzeitig herunterladen und die temporäre URL nicht als dauerhafte Speicherung behandeln. Die Anwendung muss die Ergebnisspeicherung selbst organisieren.

## Häufige Probleme

| Situation | Überprüfungsmethode |
| --- | --- |
| 400 Parameter nicht unterstützt | Benutzerdefinierte Größe, Qualität usw. entfernen und dann schrittweise prüfen |
| 403 / 404 | Bildmodell-ID, Schlüsselberechtigungen und vollständigen Schnittstellenpfad prüfen |
| Lange Wartezeit | Für die Generierung eine angemessene Zeitüberschreitung einrichten und einen Fortschrittsstatus anzeigen, um durch wiederholtes Klicken doppelte Einreichungen zu vermeiden |
| Kein Bild nach Zeitüberschreitung | Zuerst die Aufrufprotokolle einsehen; kein erhaltenes Ergebnis bedeutet nicht, dass die Upstream-Seite die Anfrage nicht verarbeitet hat |
| Vorhandenes Bild bearbeiten | Bildbearbeitung ist eine andere Schnittstelle und Eingabemethode, das Text-zu-Bild-Beispiel dieser Seite kann nicht direkt ersetzen |

Protokollparameter-Referenz [OpenAI Bildgenerierungsreferenz](https://developers.openai.com/api/reference/resources/images/methods/generate). Die Kosten richten sich nach dem Echtzeit-Modellverzeichnis dieser Website; Wiederholungsstrategie siehe [Zeitüberschreitung und Wiederholung](/de/docs/retries/).