> ## 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 Luma Tasks
> Luma Video Generation 集成指南 - XHuoAPI
La principale funzionalità dell'API Luma Tasks è quella di interrogare lo stato di esecuzione di un'attività utilizzando l'ID dell'attività generato dall'API Luma Videos Generation.
Questo documento fornirà una descrizione dettagliata dell'integrazione dell'API Luma Tasks, aiutandoti a integrare facilmente e sfruttare appieno le potenti funzionalità di questa API. Con l'API Luma Tasks, puoi facilmente interrogare lo stato di esecuzione delle attività dell'API Luma Videos Generation.
## Processo di richiesta
Per utilizzare l'API Luma Tasks, è necessario prima andare alla pagina di richiesta [Luma Videos Generation API](https://api.xhuoapi.ai/documents/5bd3597d-1ff8-44ad-a580-b66b48393e7f) per richiedere il servizio corrispondente, quindi copiare l'ID dell'attività dell'API Luma Videos Generation, come mostrato nell'immagine:
Infine, accedi alla pagina dell'API Tasks [Luma Tasks API](https://api.xhuoapi.ai/documents/7d32369c-4ead-4364-a4c5-652bc768b3ff) per richiedere il servizio corrispondente. Una volta entrato nella pagina, fai clic sul pulsante "Acquire", come mostrato nell'immagine:
Se non hai ancora effettuato il login o la registrazione, verrai automaticamente reindirizzato alla [pagina di login](https://api.xhuoapi.ai) che ti invita a registrarti e accedere. Dopo aver effettuato il login o la registrazione, verrai automaticamente riportato alla pagina corrente.
Alla prima richiesta, verrà offerto un credito gratuito, che ti consente di utilizzare gratuitamente questa API.
## Esempio di richiesta
L'API Luma Tasks può essere utilizzata per interrogare i risultati dell'API Luma Videos Generation. Per informazioni su come utilizzare l'API Luma Videos Generation, fare riferimento al documento [Luma Videos Generation API](https://api.xhuoapi.ai/documents/16bb0108-1f09-45b3-97ac-16a668750a8c).
Prendiamo come esempio un ID di attività restituito dal servizio Luma Videos Generation API e dimostriamo come utilizzare questa API. Supponiamo di avere un ID di attività: 50fc6182-fa86-4c7d-ac12-2fa27ec2f151, e ora dimostriamo come passare un ID di 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, che può essere selezionata direttamente dopo la richiesta.
**Request Body** include:
* `id`: l'ID dell'attività caricata.
* `action`: il modo di operare sull'attività.
Impostato come mostrato nell'immagine seguente:
### Esempio di codice
Si può notare che, sul lato destro della pagina, sono già 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/luma/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
"id": "50fc6182-fa86-4c7d-ac12-2fa27ec2f151",
"action": "retrieve"
}'
```
#### Python
```python theme={null}
import requests
url = "https://api.xhuoapi.ai/v1/luma/tasks"
headers = {
"accept": "application/json",
"authorization": "Bearer {token}",
"content-type": "application/json"
}
payload = {
"id": "50fc6182-fa86-4c7d-ac12-2fa27ec2f151",
"action": "retrieve"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
```
### Esempio di risposta
Dopo una richiesta riuscita, l'API restituirà i dettagli di questa attività video. Ad esempio:
```json theme={null}
{
"_id": "66d297a3550a4144a5a5db42",
"id": "50fc6182-fa86-4c7d-ac12-2fa27ec2f151",
"api_id": "94fc9028-5a9f-4875-aae4-38463bd30ac5",
"application_id": "06484a45-9d04-498a-98a7-67086dee8166",
"created_at": 1725077411.961,
"credential_id": "e6a879e5-a7c0-4f7b-9d6f-f9a837421a50",
"request": {
"action": "generate",
"prompt": "Astronauti si spostano dallo spazio a un vulcano"
},
"trace_id": "0b7c1c1a-045c-4145-a434-609cba88f0a9",
"user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
"response": {
"success": true,
"task_id": "50fc6182-fa86-4c7d-ac12-2fa27ec2f151",
"video_id": "4b088fc8-2bbc-4706-80a6-a0fb118adc1a",
"prompt": "Astronauti si spostano dallo spazio a un vulcano",
"video_url": "https://platform.cdn.xhuoapi.ai/luma/50fc6182-fa86-4c7d-ac12-2fa27ec2f151.mp4",
"video_height": 752,
"video_width": 1360,
"state": "completed",
"thumbnail_url": "https://platform.cdn.xhuoapi.ai/luma/50fc6182-fa86-4c7d-ac12-2fa27ec2f151.jpg",
"thumbnail_width": 1360,
"thumbnail_height": 752
},
"finished_at": 1725077566.241
}
```
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à, i cui risultati sono coerenti con la richiesta e la risposta dell'API Luma Videos Generation. La descrizione dei campi è la seguente.
* `id`, l'ID dell'attività video generata, utilizzato per identificare univocamente questa attività di generazione video.
* `video_id`, l'identificatore univoco del video nell'attività video interrogata, necessario per ulteriori operazioni sul video in futuro.
* `request`, informazioni sulla richiesta nell'attività video.
* `response`, informazioni sulla risposta nell'attività video.
## Operazione di query in batch
Questa è per interrogare i dettagli delle attività video per più ID di 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à.
Impostato come mostrato nell'immagine seguente:
### Esempio di codice
Si può notare che, sul lato destro della pagina, sono già stati generati automaticamente vari codici in diverse lingue, come mostrato nell'immagine:
Alcuni esempi di codice sono i seguenti:
### Esempio di risposta
Dopo una richiesta riuscita, l'API restituirà i dettagli specifici di tutte le attività video in batch. Ad esempio:
```json theme={null}
{
"items": [
{
"_id": "66d297a3550a4144a5a5db42",
"id": "50fc6182-fa86-4c7d-ac12-2fa27ec2f151",
"api_id": "94fc9028-5a9f-4875-aae4-38463bd30ac5",
"application_id": "06484a45-9d04-498a-98a7-67086dee8166",
"created_at": 1725077411.961,
"credential_id": "e6a879e5-a7c0-4f7b-9d6f-f9a837421a50",
"request": {
"action": "generate",
"prompt": "Astronauti si spostano dallo spazio al vulcano"
},
"trace_id": "0b7c1c1a-045c-4145-a434-609cba88f0a9",
"user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
"response": {
"success": true,
"task_id": "50fc6182-fa86-4c7d-ac12-2fa27ec2f151",
"video_id": "4b088fc8-2bbc-4706-80a6-a0fb118adc1a",
"prompt": "Astronauti si spostano dallo spazio al vulcano",
"video_url": "https://platform.cdn.xhuoapi.ai/luma/50fc6182-fa86-4c7d-ac12-2fa27ec2f151.mp4",
"video_height": 752,
"video_width": 1360,
"state": "completato",
"thumbnail_url": "https://platform.cdn.xhuoapi.ai/luma/50fc6182-fa86-4c7d-ac12-2fa27ec2f151.jpg",
"thumbnail_width": 1360,
"thumbnail_height": 752
},
"finished_at": 1725077566.241
},
{
"_id": "66d29ed3550a4144a5a6c089",
"id": "76a05f61-68ad-4c1a-838f-a00cd08cf65b",
"api_id": "94fc9028-5a9f-4875-aae4-38463bd30ac5",
"application_id": "06484a45-9d04-498a-98a7-67086dee8166",
"created_at": 1725079250.921,
"credential_id": "e6a879e5-a7c0-4f7b-9d6f-f9a837421a50",
"request": {
"action": "generate",
"prompt": "la la la"
},
"trace_id": "338f1616-741d-40b6-8d62-c025434024c6",
"user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
"response": {
"success": true,
"task_id": "76a05f61-68ad-4c1a-838f-a00cd08cf65b",
"video_id": "5a638d6a-7481-4c5e-8843-36c9d1b5bcd5",
"prompt": "la la la",
"video_url": "https://platform.cdn.xhuoapi.ai/luma/76a05f61-68ad-4c1a-838f-a00cd08cf65b.mp4",
"video_height": 752,
"video_width": 1360,
"state": "completato",
"thumbnail_url": "https://platform.cdn.xhuoapi.ai/luma/76a05f61-68ad-4c1a-838f-a00cd08cf65b.jpg",
"thumbnail_width": 1360,
"thumbnail_height": 752
},
"finished_at": 1725079406.71
}
],
"count": 2
}
```
#### CURL
```bash theme={null}
curl -X POST 'https://api.xhuoapi.ai/v1/luma/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
"ids": ["50fc6182-fa86-4c7d-ac12-2fa27ec2f151","76a05f61-68ad-4c1a-838f-a00cd08cf65b"],
"action": "retrieve_batch"
}'
```
#### Python
```python theme={null}
import requests
url = "https://api.xhuoapi.ai/v1/luma/tasks"
headers = {
"accept": "application/json",
"authorization": "Bearer {token}",
"content-type": "application/json"
}
payload = {
"ids": ["50fc6182-fa86-4c7d-ac12-2fa27ec2f151","76a05f61-68ad-4c1a-838f-a00cd08cf65b"],
"action": "retrieve_batch"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
```
## Errore di gestione
In caso di errore durante la chiamata all'API, 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 compreso come utilizzare l'API Luma Tasks per interrogare i dettagli specifici di singoli o batch di video. 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.