Référence développeur Nano Banana Pro API

Guide complet pour développeurs de la plateforme Nano Banana Pro API, alimentée par des technologies avancées d'apprentissage automatique

Voir les tarifsDécouvrez les plans d'abonnement de Nano Banana Pro API

Aperçu de Nano Banana Pro API

Le service Visual Production de Nano Banana Pro API permet aux développeurs de se connecter à des moteurs d'apprentissage automatique avancés pour produire des images de haute qualité à partir de textes d'invite et de photos de référence. Notre solution propose une interface REST simple, une gestion complète des tâches et des notifications en temps réel.

Principales fonctionnalités de Nano Banana Pro API

  • Conversion texte-en-image via des moteurs d'apprentissage automatique de pointe
  • Support d'images de référence (jusqu'à 4 images)
  • Traitement asynchrone des tâches avec suivi de progression en temps réel
  • Notifications via webhook pour les changements d'état immédiats
  • Interface REST renvoyant des données JSON structurées
  • Mécanisme d'authentification par token Bearer

overview.base_url

https://api.defapi.org

overview.api_version

v1.0.0

Démarrage rapide de Nano Banana Pro API

  1. 1. Créez un compte Nano Banana Pro API et obtenez vos identifiants sur notre site officiel
  2. 2. Ajoutez votre token d'authentification Nano Banana Pro API dans l'en-tête Authorization
  3. 3. Envoyez une requête POST au endpoint de génération d'images de Nano Banana Pro API
  4. 4. Utilisez l'ID de tâche renvoyé par Nano Banana Pro API pour vérifier l'état du traitement
  5. 5. Récupérez vos images générées par Nano Banana Pro API une fois le traitement terminé

Authentification d'accès

Toutes les requêtes API doivent inclure une authentification valide via un jeton Bearer. Incluez votre clé API dans l'en-tête Authorization pour chaque requête.

Méthode d'authentification

Utilisez l'authentification par jeton Bearer HTTP en incluant vos identifiants API dans l'en-tête Authorization :

Authorization: Bearer <your-api-key>

Exemple de clé API

Authorization: Bearer dk-1234567890abcdef

Exemple de requête

curl -X POST "https://api.defapi.org/api/image/gen" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key-here" \
  -d '{
    "model": "google/gempix2",
    "prompt": "A beautiful landscape"
  }'

Authentification valide

  • Les identifiants API n'ont pas expiré
  • Le compte est en règle
  • Solde du compte suffisant

Problèmes courants

  • Identifiants API manquants dans la requête
  • Clé API invalide ou mal formatée
  • Compte désactivé ou accès au compte révoqué

Génération d'images - Nano Banana Pro API

Créez des images avec l'API Nano Banana Pro utilisant des technologies d'apprentissage automatique avancées. Utilisez des prompts textuels et des images de référence.

Point de terminaison API

POST /api/image/gen

Paramètres de la requête

ParameterTypeRequiredDescription
modelstringYesModel identifier (e.g., "google/gempix2")
promptstringYesText prompt describing the image
imagesarrayNoReference image URLs (max 4)
callback_urlstringNoWebhook URL for completion notifications

Exemples d'utilisation

Création d'image basique avec l'API Nano Banana Pro

{
  "model": "google/gempix2",
  "prompt": "A beautiful girl dancing in a garden"
}

Génération basée sur références avec images d'exemple - API Nano Banana Pro

{
  "model": "google/gempix2",
  "prompt": "Put them in a basket",
  "images": [
    "https://cdn.openai.com/API/docs/images/body-lotion.png",
    "https://cdn.openai.com/API/docs/images/soap.png"
  ],
  "callback_url": "https://example.com/webhook/image-callback"
}

Format de réponse

{
  "code": 0,
  "message": "ok",
  "data": {
    "task_id": "ta12345678-1234-1234-1234-123456789abc"
  }
}

Gestion des erreurs

400 - Bad Request

{"code": 1, "message": "failed", "detail": "prompt is required"}

401 - Unauthorized

{"code": 1, "message": "Invalid API key"}

Statut des tâches de l'API Nano Banana Pro

Consulter le statut et les résultats des tâches de génération d'images de l'API Nano Banana Pro. Utilisez l'ID de tâche renvoyé par l'endpoint de génération d'images.

