Nano Banana Tasks API:s integration och användning

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 funktionen 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-tjänsten, och visar hur man använder detta API. Anta att vi har ett uppdrag ID: 4d320ead-4af4-4a55-8f3e-f2afebdf4fd0, och 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 man tar emot svar i JSON-format, här anges som application/json.
authorization: nyckeln för att anropa API:t, som 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ögra sidan, 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

Vid en lyckad begäran 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,
  "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"
      }
    ]
  }
}

Det returnerade resultatet innehåller flera fält, där request-fältet är begärningskroppen vid uppdragets start, medan response-fältet är svaret som returneras efter att uppdraget har slutförts. 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 i uppdraget.
response, returinformationen i uppdraget.
created_at, tidpunkten då uppdraget skapades, Unix-tidsstämpel (sekunder, flyttal).
started_at, tidpunkten då uppdraget började utföras, Unix-tidsstämpel (sekunder, flyttal).
finished_at, tidpunkten då uppdraget slutfördes, Unix-tidsstämpel (sekunder, flyttal). Detta fält returneras inte om uppdraget inte är slutfört.
elapsed, den tid som uppdraget tog att utföra, i sekunder (flyttal, med 3 decimaler). Detta fält returneras inte om uppdraget inte är slutfört.

Batchfrågeoperationer

Detta är för att fråga detaljer om flera uppdrag ID:n, och till skillnad från ovan 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

Vid en lyckad begäran 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,
      "started_at": 1757183036.847,
      "finished_at": 1757183048.147,
      "elapsed": 11.3,
      "credential_id": "097b2987-62f4-4ac0-b0cc-aed41e372a07",
      "request": {
        "action": "generate",
        "prompt": "en vit siamesisk katt"
      },
      "trace_id": "7ba1f1e8-0ef8-450d-8bb2-b5c3bf1ea319",
      "type": "bilder",
      "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": "en vit siamesisk katt",
            "image_url": "https://platform.cdn.acedata.cloud/nanobanana/7e7bd000-698a-4e14-bb2d-3db61237e4bb.png"
          }
        ]
      }
    }
  ],
  "count": 1
}

返回 resultatet innehåller flera fält, där items innehåller detaljerad information om batchuppgifter, varje uppgifts specifika information är densamma som ovanstående fält.

items, alla specifika detaljer om batchuppgifterna. Det är en array, där varje element i arrayen har samma format som resultatet av en enskild uppgiftsfråga.
count, antalet batchfrågeuppgifter här.

Felhantering

Vid anrop av API:et, om ett fel uppstår, kommer API:et 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: Obemyndigad, ogiltig eller saknad auktoriseringstoken.
429 too_many_requests: För många begärningar, du har överskridit hastighetsgränsen.
403 forbidden: Leverantörens inbyggda säkerhetspolicy avvisade begäran eller genererade resultat; om alla genereringsanrop avvisas, sparas uppgiften i ett misslyckat tillstånd, utan bilder och utan kostnad. I flerbildsanrop kan övriga lyckade anrop fortfarande returneras och debiteras enligt det faktiska antalet.
500 api_error: Intern serverfel, något gick fel på servern.

Felrespons exempel

{
  "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 du använder Nano Banana Tasks API för att fråga om detaljerad information 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.

Getting Started

AI Samtal

AI Bild

AI Video

AI Ljud

Web & Data

CAPTCHA

Identitet

Proxy

Advanced

Coding

Nano Banana Tasks API:s integration och användning

Exempel på begäran

Exempelbild på uppdrag

Ställa in begärningshuvuden och begärningskropp

Kodexempel

CURL

Python

Exempel på svar

Batchfrågeoperationer

Exempel på svar

Felhantering

Felrespons exempel

Slutsats

​Exempel på begäran

​Exempelbild på uppdrag

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

​Kodexempel

​CURL

​Python

​Exempel på svar

​Batchfrågeoperationer

​Exempel på svar

​Felhantering

​Felrespons exempel

​Slutsats

Exempel på begäran

Exempelbild på uppdrag

Ställa in begärningshuvuden och begärningskropp

Kodexempel

CURL

Python

Exempel på svar

Batchfrågeoperationer

Exempel på svar

Felhantering

Felrespons exempel

Slutsats