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 JavaScript 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 de referência, múltiplas resoluções e outras funcionalidades.

​
Pré-requisitos

  • Possuir uma conta na Ace Data Cloud e obter o API Token
  • Node.js 18+ ou ambiente de navegador moderno

​
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 de código JavaScript: 
const response = await fetch("https://api.acedata.cloud/wan/videos", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "action": "text2video",
  "model": "wan2.6-t2v",
  "prompt": "Astronauts shuttle from space to volcano",
  "resolution": "720P"
}),
});

const result = await response.json();
console.log(result);
Substitua YOUR_API_TOKEN pelo Token real obtido na plataforma Ace Data Cloud.

​
Tratamento de Resposta

Recomenda-se verificar o código de status da resposta e tratar erros: 
if (response.ok) {
  const result = await response.json();
  console.log("Chamada bem-sucedida:", result);
} else {
  console.error(`Falha na chamada, código de status: ${response.status}`);
  const error = await response.text();
  console.error(error);
}

​
Encapsulamento para Node.js

Recomenda-se encapsular em uma função reutilizável: 
async function callWan(data) {
  const response = await fetch("https://api.acedata.cloud/wan/videos", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.ACE_API_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(data),
  });
  if (!response.ok) throw new Error(`API error: ${response.status}`);
  return response.json();
}

​
Tratamento de Erros

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

​
Próximos Passos