Google · API média

API Nano Banana 2

Nano Banana 2 est la route d'image rapide Gemini 3.1 Flash de Google sur OmniaKey : génération à partir de texte et retouche par référence à faible prix par appel.

Obtenez votre clé API Lire la documentation

IDs de modèle disponibles: gemini-3.1-flash-imagegemini-3.1-flash-image-previewLes deux IDs appellent le même produit avec les mêmes capacités et le même tarif. Vous pouvez utiliser l'un ou l'autre.
Fournisseur: Google
Modalité: Image IA
Par appel réussi: $0,068
Dernière vérification: 2026-09-11

Quand l'utiliser

Recourez à Nano Banana 2 pour une génération d'images Gemini rapide et économique dans un produit ou un agent, et montez à Nano Banana Pro quand une retouche demande plus de raisonnement.

Ce qu'il fait

Texte en image

gemini-3.1-flash-image

Transforme un texte en une nouvelle image.

Modification d'image

gemini-3.1-flash-image

Modifie une image existante à partir d'un texte et d'une référence.

Comment l'appeler

Les modèles média sont asynchrones : créez une tâche, interrogez-la jusqu'à la fin, puis téléchargez l'URL signée du résultat.

Créer, interroger, télécharger

# 1. Create the job. 202 Accepted; the body carries the task id,
#    the pre-charged price, and a poll_url. Reuse one Idempotency-Key
#    across retries so a timeout never starts a second paid job.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: gemini-3.1-flash-image-001" \
  -d '{
    "model": "gemini-3.1-flash-image",
    "type": "image",
    "operation": "generate",
    "input": {"prompt": "a paper boat on a quiet lake at sunset"},
    "parameters": {"aspect_ratio": "1:1"}
  }'

# 2. Poll GET /v1/media/tasks/{id} until status is
#    succeeded | failed | canceled. Progress carries percent and stage.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks/TASK_ID \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"

# 3. Download assets[0].url before expires_at, or poll again for a
#    fresh signed URL. Failed and canceled jobs are refunded.
curl -sS -o out.png "$(jq -r '.assets[0].url' result.json)"

Tarif

Les tâches d'image sont facturées par appel réussi, pas au token. Les tâches échouées ou annulées sont remboursées automatiquement.

Par appel réussi

$0,068par appel

Autres modèles d'image Google

Nano Banana 2 Lite

gemini-3.1-flash-lite-image

Nano Banana

gemini-2.5-flash-image

Nano Banana Pro

gemini-3-pro-image

Questions fréquemment posées

Comment appeler Nano Banana 2 sur OmniaKey ?

Envoyez un POST à /v1/media/tasks avec l'id du modèle, type "image" et operation "generate" ou "edit". Réutilisez la même Idempotency-Key lors des reprises pour qu'un délai dépassé ne lance jamais une seconde tâche facturée.

Combien coûte Nano Banana 2 ?

Nano Banana 2 est facturé $0,068 par appel. La création pré-débite ce montant de votre solde prépayé, et les tâches échouées ou annulées sont remboursées automatiquement.

Pourquoi l'API renvoie-t-elle un id de tâche plutôt que l'image ?

La latence des fournisseurs va de quelques secondes à environ une minute ; OmniaKey normalise donc toutes les routes d'image dans un même cycle asynchrone. Interrogez GET /v1/media/tasks/{id} jusqu'au statut succeeded, puis lisez l'URL signée du résultat.