Intégration de la génération d'images

Générer des images via l'API OpenAI Images, enregistrer le résultat en Base64 et diagnostiquer les permissions de modèle et les timeouts.

Le catalogue public de modèles de ce site répertorie actuellement gpt-image-1.5 et chatgpt-image-latest (vérifié le 2026-10-16). Avant utilisation, interrogez d’abord les modèles disponibles pour la clé, puis confirmez l’API d’images et ses paramètres dans le catalogue de modèles de la console.

Cette page fournit un exemple d’intégration conforme au protocole OpenAI Images ; cette mise à jour de la documentation n’a pas exécuté de génération d’images payante et ne doit pas être interprétée comme la preuve que toutes les combinaisons de modèles, de tailles et de qualités ont été testées.

API et préparation

Adresse complète : POST https://1zheai.com/v1/images/generations
Base URL du SDK OpenAI : https://1zheai.com/v1
Utilisez la variable d’environnement ONEZHE_API_KEY de ce site.
Installer le SDK Python : python -m pip install openai.

Générer et enregistrer une image

Enregistrez sous generate-image.py, puis exécutez python generate-image.py dans le terminal :

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。")

L’exemple utilise le format de sortie par défaut. Si vous spécifiez un autre format (JPEG / WebP, etc.), modifiez également l’extension de fichier lors de l’enregistrement. N’écrivez pas la chaîne Base64 directement dans un fichier texte puis ne la renommez pas en PNG.

Vérifier la prise en charge du modèle avant d’ajouter des paramètres

Validez d’abord avec une requête contenant uniquement model et prompt. Les paramètres tels que la taille, la qualité, l’arrière-plan transparent et le format de sortie ne sont pas universels parmi tous les modèles d’images ; ne copiez pas directement les noms de modèles ou les paramètres propriétaires d’autres fournisseurs.

Lorsque la réponse contient data[].b64_json, effectuez le décodage Base64 ; lorsqu’elle contient data[].url, téléchargez-la rapidement et n’utilisez pas l’URL temporaire comme stockage permanent. L’application doit gérer elle-même le stockage des résultats.

Problèmes courants

Situation	Méthode de diagnostic
400 paramètre non pris en charge	Retirez les paramètres optionnels personnalisés (taille, qualité, etc.) et vérifiez-les un par un
403 / 404	Vérifiez l’ID du modèle d’image, les permissions de la clé et le chemin complet de l’API
Temps d’attente long	Définissez un délai d’attente raisonnable pour la génération et affichez un état en cours d’exécution pour éviter les soumissions répétées par clics consécutifs
Aucune image après un timeout	Consultez d’abord les journaux d’appel ; l’absence de résultat reçu ne signifie pas que l’amont n’a pas traité la requête
Modifier une image existante	La modification d’image est une autre API et un autre mode d’entrée ; l’exemple de génération d’image à partir de texte de cette page ne peut pas le remplacer directement

Référence des paramètres du protocole : OpenAI image generation reference. Les frais sont basés sur le catalogue de modèles en temps réel de ce site ; voir Timeouts et retries pour la stratégie de nouvelle tentative.