Consignes pour l’appel d’images (bonnes pratiques)

La génération d’images est une requête synchrone longue (généralement 10–60 secondes), différente des habitudes d’appel de l’interface de conversation. Veuillez lire attentivement cette page avant de passer à l’échelle.

Délais d’attente et tentatives de reprise

Définissez un délai d’attente côté client ≥120 secondes ; le délai par défaut de 30 secondes de la bibliothèque HTTP peut interrompre la connexion avant la fin de la génération ;
Une requête interrompue peut déjà être en cours de facturation en amont — en cas d’échec, le montant préautorisé est automatiquement restitué, mais ne relancez pas immédiatement de manière intensive ; il est recommandé d’utiliser un backoff exponentiel (5s → 15s → 45s) ;
429 indique qu’une limitation de débit a été déclenchée ; voir Limitation de débit et 429 pour la marche à suivre.

Choix du modèle et du format

Le format/résolution est indiqué par le suffixe du nom du modèle (-portrait, -landscape, -2k, -4k, etc.), ne vous fiez pas au paramètre size, voir les règles complètes dans Modèles de génération d’images et de vidéos ;
Pour les scénarios de traitement par lot, privilégiez le niveau -fast, puis passez au niveau standard pour le raffinage après validation du prompt ;
Les modèles 4K sont plus chers et plus lents à générer ; utilisez-les uniquement à l’étape du produit final.

Traitement des résultats

Les URL des images retournées ont une durée de vie limitée ; transférez-les immédiatement vers votre propre stockage objet, ne faites pas de hotlink ;
Lors d’un retour en base64, faites attention à la taille importante du corps de réponse ; augmentez les limites de body du proxy inverse et de la passerelle ;
Facturation à l’usage : une réussite = un débit, un échec (erreur en amont / timeout) = pas de facturation.

Contrôle des coûts

Commencez par de petits lots pour calibrer le modèle de prompt, puis augmentez le volume une fois la stabilité obtenue ;
Créez un jeton API distinct pour les services d’images et définissez un plafond de quota afin d’éviter qu’un bug de programme ne fasse exploser le budget ;
Chaque débit peut être vérifié dans l’onglet “日志” du panneau de contrôle, ou rapproché à l’aide de l’API de requête des journaux.