Intégration et utilisation de l'API Nano Banana Tasks

L’API Nano Banana Tasks a pour principale fonction de permettre la consultation de l’état d’exécution d’une tâche en entrant l’ID de tâche généré par l’API Nano Banana Images. Ce document détaillera les instructions d’intégration de l’API Nano Banana Tasks, vous aidant à intégrer facilement et à tirer pleinement parti de la puissance de cette API. Grâce à l’API Nano Banana Tasks, vous pouvez facilement interroger l’état d’exécution des tâches de l’API Nano Banana Images.

Exemple de requête

L’API Nano Banana Tasks peut être utilisée pour interroger les résultats de l’API Nano Banana Images. Pour savoir comment utiliser l’API Nano Banana Images, veuillez consulter la documentation API Nano Banana Images. Prenons un exemple avec un ID de tâche retourné par le service API Nano Banana Images. Supposons que nous ayons un ID de tâche : 4d320ead-4af4-4a55-8f3e-f2afebdf4fd0, nous allons maintenant démontrer comment procéder en passant cet ID de tâche.

Exemple d’image de tâche

Configuration des en-têtes de requête et du corps de la requête

En-têtes de requête comprennent :

accept : spécifie que la réponse doit être au format JSON, ici rempli avec application/json.
authorization : clé d’API pour appeler l’API, sélectionnable directement après demande.

Corps de la requête comprend :

id : ID de la tâche téléchargée.
action : méthode d’opération sur la tâche.

Configuration comme illustré ci-dessous :

Exemple de code

On peut constater que diverses langues de code ont déjà été générées automatiquement sur le côté droit, comme illustré :

Quelques exemples de code sont les suivants :

CURL

curl -X POST 'https://api.acedata.cloud/nano-banana/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "4d320ead-4af4-4a55-8f3e-f2afebdf4fd0",
  "action": "retrieve"
}'

Python

import requests

url = "https://api.acedata.cloud/nano-banana/tasks"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "id": "4d320ead-4af4-4a55-8f3e-f2afebdf4fd0",
    "action": "retrieve"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Exemple de réponse

Après une requête réussie, l’API renverra les détails de la tâche ici. Par exemple :

{
  "_id": "68bc7c3c550a4144a53d0e24",
  "id": "4d320ead-4af4-4a55-8f3e-f2afebdf4fd0",
  "api_id": "9d8a117e-31ca-4322-a0fd-1771296ec610",
  "application_id": "8afd681a-2a4e-4265-aecb-43970094c019",
  "created_at": 1757183036.787,
  "started_at": 1757183036.847,
  "finished_at": 1757183048.147,
  "elapsed": 11.3,
  "credential_id": "097b2987-62f4-4ac0-b0cc-aed41e372a07",
  "request": {
    "action": "generate",
    "prompt": "un chat siamois blanc"
  },
  "trace_id": "7ba1f1e8-0ef8-450d-8bb2-b5c3bf1ea319",
  "type": "images",
  "user_id": "b87f67c1-b04f-4332-99a1-7a5e651331c6",
  "response": {
    "success": true,
    "task_id": "4d320ead-4af4-4a55-8f3e-f2afebdf4fd0",
    "trace_id": "7ba1f1e8-0ef8-450d-8bb2-b5c3bf1ea319",
    "data": [
      {
        "prompt": "un chat siamois blanc",
        "image_url": "https://platform.cdn.acedata.cloud/nanobanana/7e7bd000-698a-4e14-bb2d-3db61237e4bb.png"
      }
    ]
  }
}

Le résultat de la réponse contient plusieurs champs, le champ request est le corps de la requête lors de l’initiation de la tâche, tandis que le champ response est le corps de la réponse retourné après l’achèvement de la tâche. Les champs sont décrits comme suit.

id, ID généré pour cette tâche, utilisé pour identifier de manière unique cette tâche générée.
request, informations de requête dans la tâche.
response, informations de retour dans la tâche.
created_at, date de création de la tâche, timestamp Unix (secondes, flottant).
started_at, date de début d’exécution de la tâche, timestamp Unix (secondes, flottant).
finished_at, date de fin de la tâche, timestamp Unix (secondes, flottant). Ce champ n’est pas retourné si la tâche n’est pas terminée.
elapsed, temps d’exécution de la tâche, en secondes (flottant, avec 3 décimales). Ce champ n’est pas retourné si la tâche n’est pas terminée.

Opération de requête en lot

Ceci concerne la consultation des détails de plusieurs ID de tâches, contrairement à ce qui précède, il est nécessaire de sélectionner l’action comme retrieve_batch. Corps de la requête comprend :

