---
title: "Intégration de la génération d'images"
description: "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."
headingIds: {"API et préparation":"section-1","Générer et enregistrer une image":"section-2","Vérifier la prise en charge du modèle avant d’ajouter des paramètres":"section-3","Problèmes courants":"section-4"}
---

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

Documentation maintenue par [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Sources et corrections](https://1zheai.com/en/editorial/).

Vous avez trouvé une erreur ? [Contactez l'assistance](mailto:support@1zheai.com) en indiquant l'adresse de la page et une description. N'envoyez pas de clés API ni d'identifiants de compte.

</aside>
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é](/fr/docs/api-models/), puis confirmez l'API d'images et ses paramètres dans le [catalogue de modèles de la console](https://1zheai.com/model-catalog?lng=fr).

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 :

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

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](https://developers.openai.com/api/reference/resources/images/methods/generate). Les frais sont basés sur le catalogue de modèles en temps réel de ce site ; voir [Timeouts et retries](/fr/docs/retries/) pour la stratégie de nouvelle tentative.