API Nano Banana 2.1

Référence complète de l’API pour les modèles de génération d’images à partir de texte et de retouche d’images Nano Banana 2.1.

Variantes du modèle

Cette API prend en charge deux variantes du modèle :

Comparaison rapide

Rapports d’aspect pris en charge

Les deux modèles prennent en charge 14 rapports d’aspect :

• 16:9, 9:16, 1:1, 3:2, 2:3, 3:4, 4:3, 5:4, 4:5, 21:9, 1:4, 4:1, 1:8, 8:1

Indiquez le rapport sous forme de valeurs numériques distinctes pour width et height ; par exemple, width: 16 et height: 9 sélectionnent 16:9. Ces valeurs décrivent un rapport, et non les dimensions de sortie en pixels.

Nano Banana 2.1 (Génération d’images à partir de texte)

Point de terminaison

POST /api/v1/image/task

Authentification

Authorization: Bearer YOUR_API_KEY

Paramètres de la requête

Obligatoires

Remarque : Le rapport width:height doit être l’un des suivants : 16:9, 9:16, 1:1, 3:2, 2:3, 3:4, 4:3, 5:4, 4:5, 21:9, 1:4, 4:1, 1:8, 8:1.

Facultatifs

Exemple de requête

javascriptCopier
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'nano-banana-2.1',
    prompt: 'A serene mountain landscape at sunset',
    width: 16,
    height: 9,
    resolution: '2k',
    enable_web_search: true,
    enable_image_search: false
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Nano Banana 2.1 Edit (Retouche d’images)

Point de terminaison

POST /api/v1/image/task

Paramètres de la requête

Obligatoires

Remarque : Le rapport width:height doit être l’un des 14 rapports pris en charge indiqués ci-dessus.

Facultatifs

Exemple de retouche d’une seule image

javascriptCopier
{
  model_name: 'nano-banana-2.1-edit',
  prompt: 'Change the sky to sunset colors',
  width: 16,
  height: 9,
  resolution: '2k',
  image_url_list: ['https://example.com/image.jpg'],
  enable_web_search: false,
  enable_image_search: true
}

Exemple de composition à partir de plusieurs images

javascriptCopier
{
  model_name: 'nano-banana-2.1-edit',
  prompt: 'Combine these images into a cohesive landscape',
  width: 16,
  height: 9,
  resolution: '2k',
  image_url_list: ['https://example.com/image1.jpg', 'https://example.com/image2.jpg', 'https://example.com/image3.jpg'],
  enable_web_search: false,
  enable_image_search: false
}

Remarque sur la facturation : Les images de référence sont facturées à l’image, dès la première. Chaque option de recherche activée entraîne des frais fixes distincts par génération, quel que soit le nombre d’images. Consultez la tarification actuelle pour connaître les tarifs.

Format de réponse

Réponse initiale

jsonCopier
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_status": "submitted"
  }
}

Réponse à une interrogation périodique

jsonCopier
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_status": "processing",
    "task_status_msg": null,
    "task_result": null
  }
}

Réponse en cas de réussite

jsonCopier
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "credit": 0.074,
      "images": [
        {
          "url": "https://example.com/generated-image.png"
        }
      ]
    }
  }
}

Valeurs de statut

• submitted : Tâche acceptée
• processing : Tâche en cours d’exécution
• succeed : Tâche terminée avec succès
• failed : Échec de la tâche

Bonnes pratiques

Conseils pour la génération d’images à partir de texte

1. Décrivez l’image : Incluez le sujet, l’éclairage et la composition dans le prompt.
2. Choisissez une résolution : Transmettez 1k, 2k ou 4k dans chaque requête.
3. Sélectionnez un rapport d’aspect : Transmettez les valeurs width et height correspondant à l’un des 14 rapports pris en charge.
4. Choisissez les options de recherche : Omettez un paramètre de recherche pour utiliser sa valeur par défaut false ; définissez-le sur true si nécessaire.

Conseils pour la retouche d’images

1. Fournissez des images de référence : Incluez entre une et 14 URL d’images accessibles dans image_url_list.
2. Décrivez la retouche : Indiquez dans le prompt ce qui doit être modifié ou conservé.
3. Sélectionnez les réglages de sortie : Fournissez les valeurs obligatoires resolution, width et height.
4. Choisissez les options de recherche : La recherche sur le Web et la recherche d’images peuvent être activées indépendamment.