Réponse rapide
- Prend en charge la génération d'images par prompt avec plusieurs ratios d'image.
- Prend en charge des images de référence dans reference_images pour renforcer la cohérence de style.
- Les variantes officielles offrent davantage de contrôles de génération pour le réglage en production.
Paramètres clés
- model | string | requis | gemini-3-pro-image-official | - | Identifiant exact du modèle d'image fourni par ToAPIs.
- prompt | string | requis | - | - | Texte descriptif de l'image.
- size | string | facultatif | 1:1 | 1:1 | 16:9 | 9:16 | 4:3 | 3:4 | 21:9 | Ratio d'image de sortie.
- resolution | string | facultatif | 1K | 1K | 2K | 4K (selon les capacités du modèle) | Résolution de sortie ; les valeurs varient selon la version du modèle.
- reference_images | file[] | facultatif | - | max 14 | Tableau d'images de référence pour contrôler le style et la composition.
- temperature | number | facultatif | 0.8 | 0-2 | Température d'échantillonnage qui contrôle la diversité de génération.
- topP | number | facultatif | 0.95 | 0-1 | Seuil d'échantillonnage nucleus qui contrôle la plage de troncature des probabilités.
Erreurs courantes
- 400 invalid_request_error: déclencheur=Des champs du corps de la requête manquent ou leur type est invalide.; correctif=Validez les champs et valeurs model/prompt/size/resolution.; nouvelle tentative=Ne réessayez qu'après avoir corrigé les paramètres.
- 401 authentication_error: déclencheur=Clé d'API absente ou invalide.; correctif=Vérifiez l'en-tête Authorization et les autorisations de la clé.; nouvelle tentative=Réessayez après avoir corrigé l'authentification.
- 429 rate_limit_exceeded: déclencheur=La fréquence des requêtes, la concurrence ou le quota actuel déclenchent la limite du fournisseur.; correctif=Appliquez d'abord un backoff exponentiel, puis vérifiez le rythme des requêtes, la concurrence et l'utilisation du quota.; nouvelle tentative=Prévoyez 1s/2s/4s + jitter ; en cas de répétition, réduisez le rythme d'envoi.







