Passer au contenu

API Mage · Modèle d'image

API Nano Banana 2

Du texte net et lisible, jusqu'en 4K

POST https://api.mage.space/v1/nano_banana_v2/generate

En un coup d’œil

L'API Nano Banana 2 exécute Nano Banana 2.1 et une autre variante via Mage, à l'adresse POST https://api.mage.space/v1/nano_banana_v2/generate. Une requête avec les paramètres par défaut coûte 51 Gems (environ 0,051 $), sans abonnement. Nano Banana 2 accepte les personnages enregistrés et les références par @handle dans le prompt.

  • ImageSortie
  • 2Variantes
  • 51Gems par image, par défaut
  • $0.051Environ, en USD

Présentation

Ce que fait l'API Nano Banana 2

Les modèles d'images de Google pour créer des visuels et du contenu marketing avec du texte lisible. Nano Banana 2.1 est le fer de lance de la famille ; les deux modèles génèrent ou modifient des images à partir de 14 images de référence maximum, jusqu'en 4K. Le filtre de sécurité de Google s'applique.

Les modèles Nano Banana de Google, pour des visuels avec du texte lisible et des retouches à partir de 14 images de référence maximum, jusqu'en 4K. Nano Banana 2.1 (`nano-banana-v2.1`), le modèle par défaut, coûte moins cher ; Nano Banana 2 (`nano-banana-v2`) propose aussi un rendu en 512. Le filtre de sécurité de Google s'applique.

Il accepte image et additional_images en entrée.

Démarrage rapide

Appeler l'API Nano Banana 2

Définis MAGE_API_KEY, envoie ta requête à /nano_banana_v2/generate, puis interroge status_url jusqu'à ce que la requête soit terminée.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/nano_banana_v2/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "1:1",
  "model_id": "nano-banana-v2.1"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('nano_banana_v2', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '1:1',
  model_id: 'nano-banana-v2.1',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("nano_banana_v2", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "1:1",
    "model_id": "nano-banana-v2.1",
})

print(request["result"]["url"])

Modèles

Valeurs model_id de Nano Banana 2

Envoie model_id pour choisir une variante. Sans model_id, la requête utilise la variante par défaut.

model_idNomPar défaut
nano-banana-v2Nano Banana 2
nano-banana-v2.1Nano Banana 2.1Oui

Options

Paramètres de Nano Banana 2

Valeurs autorisées pour l'ensemble des variantes ; une variante peut en proposer moins. La documentation détaille les options de chaque variante.

ChampValeurs
aspect_ratio1:1, 3:2, 2:3, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9
resolution512, 1K, 2K, 4K

Entrées

Médias acceptés en entrée par Nano Banana 2

Envoie chacune sous forme d'URL https, d'URL de données ou de fichier importé jusqu'à 100 Mo.

ChampRôle
imageL'image de référence.
additional_imagesImages de référence supplémentaires.

Autres modèles d'image

Autres API de génération d'images sur Mage

FAQ

Questions fréquentes

Combien coûte l'API Nano Banana 2 ?
Une requête Nano Banana 2 avec les paramètres par défaut (Nano Banana 2.1) coûte 51 Gems, soit environ 0,051 $. Les autres résolutions, durées et variantes modifient le prix ; la réponse indique le montant exact débité. Une génération qui échoue est remboursée ; une génération bloquée par la politique de contenu de Mage ne l'est pas.
Quel est le point de terminaison de l'API Nano Banana 2 ?
POST https://api.mage.space/v1/nano_banana_v2/generate avec un en-tête Authorization: Bearer contenant ta clé API Mage. La réponse inclut un status_url à interroger pour obtenir le résultat.
Quels modèles Nano Banana 2 puis-je appeler ?
nano-banana-v2 (Nano Banana 2), nano-banana-v2.1 (Nano Banana 2.1). Le modèle par défaut est Nano Banana 2.1.
Nano Banana 2 prend-il en charge les images de référence ou les personnages ?
Nano Banana 2 accepte image et additional_images. Il gère aussi les personnages et les références enregistrés, via @handle dans le prompt.
Puis-je utiliser Nano Banana 2 depuis Claude ou ChatGPT ?
Oui. Connecte le serveur MCP de Mage à Claude, ChatGPT, Claude Code, Grok ou Cursor, et demande Nano Banana 2 par son nom. Ton assistant lit ses options avec get_model et annonce le prix avant de générer.
Combien de temps les résultats de Nano Banana 2 sont-ils conservés ?
Les résultats et les entrées sont conservés pendant 30 jours. Télécharge tout ce que tu veux garder sur ton propre stockage.

Lance-toi avec Mage

Un seul compte, un seul solde de Gems, tous les modèles. Ne paie que ce que tu génères.

CharactersCommunauté