Przejdź do głównej treści
Główną funkcją API Nano Banana Tasks jest możliwość sprawdzania statusu wykonania zadań poprzez wprowadzenie identyfikatora zadania (ID) wygenerowanego przez API Nano Banana Images. Dokument ten szczegółowo opisuje integrację z API Nano Banana Tasks, aby pomóc Ci łatwo zintegrować i w pełni wykorzystać potężne możliwości tego API. Dzięki API Nano Banana Tasks możesz łatwo sprawdzić status wykonania zadań w API Nano Banana Images.

​
Przykład żądania

API Nano Banana Tasks może być używane do sprawdzania wyników API Nano Banana Images. Aby dowiedzieć się, jak korzystać z API Nano Banana Images, zapoznaj się z dokumentem Nano Banana Images API. Weźmy jako przykład identyfikator zadania (ID) zwrócony przez usługę API Nano Banana Images i pokażmy, jak używać tego API. Załóżmy, że mamy identyfikator zadania: 4d320ead-4af4-4a55-8f3e-f2afebdf4fd0, a następnie pokażemy, jak to zrobić, przekazując identyfikator zadania.

​
Przykład zadania

​
Ustawienia nagłówków żądania i ciała żądania

Nagłówki żądania obejmują:
  • accept: określa, że oczekiwany jest wynik odpowiedzi w formacie JSON, tutaj wpisz application/json.
  • authorization: klucz do wywołania API, który można wybrać z rozwijanej listy po złożeniu wniosku.
Ciało żądania obejmuje:
  • id: przesłany identyfikator zadania.
  • action: sposób operacji na zadaniu.
Ustawienia są pokazane na poniższym obrazku:

​
Przykład kodu

Można zauważyć, że po prawej stronie strony automatycznie wygenerowano kod w różnych językach, jak pokazano na obrazku:

Przykłady kodu są następujące:

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

​
Przykład odpowiedzi

Po pomyślnym wykonaniu żądania API zwróci szczegółowe informacje o tym zadaniu. Na przykład: 
{
  "_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"
      }
    ]
  }
}
Zwracany wynik zawiera wiele pól, pole request to ciało żądania, które zostało wysłane podczas inicjowania zadania, a pole response to ciało odpowiedzi zwrócone po zakończeniu zadania. Opis pól jest następujący.
  • id, identyfikator wygenerowanego zadania, używany do unikalnej identyfikacji tego zadania.
  • request, informacje o żądaniu w zadaniu.
  • response, informacje o odpowiedzi w zadaniu.

​
Operacje zbiorcze

To jest zapytanie o szczegóły wielu identyfikatorów zadań, w przeciwieństwie do powyższego, należy wybrać akcję jako retrieve_batch. Ciało żądania obejmuje:
  • ids: tablica przesłanych identyfikatorów zadań.
  • action: sposób operacji na zadaniu.
Przykład jest następujący: 
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"
}'

​
Przykład odpowiedzi

Po pomyślnym wykonaniu żądania API zwróci szczegółowe informacje o wszystkich zadaniach zbiorczych. Na przykład: 
{
  "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
}
Zwracany wynik zawiera wiele pól, w tym items, które zawierają szczegółowe informacje o zadaniach zbiorczych, a szczegółowe informacje o każdym zadaniu są takie same jak w przypadku zapytania o pojedyncze zadanie. Informacje o polach są następujące.
  • items, wszystkie szczegółowe informacje o zadaniach zbiorczych. Jest to tablica, a każdy element tablicy ma taki sam format jak wynik zapytania o pojedyncze zadanie.
  • count, liczba zadań w tym zbiorczym zapytaniu.

​
Obsługa błędów

Podczas wywoływania API, jeśli napotkasz błąd, API zwróci odpowiedni kod błędu i informacje. Na przykład:
  • 400 token_mismatched：Złe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
  • 400 api_not_implemented：Złe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
  • 401 invalid_token：Nieautoryzowany, nieprawidłowy lub brakujący token autoryzacyjny.
  • 429 too_many_requests：Zbyt wiele żądań, przekroczyłeś limit szybkości.
  • 500 api_error：Błąd wewnętrzny serwera, coś poszło nie tak na serwerze.

​
Przykład odpowiedzi błędu

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

​
Wnioski

Dzięki temu dokumentowi zrozumiałeś, jak korzystać z API Nano Banana Tasks do zapytań o szczegółowe informacje dotyczące pojedynczych lub zbiorczych zadań. Mamy nadzieję, że ten dokument pomoże Ci lepiej zintegrować i korzystać z tego API. W razie jakichkolwiek pytań, skontaktuj się z naszym zespołem wsparcia technicznego.