Bildgenerierung einbinden

Bilder über die OpenAI Images-Schnittstelle generieren, das Base64-Ergebnis speichern und Modellberechtigungen sowie Zeitüberschreitungen überprüfen.

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 abfragen und dann im Konsolen-Modellverzeichnis 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:

1
import base64
2
import os
3
from pathlib import Path
4
from openai import OpenAI
5

6
client = OpenAI(
7
    api_key=os.environ["ONEZHE_API_KEY"],
8
    base_url="https://1zheai.com/v1",
9
    timeout=300.0,
10
    max_retries=0,
11
)
12
result = client.images.generate(
13
    model=os.environ.get("ONEZHE_IMAGE_MODEL", "gpt-image-1.5"),
14
    prompt="一只白色陶瓷茶杯放在浅灰色桌面上，柔和自然光，无文字。",
15
)
16
if not result.data:
17
    raise RuntimeError("响应没有图片数据，请检查错误信息与调用日志。")
18
item = result.data[0]
19
if item.b64_json:
20
    target = Path("generated-image.png")
21
    target.write_bytes(base64.b64decode(item.b64_json, validate=True))
22
    print(f"图片已保存到 {target.resolve()}")
23
elif item.url:
24
    print("返回的是图片地址，请及时下载：", item.url)
25
else:
26
    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. Die Kosten richten sich nach dem Echtzeit-Modellverzeichnis dieser Website; Wiederholungsstrategie siehe Zeitüberschreitung und Wiederholung.