> ## 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 Wan Tasks > Tongyi Wansiang Video Generation 集成指南 - XHuoAPI La principale funzionalità dell'API Wan Tasks è quella di consultare lo stato di esecuzione di un'attività utilizzando l'ID dell'attività generato dall'API Wan Videos Generation. Questo documento fornirà una descrizione dettagliata dell'integrazione dell'API Wan Tasks, aiutandoti a integrare facilmente e sfruttare appieno le potenti funzionalità di questa API. Con l'API Wan Tasks, puoi facilmente realizzare la consultazione dello stato di esecuzione delle attività dell'API Wan Videos Generation. ## Processo di richiesta Per utilizzare l'API Wan Tasks, è necessario prima andare alla pagina di richiesta [Wan Videos Generation API](https://api.xhuoapi.ai/documents/52b0f490-1bbf-4fe5-b60e-96626d333d2c) per richiedere il servizio corrispondente, quindi copiare l'ID dell'attività dell'API Wan Videos Generation, come mostrato nell'immagine:

Infine, accedi alla pagina dell'API Tasks [Wan Tasks API](https://api.xhuoapi.ai/documents/240ef446-cbec-461c-a633-4a64178d7018) per richiedere il servizio corrispondente. Dopo essere entrato nella pagina, fai clic sul pulsante "Acquire", come mostrato nell'immagine: ![Pagina di richiesta](https://cdn.xhuoapi.ai/rci31i.png) 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 Wan Tasks può essere utilizzata per consultare i risultati dell'API Wan Videos Generation. Per informazioni su come utilizzare l'API Wan Videos Generation, fare riferimento al documento [Wan Videos Generation API](https://api.xhuoapi.ai/documents/52b0f490-1bbf-4fe5-b60e-96626d333d2c). Prendiamo come esempio un ID di attività restituito dal servizio Wan Videos Generation API e dimostriamo come utilizzare questa API. Supponiamo di avere un ID di attività: a4bca552-d964-46a1-8ff7-fd922f916582, 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 inserito come `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:

### 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/wan/tasks' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "id": "a4bca552-d964-46a1-8ff7-fd922f916582", "action": "retrieve" }' ``` #### Python ```python theme={null} import requests url = "https://api.xhuoapi.ai/v1/wan/tasks" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "id": "a4bca552-d964-46a1-8ff7-fd922f916582", "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 di questa attività video. Ad esempio: ```json theme={null} { "_id": "6974ce81ff2676299c399252", "id": "a4bca552-d964-46a1-8ff7-fd922f916582", "api_id": "6a4ecdbf-b219-4505-8277-5ec4b1ac14f8", "application_id": "52933893-8e8b-4cd6-b9e5-2354eedea000", "created_at": 1769262721.763, "credential_id": "c7173d71-d234-413e-ab72-7bfa6715d12f", "request": { "action": "text2video", "model": "wan2.6-t2v", "prompt": "Astronauti si spostano dallo spazio a un vulcano", "duration": 5 }, "trace_id": "b9cf9569-4010-46b1-80ec-efc881126eac", "type": "videos", "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf", "job_id": "0d2042f9-ba8d-496d-8ab5-182617e28f9e", "response": { "success": true, "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/1d/db/20260124/da477ba2/0d2042f9-ba8d-496d-8ab5-182617e28f9e.mp4?Expires=1769349278&OSSAccessKeyId=LTAI5tKPD3TMqf2Lna1fASuh&Signature=SjBa4wRcDVx3SSYu%2Fx7BYCFQk0s%3D", "state": "completed", "task_id": "a4bca552-d964-46a1-8ff7-fd922f916582" }, "duration": 787.3310000896454, "finished_at": 1769263509.094 } ``` Il risultato restituito contiene diversi campi, il campo request è il corpo della richiesta inviato per avviare l'attività, mentre il campo response è il corpo della risposta restituito dopo il completamento dell'attività. La descrizione dei campi è la seguente. * `id`, l'ID di questa attività video generata, utilizzato per identificare univocamente questa attività di generazione video. * `request`, informazioni sulla richiesta nell'attività video. * `response`, informazioni sulla risposta nell'attività video. ## Operazione di query in batch Questa è per consultare 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:

### 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à le informazioni dettagliate di tutte le attività video in batch. Ad esempio: ```json theme={null} { "items": [ { "_id": "6974ce81ff2676299c399252", "id": "a4bca552-d964-46a1-8ff7-fd922f916582", "api_id": "6a4ecdbf-b219-4505-8277-5ec4b1ac14f8", "application_id": "52933893-8e8b-4cd6-b9e5-2354eedea000", "created_at": 1769262721.763, "credential_id": "c7173d71-d234-413e-ab72-7bfa6715d12f", "request": { "action": "text2video", "model": "wan2.6-t2v", "prompt": "Astronauti che si spostano dallo spazio al vulcano", "duration": 5 }, "trace_id": "b9cf9569-4010-46b1-80ec-efc881126eac", "type": "videos", "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf", "job_id": "0d2042f9-ba8d-496d-8ab5-182617e28f9e", "response": { "success": true, "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/1d/db/20260124/da477ba2/0d2042f9-ba8d-496d-8ab5-182617e28f9e.mp4?Expires=1769349278&OSSAccessKeyId=LTAI5tKPD3TMqf2Lna1fASuh&Signature=SjBa4wRcDVx3SSYu%2Fx7BYCFQk0s%3D", "state": "completato", "task_id": "a4bca552-d964-46a1-8ff7-fd922f916582" }, "duration": 787.3310000896454, "finished_at": 1769263509.094 }, { "_id": "6974ce81ff2676299c399252", "id": "a4bca552-d964-46a1-8ff7-fd922f916582", "api_id": "6a4ecdbf-b219-4505-8277-5ec4b1ac14f8", "application_id": "52933893-8e8b-4cd6-b9e5-2354eedea000", "created_at": 1769262721.763, "credential_id": "c7173d71-d234-413e-ab72-7bfa6715d12f", "request": { "action": "text2video", "model": "wan2.6-t2v", "prompt": "Astronauti che si spostano dallo spazio al vulcano", "duration": 5 }, "trace_id": "b9cf9569-4010-46b1-80ec-efc881126eac", "type": "videos", "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf", "job_id": "0d2042f9-ba8d-496d-8ab5-182617e28f9e", "response": { "success": true, "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/1d/db/20260124/da477ba2/0d2042f9-ba8d-496d-8ab5-182617e28f9e.mp4?Expires=1769349278&OSSAccessKeyId=LTAI5tKPD3TMqf2Lna1fASuh&Signature=SjBa4wRcDVx3SSYu%2Fx7BYCFQk0s%3D", "state": "completato", "task_id": "a4bca552-d964-46a1-8ff7-fd922f916582" }, "duration": 787.3310000896454, "finished_at": 1769263509.094 } ], "count": 2 } ``` #### CURL ```bash theme={null} curl -X POST 'https://api.xhuoapi.ai/v1/wan/tasks' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "ids": ["a4bca552-d964-46a1-8ff7-fd922f916582","a4bca552-d964-46a1-8ff7-fd922f916582"], "action": "retrieve_batch" }' ``` ## 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 Wan 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.