Integracja i użycie API Nano Banana Tasks

Główną funkcją API Nano Banana Tasks jest umożliwienie zapytania o status wykonania zadania 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 zapytania o wyniki API Nano Banana Images. Aby dowiedzieć się, jak korzystać z API Nano Banana Images, zapoznaj się z dokumentem API Nano Banana Images. Posłużymy się przykładem identyfikatora zadania (ID) zwróconego przez usługę API Nano Banana Images, aby pokazać, 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 w formacie JSON, tutaj wpisujemy 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 przedstawione są 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,
  "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"
      }
    ]
  }
}

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.
created_at, czas utworzenia zadania, znacznik czasu Unix (sekundy, liczba zmiennoprzecinkowa).
started_at, czas rozpoczęcia wykonania zadania, znacznik czasu Unix (sekundy, liczba zmiennoprzecinkowa).
finished_at, czas zakończenia zadania, znacznik czasu Unix (sekundy, liczba zmiennoprzecinkowa). To pole nie jest zwracane, gdy zadanie nie jest zakończone.
elapsed, czas wykonania zadania, wyrażony w sekundach (liczba zmiennoprzecinkowa, z dokładnością do 3 miejsc po przecinku). To pole nie jest zwracane, gdy zadanie nie jest zakończone.

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 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 w partii. 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,
      "started_at": 1757183036.847,
      "finished_at": 1757183048.147,
      "elapsed": 11.3,
      "credential_id": "097b2987-62f4-4ac0-b0cc-aed41e372a07",
      "request": {
        "action": "generate",
        "prompt": "biały kot syjamski"
      },
      "trace_id": "7ba1f1e8-0ef8-450d-8bb2-b5c3bf1ea319",
      "type": "obrazy",
      "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": "biały kot syjamski",
            "image_url": "https://platform.cdn.acedata.cloud/nanobanana/7e7bd000-698a-4e14-bb2d-3db61237e4bb.png"
          }
        ]
      }
    }
  ],
  "count": 1
}

Wynik zawiera wiele pól, z których items zawiera szczegółowe informacje o zadaniach wsadowych, a szczegóły każdego zadania są takie same jak w powyższym formacie zwracania pojedynczego zadania.

items, wszystkie szczegółowe informacje o zadaniach wsadowych. Jest to tablica, a każdy element tablicy ma taki sam format jak wynik zapytania pojedynczego zadania.
count, liczba zadań w tym zapytaniu wsadowym.

Obsługa błędów

Podczas wywoływania API, jeśli wystąpi 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ń, przekroczono limit szybkości.
403 forbidden: Oryginalna polityka bezpieczeństwa dostawcy odrzuciła żądanie lub wygenerowany wynik; jeśli wszystkie wywołania generujące zostały odrzucone, zadanie jest zapisywane w stanie niepowodzenia, nie zawiera obrazów i nie jest obciążane. W przypadku żądań wielu obrazów pozostałe udane wywołania mogą nadal być zwracane i obciążane zgodnie z rzeczywistą liczbą.
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": "pobieranie nie powiodło się"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Wnioski

Dzięki temu dokumentowi zrozumieli Państwo, jak korzystać z API Nano Banana Tasks do zapytań o szczegółowe informacje o pojedynczych lub wsadowych zadaniach. Mamy nadzieję, że ten dokument pomoże Państwu lepiej zintegrować i korzystać z tego API. W razie jakichkolwiek pytań prosimy o kontakt z naszym zespołem wsparcia technicznego.

Getting Started

Czat AI

Obraz AI

Wideo AI

Audio AI

Sieć i dane

CAPTCHA

Tożsamość

Proxy

Advanced

Coding

Integracja i użycie API Nano Banana Tasks

Przykład żądania

Przykład zadania

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

Przykład kodu

CURL

Python

Przykład odpowiedzi

Operacje zbiorcze

Przykład odpowiedzi

Obsługa błędów

Przykład odpowiedzi błędu

Wnioski

​Przykład żądania

​Przykład zadania

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

​Przykład kodu

​CURL

​Python

​Przykład odpowiedzi

​Operacje zbiorcze

​Przykład odpowiedzi

​Obsługa błędów

​Przykład odpowiedzi błędu

​Wnioski

Przykład żądania

Przykład zadania

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

Przykład kodu

CURL

Python

Przykład odpowiedzi

Operacje zbiorcze

Przykład odpowiedzi

Obsługa błędów

Przykład odpowiedzi błędu

Wnioski