Point de terminaison de l'API

GET /api/task/query?task_id=<task_id>

Paramètres de requête

ParameterTypeRequiredDescription
task_idstringYesUnique task identifier returned from generation endpoint

Exemple de requête

curl -X GET "https://api.defapi.org/api/task/query?task_id=ta823dfb-eaac-44fd-aec2-3e2c7ba8e071" \
  -H "Authorization: Bearer your-api-key-here"

Types de statut des tâches de l'API Nano Banana Pro

pending - La tâche de l'API Nano Banana Pro a été créée et attend le début du traitement
submitted - La tâche de l'API Nano Banana Pro a été mise en file d'attente pour traitement
in_progress - La tâche de l'API Nano Banana Pro est en cours de traitement
success - La tâche de l'API Nano Banana Pro s'est terminée avec succès et les images générées sont prêtes
failed - La tâche de l'API Nano Banana Pro a rencontré une erreur et n'a pas pu être terminée

Réponses d'erreur

404 - Task Not Found

{"code": 1, "message": "task not found"}

401 - Unauthorized

{"code": 401, "message": "Invalid API key"}

Structures de données de l'API Nano Banana Pro

Référence complète des formats de données et schémas utilisés dans les requêtes et réponses de l'API Nano Banana Pro.

ImageGenResult

Represents a generated image result.

{
  "image": "https://google.datas.systems/fileSystem/response_images/287/2025/08/29/1756432513771985292_2989.png"
}
FieldTypeDescription
imagestringImage URL or base64 data URI

CallbackPayload

Payload sent to the callback_url when task status changes to final states.

{
  "result": [
    {
      "image": "https://google.datas.systems/fileSystem/response_images/287/2025/08/29/1756432513771985292_2989.png"
    }
  ],
  "status": "success",
  "task_id": "ta5c9705-b8ae-4cb9-aa6f-97c4fee88c8d",
  "consumed": "0.500000",
  "status_reason": {
    "message": null
  }
}
FieldTypeDescription
resultarrayArray of ImageGenResult objects (null if failed)
statusstringFinal task status (success/failed)
task_idstringUnique task identifier
consumedstringCredits consumed by the task
status_reasonobjectStatus details including error message if failed

Modèles pris en charge par l'API Nano Banana Pro

google/gempix2Nano Banana image generation model
google/gemini-2.5-flash-imageGemini 2.5 Flash image model

Gestion des erreurs

Guide complet pour gérer les erreurs et interpréter les codes de réponse API. Tous les messages d'erreur suivent un format cohérent pour faciliter le dépannage.

Codes d'état HTTP

200

OK

Request was successful

400

Bad Request

Invalid request parameters or malformed JSON

401

Unauthorized

Invalid, missing, or expired API key

404

Not Found

Task not found or endpoint doesn't exist

500

Internal Server Error

Server-side error occurred

Bonnes pratiques de gestion des erreurs

  1. Toujours vérifier les codes d'état HTTP avant de traiter la réponse
  2. Mettre en place un backoff exponentiel pour les réessais en cas d'erreurs 500
  3. Consigner les messages d'erreur avec le contexte complet pour le débogage
  4. Valider les paramètres d'entrée avant d'envoyer les requêtes pour éviter les erreurs 400
  5. Résoudre les problèmes d'authentification en demandant aux clients de rafraîchir leurs identifiants API
  6. Surveiller l'avancement des tâches à intervalles raisonnables au lieu de sonder sans cesse
  7. Utiliser des webhooks quand c'est possible pour éviter de sonder en permanence l'état d'achèvement

Exemple de gestion des erreurs (JavaScript)

async function generateImage(prompt, apiKey) {
  try {
    const response = await fetch('https://api.defapi.org/api/image/gen', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${apiKey}`
      },
      body: JSON.stringify({
        model: 'google/gempix2',
        prompt: prompt
      })
    });

    if (!response.ok) {
      const errorData = await response.json();
      throw new Error(`API Error ${response.status}: ${errorData.message}`);
    }

    const data = await response.json();
    return data.data.task_id;

  } catch (error) {
    console.error('Image generation failed:', error.message);
    throw error;
  }
}