ids : tableau des ID de tâches téléchargés.
action : méthode d’opération sur la tâche.

Exemple ci-dessous :

curl -X POST 'https://api.acedata.cloud/nano-banana/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed","1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed"],
  "action": "retrieve_batch"
}'

Exemple de réponse

Après une requête réussie, l’API renverra les détails spécifiques de toutes les tâches en lot. Par exemple :

{
  "items": [
    {
      "_id": "68bc7c3c550a4144a53d0e24",
      "id": "4d320ead-4af4-4a55-8f3e-f2afebdf4fd0",
      "api_id": "9d8a117e-31ca-4322-a0fd-1771296ec610",
      "application_id": "8afd681a-2a4e-4265-aecb-43970094c019",
      "created_at": 1757183036.787,
      "started_at": 1757183036.847,
      "finished_at": 1757183048.147,
      "elapsed": 11.3,
      "credential_id": "097b2987-62f4-4ac0-b0cc-aed41e372a07",
      "request": {
        "action": "générer",
        "prompt": "un chat siamois blanc"
      },
      "trace_id": "7ba1f1e8-0ef8-450d-8bb2-b5c3bf1ea319",
      "type": "images",
      "user_id": "b87f67c1-b04f-4332-99a1-7a5e651331c6",
      "response": {
        "success": true,
        "task_id": "4d320ead-4af4-4a55-8f3e-f2afebdf4fd0",
        "trace_id": "7ba1f1e8-0ef8-450d-8bb2-b5c3bf1ea319",
        "data": [
          {
            "prompt": "un chat siamois blanc",
            "image_url": "https://platform.cdn.acedata.cloud/nanobanana/7e7bd000-698a-4e14-bb2d-3db61237e4bb.png"
          }
        ]
      }
    }
  ],
  "count": 1
}

Les résultats contiennent plusieurs champs, où items contient les détails spécifiques des tâches en lot, chaque tâche ayant des informations spécifiques identiques aux champs de la requête précédente pour une tâche unique.

items, tous les détails spécifiques des tâches en lot. C’est un tableau, chaque élément du tableau ayant le même format que le résultat de la requête d’une seule tâche ci-dessus.
count, le nombre de tâches dans cette requête en lot.

Gestion des erreurs

Lors de l’appel de l’API, si une erreur se produit, l’API renverra le code d’erreur et les informations correspondantes. Par exemple :

400 token_mismatched : Mauvaise requête, probablement en raison de paramètres manquants ou invalides.
400 api_not_implemented : Mauvaise requête, probablement en raison de paramètres manquants ou invalides.
401 invalid_token : Non autorisé, jeton d’autorisation invalide ou manquant.
429 too_many_requests : Trop de requêtes, vous avez dépassé la limite de taux.
403 forbidden : La politique de sécurité native du fournisseur a refusé la demande ou la génération de résultats ; si tous les appels de génération sont refusés, la tâche est enregistrée dans un état d’échec, sans image et sans facturation. Dans une demande de plusieurs images, les autres appels réussis peuvent toujours être retournés et facturés selon le nombre réel.
500 api_error : Erreur interne du serveur, quelque chose s’est mal passé sur le serveur.

Exemple de réponse d’erreur

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "échec de la récupération"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Conclusion

Grâce à ce document, vous avez compris comment utiliser l’API Nano Banana Tasks pour interroger tous les détails spécifiques d’une tâche unique ou en lot. Nous espérons que ce document vous aidera à mieux intégrer et utiliser cette API. Si vous avez des questions, n’hésitez pas à contacter notre équipe de support technique.

Démarrage

Chat IA

Image IA

Vidéo IA

Audio IA

Web & Données

CAPTCHA

Identité

Proxy

Avancé

Coding

Intégration et utilisation de l'API Nano Banana Tasks

Exemple de requête

Exemple d’image de tâche

Configuration des en-têtes de requête et du corps de la requête

Exemple de code

CURL

Python

Exemple de réponse

Opération de requête en lot

Exemple de réponse

Gestion des erreurs

Exemple de réponse d’erreur

Conclusion

​Exemple de requête

​Exemple d’image de tâche

​Configuration des en-têtes de requête et du corps de la requête

​Exemple de code

​CURL

​Python

​Exemple de réponse

​Opération de requête en lot

​Exemple de réponse

​Gestion des erreurs

​Exemple de réponse d’erreur

​Conclusion

Exemple de requête

Exemple d’image de tâche

Configuration des en-têtes de requête et du corps de la requête

Exemple de code

CURL

Python

Exemple de réponse

Opération de requête en lot

Exemple de réponse

Gestion des erreurs

Exemple de réponse d’erreur

Conclusion