Réponse rapide
- Le point d'entrée est POST /v1/images/generations ; soumettez la tâche d'image avec l'identifiant de modèle Nano Banana 2 indiqué dans la documentation.
- Prend en charge le texte en image par prompt et la génération guidée par images de référence dans reference_images, adapté à la publicité, au e-commerce, aux réseaux sociaux et aux créations par lots.
- Le flux est asynchrone : soumettez la tâche, recevez un id de tâche, puis interrogez le résultat via l'endpoint de statut de la tâche d'image.
- Les prix officiels de référence sont d'environ $0.067 / $0.101 / $0.151 par image en 1K / 2K / 4K ; ToAPIs affiche actuellement $0.030 / $0.040 / $0.060 par image sur la page comparative, la facturation finale dépendant du tarif de votre compte.
- Au tarif 1K ToAPIs de $0.030 par image, une recharge de $10 correspond à environ 333 images 1K supplémentaires ; au tarif 4K de $0.060 par image, à environ 166 images 4K.
Paramètres clés
- model | string | requis | nano_banana_2 | - | Utilisez l'identifiant de modèle Nano Banana 2 indiqué dans la documentation ou la grille tarifaire ToAPIs.
- prompt | string | requis | - | - | Prompt principal de génération d'images.
- size | string | facultatif | 1:1 | 1:1 | 16:9 | 9:16 | 4:3 | 3:4 | Ratio d'image de sortie ; les valeurs disponibles dépendent de la documentation et des capacités du modèle.
- resolution | string | facultatif | 1K | 1K | 2K | 4K | Niveau de résolution de sortie ; influence le prix par image et le coût de génération.
- reference_images | string[] | facultatif | - | Tableau d'URL | Tableau d'URL d'images de référence pour la génération guidée et le contrôle du style ou du sujet.
- response_format | string | facultatif | url | url | b64_json | Format du résultat ; l'URL est recommandée pour la plupart des workflows.
Erreurs courantes
- 400 invalid_request_error: déclencheur=model/prompt manquant, ou les champs de résolution, de ratio d'image ou d'images de référence ne respectent pas la documentation.; correctif=Validez model, prompt, size, resolution et reference_images d'après la documentation ToAPIs.; nouvelle tentative=Ne réessayez qu'après avoir corrigé les paramètres ; les tentatives à l'aveugle sont déconseillées.
- 401 authentication_error: déclencheur=En-tête Authorization absent ou clé d'API invalide.; correctif=Vérifiez le format du token Bearer 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 les crédits actuels atteignent la limite.; correctif=Appliquez un backoff exponentiel, réduisez la concurrence et vérifiez les crédits du compte.; nouvelle tentative=Prévoyez un backoff 1s/2s/4s avec du jitter ; en cas de répétition, mettez les requêtes en file d'attente.










