Nano Banana
Nano Banana (Gemini 2.5 Flash Image) asynchronous image generation and editing with up to 14 reference images.
Prix
$0.008/ 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",
"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-2.5-flash-image-previewpromptInstruction décrivant le résultat souhaité.
sizeFormat ou dimensions de sortie.
auto1:12:33:23:44:34:55:49:1616:921:9resolutionRésolution de sortie demandée.
1KnimagesOptional reference images, up to 14.
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",
"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
79 % d'économie par rapport au prix officielPrix par requête
$0.008/ appel
$0.039
Tarification par palier
Prix de base $0.008
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.008
- 1:1×1$0.008
- 21:9×1$0.008
- 2:3×1$0.008
- 3:2×1$0.008
- 3:4×1$0.008
- 4:3×1$0.008
- 4:5×1$0.008
- 5:4×1$0.008
- 9:16×1$0.008
- auto×1$0.008
- 1k×1$0.008
Le prix affiché ici est exactement celui qui vous est facturé — les appels échoués sont remboursés automatiquement.
Modèles similaires