Integrazione e utilizzo dell'API Nano Banana Tasks

La principale funzionalità dell’API Nano Banana Tasks è quella di interrogare lo stato di esecuzione di un’attività fornendo l’ID dell’attività generato dall’API Nano Banana Images. Questo documento fornirà una guida dettagliata per l’integrazione dell’API Nano Banana Tasks, aiutandoti a integrare facilmente e sfruttare appieno le potenti funzionalità di questa API. Con l’API Nano Banana Tasks, puoi facilmente interrogare lo stato di esecuzione delle attività dell’API Nano Banana Images.

Esempio di richiesta

L’API Nano Banana Tasks può essere utilizzata per interrogare i risultati dell’API Nano Banana Images. Per informazioni su come utilizzare l’API Nano Banana Images, fare riferimento al documento Nano Banana Images API. Prendiamo come esempio un ID attività restituito dal servizio API Nano Banana Images e dimostriamo come utilizzare questa API. Supponiamo di avere un ID attività: 4d320ead-4af4-4a55-8f3e-f2afebdf4fd0, e ora dimostriamo come passare un ID attività.

Esempio di immagine dell’attività

Impostazione dell’intestazione della richiesta e del corpo della richiesta

Request Headers includono:

accept: specifica di ricevere la risposta in formato JSON, qui si compila con application/json.
authorization: la chiave per chiamare l’API, selezionabile direttamente dopo la richiesta.

Request Body include:

id: l’ID dell’attività caricata.
action: il modo di operare sull’attività.

Impostare come mostrato nell’immagine seguente:

Esempio di codice

Si può notare che, sul lato destro della pagina, sono stati generati automaticamente vari codici in diverse lingue, come mostrato nell’immagine:

Alcuni esempi di codice sono i seguenti:

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)

Esempio di risposta

Dopo una richiesta riuscita, l’API restituirà i dettagli dell’attività in questione. Ad esempio:

{
  "_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": "a white siamese cat"
  },
  "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": "a white siamese cat",
        "image_url": "https://platform.cdn.acedata.cloud/nanobanana/7e7bd000-698a-4e14-bb2d-3db61237e4bb.png"
      }
    ]
  }
}

Il risultato restituito contiene diversi campi, il campo request è il corpo della richiesta al momento dell’avvio dell’attività, mentre il campo response è il corpo della risposta restituito al termine dell’attività. La descrizione dei campi è la seguente.

id, l’ID generato per questa attività, utilizzato per identificare univocamente l’attività generata.
request, informazioni sulla richiesta nell’attività.
response, informazioni sulla risposta nell’attività.
created_at, data di creazione dell’attività, timestamp Unix (secondi, float).
started_at, data di inizio esecuzione dell’attività, timestamp Unix (secondi, float).
finished_at, data di completamento dell’attività, timestamp Unix (secondi, float). Questo campo non viene restituito se l’attività non è completata.
elapsed, tempo di esecuzione dell’attività, in secondi (float, con 3 cifre decimali). Questo campo non viene restituito se l’attività non è completata.

Operazione di query in batch

Questa è per interrogare i dettagli di più ID attività, a differenza di quanto sopra, è necessario selezionare l’azione come retrieve_batch. Request Body include:

ids: array degli ID delle attività caricate.
action: il modo di operare sull’attività.

Esempio:

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"
}'

Esempio di risposta

Dopo una richiesta riuscita, l’API restituirà i dettagli specifici di tutte le attività in batch. Ad esempio:

{
  "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": "generate",
        "prompt": "un gatto siamese bianco"
      },
      "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 gatto siamese bianco",
            "image_url": "https://platform.cdn.acedata.cloud/nanobanana/7e7bd000-698a-4e14-bb2d-3db61237e4bb.png"
          }
        ]
      }
    }
  ],
  "count": 1
}

Gestione degli errori Durante la chiamata all’API, se si verifica un errore, l’API restituirà il relativo codice di errore e le informazioni. Ad esempio:

400 token_mismatched: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
400 api_not_implemented: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
401 invalid_token: Non autorizzato, token di autorizzazione non valido o mancante.
429 too_many_requests: Troppe richieste, hai superato il limite di frequenza.
403 forbidden: La politica di sicurezza nativa del fornitore ha rifiutato la richiesta o la generazione del risultato; se tutte le chiamate di generazione vengono rifiutate, il compito viene salvato in stato di fallimento, senza immagini e senza addebito. Nelle richieste di immagini multiple, le altre chiamate riuscite possono comunque restituire e addebitare in base al numero effettivo.
500 api_error: Errore interno del server, qualcosa è andato storto sul server.

Esempio di risposta di errore

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Conclusione

Attraverso questo documento, hai compreso come utilizzare l’API Nano Banana Tasks per interrogare i dettagli specifici di singoli o batch di compiti. Speriamo che questo documento possa aiutarti a integrare e utilizzare meglio questa API. Se hai domande, non esitare a contattare il nostro team di supporto tecnico.

Inizia

Chat AI

Immagine AI

Video AI

Audio AI

Web e Dati

CAPTCHA

Identità

Proxy

Avanzato

Coding

Integrazione e utilizzo dell'API Nano Banana Tasks

Esempio di richiesta

Esempio di immagine dell’attività

Impostazione dell’intestazione della richiesta e del corpo della richiesta

Esempio di codice

CURL

Python

Esempio di risposta

Operazione di query in batch

Esempio di risposta

Esempio di risposta di errore

Conclusione

​Esempio di richiesta

​Esempio di immagine dell’attività

​Impostazione dell’intestazione della richiesta e del corpo della richiesta

​Esempio di codice

​CURL

​Python

​Esempio di risposta

​Operazione di query in batch

​Esempio di risposta

​Esempio di risposta di errore

​Conclusione

Esempio di richiesta

Esempio di immagine dell’attività

Impostazione dell’intestazione della richiesta e del corpo della richiesta

Esempio di codice

CURL

Python

Esempio di risposta

Operazione di query in batch

Esempio di risposta

Esempio di risposta di errore

Conclusione