Hoppa till huvudinnehåll
Nano Banana Tasks API:s huvudfunktion är att genom att ange det uppdrag ID som genererats av Nano Banana Images API för att kontrollera statusen för det uppdraget. Detta dokument kommer att ge en detaljerad beskrivning av integrationen av Nano Banana Tasks API, vilket hjälper dig att enkelt integrera och fullt utnyttja den kraftfulla funktionaliteten hos detta API. Genom Nano Banana Tasks API kan du enkelt kontrollera statusen för uppdrag som utförts av Nano Banana Images API.

​
Exempel på begäran

Nano Banana Tasks API kan användas för att kontrollera resultaten från Nano Banana Images API. För information om hur man använder Nano Banana Images API, vänligen se dokumentationen Nano Banana Images API. Vi tar ett exempel med ett uppdrag ID som returnerats av Nano Banana Images API och visar hur man använder detta API. Anta att vi har ett uppdrag ID: 4d320ead-4af4-4a55-8f3e-f2afebdf4fd0, vi visar hur man gör detta genom att skicka in ett uppdrag ID.

​
Exempelbild på uppdrag

​
Ställa in begärningshuvuden och begärningskropp

Begärningshuvuden inkluderar:
  • accept: anger att JSON-formatet ska tas emot som svar, här anges application/json.
  • authorization: nyckeln för att anropa API:t, kan väljas direkt efter ansökan.
Begärningskropp inkluderar:
  • id: det uppladdade uppdrag ID:t.
  • action: hur uppdraget ska hanteras.
Inställningarna visas i bilden nedan:

​
Kodexempel

Det kan noteras att olika språkets kod redan har genererats automatiskt på höger sida, som visas i bilden:

Några kodexempel är som följer:

​
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)

​
Exempel på svar

När begäran lyckas kommer API:t att returnera detaljerad information om detta uppdrag. Till exempel: 
{
  "_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,
  "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"
      }
    ]
  }
}
Det returnerade resultatet innehåller flera fält, där request-fältet är begärningskroppen som skickades vid uppdragets start, medan response-fältet är svaret som returnerades efter att uppdraget slutfördes. Fälten beskrivs nedan.
  • id, ID:t för att generera detta uppdrag, används för att unikt identifiera detta genererade uppdrag.
  • request, begärningsinformationen för att kontrollera uppdraget.
  • response, svarsinformationen för att kontrollera uppdraget.

​
Batchfrågeoperationer

Detta är för att fråga detaljerna för flera uppdrag ID:n, till skillnad från ovanstående behöver action väljas som retrieve_batch. Begärningskropp inkluderar:
  • ids: en array av uppladdade uppdrag ID:n.
  • action: hur uppdraget ska hanteras.
Exemplet är som följer: 
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"
}'

​
Exempel på svar

När begäran lyckas kommer API:t att returnera detaljerad information om alla batchuppdrag. Till exempel: 
{
  "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,
      "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"
          }
        ]
      }
    }
  ],
  "count": 1
}
Det returnerade resultatet innehåller flera fält, där items innehåller detaljerad information om batchuppdragen, varje uppdrags specifika information är densamma som i det tidigare exemplet. Fälten beskrivs nedan.
  • items, all detaljerad information om batchuppdragen. Det är en array, där varje element i arrayen har samma format som det tidigare exemplet för att kontrollera ett enskilt uppdrag.
  • count, antalet batchfrågeuppdrag.

​
Felhantering

Vid anrop av API, om ett fel uppstår, kommer API att returnera motsvarande felkod och information. Till exempel:
  • 400 token_mismatched：Felaktig begäran, möjligtvis på grund av saknade eller ogiltiga parametrar.
  • 400 api_not_implemented：Felaktig begäran, möjligtvis på grund av saknade eller ogiltiga parametrar.
  • 401 invalid_token：Obehörig, ogiltig eller saknad auktoriseringstoken.
  • 429 too_many_requests：För många begärningar, du har överskridit hastighetsgränsen.
  • 500 api_error：Internt serverfel, något gick fel på servern.

​
Exempel på felrespons

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "hämtning misslyckades"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
Slutsats

Genom detta dokument har du fått en förståelse för hur man använder Nano Banana Tasks API för att hämta alla specifika detaljer om enskilda eller batchuppgifter. Vi hoppas att detta dokument kan hjälpa dig att bättre integrera och använda API:et. Om du har några frågor, tveka inte att kontakta vårt tekniska supportteam.