> ## 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.

# Nano Banana Tasks API:s integration och användning

> Nano Banana Image Generation 集成指南 - XHuoAPI

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](https://api.xhuoapi.ai/documents/63e01dc3-eb21-499e-8049-3025c460058f).

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

<p>
  <img src="https://cdn.xhuoapi.ai/nuiuth.png" width="500" className="m-auto" />
</p>

### 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:

<p>
  <img src="https://cdn.xhuoapi.ai/nuiuth.png" width="500" className="m-auto" />
</p>

### Kodexempel

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

<p>
  <img src="https://cdn.xhuoapi.ai/r1u4vl.png" width="500" className="m-auto" />
</p>

Några kodexempel är som följer:

#### 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)
```

### Exempel på svar

När begäran lyckas kommer API:t att returnera detaljerad information om detta uppdrag. Till exempel:

```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"
      }
    ]
  }
}
```

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:

```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"
}'
```

### Exempel på svar

När begäran lyckas kommer API:t att returnera detaljerad information om alla batchuppdrag. Till exempel:

```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
}
```

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

```json theme={null}
{
  "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.