Saltar para o conteúdo principal

​
Introdução

Wan é um serviço de vídeo AI fornecido pela Ace Data Cloud, baseado no modelo de geração de vídeo Wanxiang da Alibaba. Através da API unificada da Ace Data Cloud, você pode integrar rapidamente o Wan usando Python para realizar geração de vídeo a partir de texto, geração de vídeo a partir de imagem, geração de vídeo por referência, suporte a múltiplas resoluções, entre outras funcionalidades.

​
Pré-requisitos

  • Possuir uma conta na Ace Data Cloud e obter o API Token
  • Ambiente Python 3.7 ou superior
  • Instalar a biblioteca requests: pip install requests

​
Uso Básico

O endpoint principal para chamar a API Wan é: 
POST https://api.acedata.cloud/wan/videos
Este exemplo utiliza o modelo wan2.6-t2v.
Modelos disponíveis incluem: wan2.6-t2v, wan2.6-i2v, wan2.6-r2v, wan2.6-i2v-flash. Exemplo completo em Python: 
import requests

url = "https://api.acedata.cloud/wan/videos"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "action": "text2video",
    "model": "wan2.6-t2v",
    "prompt": "Astronauts shuttle from space to volcano",
    "resolution": "720P"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Substitua YOUR_API_TOKEN pelo Token real obtido na plataforma Ace Data Cloud.

​
Tratamento da Resposta

Após uma chamada bem-sucedida, a API retorna dados em formato JSON. Recomenda-se verificar o código de status HTTP: 
if response.status_code == 200:
    result = response.json()
    print("Chamada bem-sucedida:", result)
else:
    print(f"Falha na chamada, código de status: {response.status_code}")
    print(response.text)

​
Uso Avançado

Para APIs que suportam tarefas assíncronas, é possível obter resultados via URL de callback: 
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# Os resultados serão enviados para seu servidor através da URL de callback

​
Tratamento de Erros

Códigos de erro comuns:
CódigoDescrição
401Falha na autenticação, verifique o API Token
403Saldo insuficiente ou acesso negado
429Limite de frequência de requisições excedido
500Erro interno do servidor

​
Outros Endpoints

O serviço Wan também oferece os seguintes endpoints:
  • POST https://api.acedata.cloud/wan/tasks

​
Próximos Passos