Nano Banana 2.1
Nano Banana 2.1 asynchronous image generation and editing: 1-4 images per request, 1K/2K/4K output, auto or 14 aspect ratios, up to 14 reference images. The price shown is the 1K reservation; the final charge follows actual usage.
Prix
$0.029568/ appel
Endpoint
/images/tasks
Mode de livraison
Cycle de vie d'une tâche asynchrone
Disponibilité
Disponible
Documentation de l'API
Configurer et copier la requête
Choisissez les options que ce modèle accepte. Le code ci-dessous se met à jour selon vos choix.
https://www.aisplice.store/v1/images/tasksBearer API keyTâche asynchroneOptionsSeules les options publiées pour ce modèle sont affichées.
# Requires curl and jq
API_KEY="${API_KEY:-YOUR_API_KEY}"
# 1. Submit once
SUBMITTED=$(curl --fail-with-body -sS https://www.aisplice.store/v1/images/tasks \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: model-docs-$(date +%s)-$$" \\
-d '{
"model": "Nano Banana 2.1",
"prompt": "A cinematic scene with careful composition",
"size": "auto",
"resolution": "1K",
"n": 1
}')
TASK_ID=$(printf '%s' "$SUBMITTED" | jq -r '.task_id // .id // empty')
if [ -z "$TASK_ID" ]; then
printf '%s\n' "$SUBMITTED" >&2
exit 1
fi
echo "task_id=$TASK_ID"
# 2. Poll until terminal
while true; do
STATUS_JSON=$(curl --fail-with-body -sS \
"https://www.aisplice.store/v1/images/tasks/$TASK_ID" \
-H "Authorization: Bearer $API_KEY")
STATUS=$(printf '%s' "$STATUS_JSON" | jq -r '.status // empty' | tr '[:upper:]' '[:lower:]')
echo "status=$STATUS"
case "$STATUS" in
completed|succeeded|success) break ;;
failed|failure|cancelled|canceled)
printf '%s\n' "$STATUS_JSON" | jq .
exit 1
;;
esac
sleep 3
done
# 3. Fetch the final result
curl --fail-with-body -sS \
"https://www.aisplice.store/v1/images/tasks/$TASK_ID/content" \
-H "Authorization: Bearer $API_KEY" | jq .- 1Soumettre la tâche
- 2Interroger le statut
- 3Récupérer le contenu
Les URL de médias publiques sont recommandées en production. Envoyez d'abord le fichier local, puis placez public_url dans la requête du modèle. Évitez les gros corps en Base64.
Lire le guide d'envoiRéférence des paramètres
modelIdentifiant exact du modèle pour cette requête.
gemini-nano-banana-2.1promptInstruction décrivant le résultat souhaité.
sizeOutput aspect ratio. auto follows the reference image when one is given.
auto1:12:33:23:44:34:55:49:1616:921:91:44:11:88:1resolutionRésolution de sortie demandée.
1K2K4Kn1234imagesOptional reference images (URLs or data URIs), up to 14, 20 MB each.
Cycle de la réponse
Statut des tâches, états finaux et exemples de réponses de résultat.
Cycle de la réponse
Statut des tâches, états finaux et exemples de réponses de résultat.
{
"id": "task_xxx",
"task_id": "task_xxx",
"object": "image.task",
"model": "Nano Banana 2.1",
"status": "queued"
}{
"created": 1720000000,
"data": [
{
"url": "https://media.example/result.png"
}
]
}En attente
queued · submitted · in_progress · processing
Succès
completed · succeeded · success
Échec
failed · failure · cancelled · canceled
Erreurs et production
Règles de nouvelle tentative, idempotence et checklist minimale de production.
Erreurs et production
Règles de nouvelle tentative, idempotence et checklist minimale de production.
400 / 422Corrigez les champs de la requête ou l'option non prise en charge ; ne réessayez pas sans modification.
401Vérifiez que la clé API est présente, active et envoyée comme jeton Bearer.
402Le solde du compte est insuffisant.
409L'Idempotency-Key est en cours de traitement ou a été réutilisée avec un autre corps.
429Attendez le délai indiqué par Retry-After avant de réessayer.
5xxRéessayez avec un backoff exponentiel en conservant l'Idempotency-Key d'origine.
- Gardez les clés API sur votre serveur pour les applications mobiles et navigateur publiques.
- Définissez une Idempotency-Key unique pour chaque opération asynchrone facturable.
- Enregistrez task_id pour que l'interrogation puisse reprendre après un redémarrage.
- Utilisez un délai d'expiration pour chaque requête HTTP et indiquez l'ID de requête dans vos demandes au support.
- Lisez les métadonnées des modèles en direct au lieu de coder en dur les prix et les options prises en charge.
Prix et paliers
12 % d'économie par rapport au prix officielPrix par requête
$0.029568/ appel
$0.0336
Tarification par palier
Prix de base $0.029568
Tarification par palier — le prix final dépend des options demandées. Les paliers non listés sont facturés au prix de base.
- 16:9×1$0.029568
- 1:1×1$0.029568
- 1:4×1$0.029568
- 1:8×1$0.029568
- 21:9×1$0.029568
- 2:3×1$0.029568
- 3:2×1$0.029568
- 3:4×1$0.029568
- 4:1×1$0.029568
- 4:3×1$0.029568
- 4:5×1$0.029568
- 5:4×1$0.029568
- 8:1×1$0.029568
- 9:16×1$0.029568
- auto×1$0.029568
- 1k×1$0.029568
- 2k×1.5$0.044352
- 4k×3.375$0.099792
Le prix affiché ici est exactement celui qui vous est facturé — les appels échoués sont remboursés automatiquement.
Modèles similaires