> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Integracja i użycie API Nano Banana Tasks
> Nano Banana Image Generation 集成指南 - XHuoAPI
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](https://api.xhuoapi.ai/documents/63e01dc3-eb21-499e-8049-3025c460058f).
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
```bash theme={null}
curl -X POST 'https://api.xhuoapi.ai/v1/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
```python theme={null}
import requests
url = "https://api.xhuoapi.ai/v1/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:
```json theme={null}
{
"_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.xhuoapi.ai/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:
```bash theme={null}
curl -X POST 'https://api.xhuoapi.ai/v1/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:
```json theme={null}
{
"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.xhuoapi.ai/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
```json theme={null}
{
"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.