Skip to main content
Pour une nouvelle intégration, utilisez Génération d’images avec le protocole unifié /ai/v1/images/generations. Les interfaces compatibles de cette page restent disponibles. Consultez l’API Schema du modèle, sélectionnez l’endpoint par son path et lisez son request.schema sans dépendre de l’ordre du tableau.

Inventaire actuel des modèles

Cet inventaire indique les modèles actuellement disponibles. Il ne signifie pas que tous acceptent les mêmes champs. Sélectionnez l’endpoint par path dans le Schema du modèle, puis lisez son request.schema.

API

Interface API

URL de requête

<model_path> est <provider/model_id>, par exemple <openai/gpt-image-1.5>, <qianfan/qwen-image>.

En-têtes de requête

Paramètres de requête

Paramètres généraux

Paramètres des modèles OpenAI

Paramètres des modèles Flux

Paramètres des modèles Qwen

Paramètres des modèles Doubao

Le nombre réel d’images pouvant être générées est influencé non seulement par max_images mais aussi par le nombre d’images de référence fournies. Nombre d’images de référence en entrée + nombre final d’images générées ≤ 15.

Exemples d’utilisation

OpenAI

gpt-image-2

Il s’agit d’un modèle OpenAI d’édition d’image. Utilisez le nom complet gpt-image-2 ; image2 n’est pas un ID de modèle valide. Lorsque l’endpoint renvoie b64_json, les exemples ci-dessous enregistrent le résultat dans edited.png.

Google Imagen

Qwen

Doubao

Flux

  • flux-2-flex et flux-2-pro sont des endpoints asynchrones, nécessitant une requête en deux étapes. Cette série est extrêmement rapide, quasi instantanée.

Génération en une étape avec FLUX

Génération asynchrone Flux

Étape 1 : envoyer la requête de génération Exemple de résultat de sortie :
Étape 2 : récupérer le lien de l’image générée
Get Image

Ideogram V3

  1. Les versions inférieures à V3 (V_2, V_1, etc.) correspondent à d’anciennes interfaces et ne sont pas prises en charge.
  2. Les liens retournés nécessitent un proxy réseau pour être accessibles.

Réponses d’erreur et codes d’erreur de compatibilité

Cette section s’applique aux interfaces Legacy /v1/images/* de cette page. Les nouvelles interfaces /ai/v1/images/* utilisent un contrat d’erreur d’image distinct. Les structures de réponse et les codes d’erreur des deux ensembles d’interfaces doivent être traités séparément. Une réponse d’erreur générale de l’interface Legacy d’images se présente comme suit. param est facultatif et tid est généralement ajouté à la fin de message au lieu d’être renvoyé dans un champ distinct :

Envoyer un retour pour une erreur HTTP 5xx

Lorsqu’une requête renvoie HTTP 5xx, envoyez un retour en joignant le tid inclus dans message.
Outre les codes d’erreur de compatibilité stables du tableau, l’interface Legacy d’images peut renvoyer d’autres code dynamiques et des message expurgés provenant du fournisseur de modèles ou de la chaîne de compatibilité. Ces codes dynamiques forment un ensemble ouvert. Le client ne doit pas traiter les codes absents du tableau comme une énumération stable. Le tid inclus dans message est l’ID de traçage de la requête.
Dernière mise à jour : 2026-09-01