> ## 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.
# Integrazione e utilizzo dell'API Nano Banana Tasks
> Nano Banana Image Generation 集成指南 - XHuoAPI
La principale funzionalità dell'API Nano Banana Tasks è quella di interrogare lo stato di esecuzione di un'attività fornendo l'ID dell'attività generato dall'API Nano Banana Images.
Questo documento fornirà una guida dettagliata per l'integrazione dell'API Nano Banana Tasks, aiutandoti a integrare facilmente e sfruttare appieno le potenti funzionalità di questa API. Con l'API Nano Banana Tasks, puoi facilmente interrogare lo stato di esecuzione delle attività dell'API Nano Banana Images.
## Esempio di richiesta
L'API Nano Banana Tasks può essere utilizzata per interrogare i risultati dell'API Nano Banana Images. Per informazioni su come utilizzare l'API Nano Banana Images, fare riferimento al documento [Nano Banana Images API](https://api.xhuoapi.ai/documents/63e01dc3-eb21-499e-8049-3025c460058f).
Prendiamo come esempio un ID attività restituito dal servizio API Nano Banana Images e dimostriamo come utilizzare questa API. Supponiamo di avere un ID attività: 4d320ead-4af4-4a55-8f3e-f2afebdf4fd0, e ora dimostriamo come passare un ID attività.
### Esempio di attività
### Impostazione dell'intestazione della richiesta e del corpo della richiesta
**Request Headers** includono:
* `accept`: specifica di ricevere la risposta in formato JSON, qui si compila con `application/json`.
* `authorization`: la chiave per chiamare l'API, selezionabile direttamente dopo la richiesta.
**Request Body** include:
* `id`: l'ID dell'attività caricata.
* `action`: il modo di operare sull'attività.
Impostare come mostrato nell'immagine seguente:
### Esempio di codice
Si può notare che sul lato destro della pagina sono stati generati automaticamente vari codici in diverse lingue, come mostrato nell'immagine:
Alcuni esempi di codice sono i seguenti:
#### 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)
```
### Esempio di risposta
Dopo una richiesta riuscita, l'API restituirà le informazioni dettagliate su questa attività. Ad esempio:
```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": "un gatto siamese bianco"
},
"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": "un gatto siamese bianco",
"image_url": "https://platform.cdn.xhuoapi.ai/nanobanana/7e7bd000-698a-4e14-bb2d-3db61237e4bb.png"
}
]
}
}
```
Il risultato restituito contiene diversi campi, il campo request è il corpo della richiesta al momento dell'avvio dell'attività, mentre il campo response è il corpo della risposta restituito al termine dell'attività. La descrizione dei campi è la seguente.
* `id`, l'ID generato per questa attività, utilizzato per identificare univocamente questa generazione di attività.
* `request`, informazioni sulla richiesta nell'attività.
* `response`, informazioni sulla risposta nell'attività.
## Operazione di query in batch
Questa è per interrogare i dettagli di più ID attività, a differenza di quanto sopra, è necessario selezionare l'azione come `retrieve_batch`.
**Request Body** include:
* `ids`: array degli ID delle attività caricate.
* `action`: il modo di operare sull'attività.
Esempio:
```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"
}'
```
### Esempio di risposta
Dopo una richiesta riuscita, l'API restituirà le informazioni dettagliate su tutte le attività in batch. Ad esempio:
```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": "un gatto siamese bianco"
},
"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": "un gatto siamese bianco",
"image_url": "https://platform.cdn.xhuoapi.ai/nanobanana/7e7bd000-698a-4e14-bb2d-3db61237e4bb.png"
}
]
}
}
],
"count": 1
}
```
Il risultato restituito contiene diversi campi, dove items include le informazioni dettagliate delle attività in batch, ogni informazione specifica dell'attività è simile ai campi della query di un'attività singola, le informazioni sui campi sono le seguenti.
* `items`, tutte le informazioni dettagliate delle attività in batch. È un array, ogni elemento dell'array ha lo stesso formato del risultato restituito per la query di un'attività singola.
* `count`, il numero di attività in questa query in batch.
## Gestione degli errori
Quando si chiama l'API, se si verifica un errore, l'API restituirà il codice di errore e le informazioni corrispondenti. Ad esempio:
* `400 token_mismatched`: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
* `400 api_not_implemented`: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
* `401 invalid_token`: Non autorizzato, token di autorizzazione non valido o mancante.
* `429 too_many_requests`: Troppe richieste, hai superato il limite di frequenza.
* `500 api_error`: Errore interno del server, qualcosa è andato storto sul server.
### Esempio di risposta di errore
```json theme={null}
{
"success": false,
"error": {
"code": "api_error",
"message": "fetch failed"
},
"trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}
```
## Conclusione
Attraverso questo documento, hai appreso come utilizzare l'API Nano Banana Tasks per interrogare informazioni dettagliate su singoli o batch di attività. Speriamo che questo documento possa aiutarti a integrare e utilizzare meglio questa API. Se hai domande, non esitare a contattare il nostro team di supporto tecnico.