> ## 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. # Integração e Uso da API Wan Tasks > Tongyi Wansiang Video Generation 集成指南 - XHuoAPI A principal função da API Wan Tasks é consultar o status de execução de uma tarefa através do ID da tarefa gerado pela API Wan Videos Generation. Este documento irá detalhar as instruções de integração da API Wan Tasks, ajudando você a integrar facilmente e aproveitar ao máximo as poderosas funcionalidades dessa API. Com a API Wan Tasks, você pode consultar facilmente o status de execução das tarefas da API Wan Videos Generation. ## Processo de Solicitação Para usar a API Wan Tasks, você precisa primeiro ir à página de solicitação [Wan Videos Generation API](https://api.xhuoapi.ai/documents/52b0f490-1bbf-4fe5-b60e-96626d333d2c) para solicitar o serviço correspondente, e então copiar o ID da tarefa da API Wan Videos Generation, como mostrado na imagem:

Por fim, acesse a página da API Tasks [Wan Tasks API](https://api.xhuoapi.ai/documents/240ef446-cbec-461c-a633-4a64178d7018) para solicitar o serviço correspondente. Após acessar a página, clique no botão "Acquire", como mostrado na imagem: ![Página de Solicitação](https://cdn.xhuoapi.ai/rci31i.png) Se você ainda não estiver logado ou registrado, será redirecionado automaticamente para a [página de login](https://api.xhuoapi.ai) que o convidará a se registrar e fazer login. Após o registro e login, você será redirecionado automaticamente de volta para a página atual. Na primeira solicitação, haverá um crédito gratuito disponível, permitindo que você use essa API gratuitamente. ## Exemplo de Solicitação A API Wan Tasks pode ser usada para consultar os resultados da API Wan Videos Generation. Para saber como usar a API Wan Videos Generation, consulte o documento [Wan Videos Generation API](https://api.xhuoapi.ai/documents/52b0f490-1bbf-4fe5-b60e-96626d333d2c). Usaremos um exemplo de ID de tarefa retornado pelo serviço da API Wan Videos Generation. Suponha que temos um ID de tarefa: a4bca552-d964-46a1-8ff7-fd922f916582, a seguir, demonstraremos como passar um ID de tarefa. ### Exemplo de Tarefa

### Configurando Cabeçalhos e Corpo da Solicitação **Request Headers** incluem: * `accept`: especifica que a resposta deve ser no formato JSON, preenchido como `application/json`. * `authorization`: a chave para chamar a API, que pode ser selecionada diretamente após a solicitação. **Request Body** inclui: * `id`: o ID da tarefa enviada. * `action`: a forma de operação na tarefa. Configuração conforme mostrado na imagem abaixo:

### Exemplo de Código Pode-se notar que, no lado direito da página, já foram gerados automaticamente códigos em várias linguagens, como mostrado na imagem:

Alguns exemplos de código são os seguintes: #### 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) ``` ### Exemplo de Resposta Após uma solicitação bem-sucedida, a API retornará as informações detalhadas da tarefa de vídeo aqui. Por exemplo: ```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": "Astronautas se deslocam do espaço para o vulcão", "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 } ``` O resultado retornado contém vários campos, o campo request é o corpo da solicitação quando a tarefa foi iniciada, enquanto o campo response é o corpo da resposta retornada após a conclusão da tarefa. A descrição dos campos é a seguinte. * `id`, o ID que gerou esta tarefa de vídeo, usado para identificar exclusivamente esta tarefa de geração de vídeo. * `request`, informações da solicitação na tarefa de vídeo. * `response`, informações da resposta na tarefa de vídeo. ## Operação de Consulta em Lote Esta operação é para consultar detalhes de tarefas de vídeo para vários IDs de tarefa, diferentemente do anterior, onde a ação deve ser selecionada como retrieve\_batch. **Request Body** inclui: * `ids`: um array de IDs de tarefa enviados. * `action`: a forma de operação na tarefa. Configuração conforme mostrado na imagem abaixo:

### Exemplo de Código Pode-se notar que, no lado direito da página, já foram gerados automaticamente códigos em várias linguagens, como mostrado na imagem:

Alguns exemplos de código são os seguintes: ### Exemplo de Resposta Após uma solicitação bem-sucedida, a API retornará as informações detalhadas de todas as tarefas de vídeo em lote. Por exemplo: ```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": "Astronautas se deslocam do espaço para o vulcão", "duration": 5 }, "trace_id": "b9cf9569-4010-46b1-80ec-efc881126eac", "type": "vídeos", "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": "completo", "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": "Astronautas se deslocam do espaço para o vulcão", "duration": 5 }, "trace_id": "b9cf9569-4010-46b1-80ec-efc881126eac", "type": "vídeos", "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": "completo", "task_id": "a4bca552-d964-46a1-8ff7-fd922f916582" }, "duration": 787.3310000896454, "finished_at": 1769263509.094 } ], "count": 2 } ``` 返回结果一共有多个字段，其中items是包含了批量视频任务的具体详情信息，每个视频任务的具体信息与上文的字段一样，字段信息如下。 * `items`，批量 vídeo tarefas de todas as informações detalhadas. É um array, cada elemento do array tem o mesmo formato do resultado da consulta de uma única tarefa acima. * `count`，número de tarefas de vídeo consultadas em lote. #### 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" }' ``` ## Erro de tratamento Ao chamar a API, se encontrar um erro, a API retornará o respectivo código de erro e informações. Por exemplo: * `400 token_mismatched`：Solicitação inválida, possivelmente devido a parâmetros ausentes ou inválidos. * `400 api_not_implemented`：Solicitação inválida, possivelmente devido a parâmetros ausentes ou inválidos. * `401 invalid_token`：Não autorizado, token de autorização inválido ou ausente. * `429 too_many_requests`：Muitas solicitações, você excedeu o limite de taxa. * `500 api_error`：Erro interno do servidor, algo deu errado no servidor. ### Exemplo de resposta de erro ```json theme={null} { "success": false, "error": { "code": "api_error", "message": "falha ao buscar" }, "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89" } ``` ## Conclusão Através deste documento, você já entendeu como usar a API Wan Tasks para consultar detalhes de tarefas de vídeo individuais ou em lote. Esperamos que este documento possa ajudá-lo a integrar e usar melhor essa API. Se tiver alguma dúvida, entre em contato com nossa equipe de suporte técnico.