Przejdź do głównej treści

Wprowadzenie

Wan to usługa AI wideo oferowana przez Ace Data Cloud, model generowania wideo Wan Xiang firmy Alibaba. Dzięki zunifikowanemu API Ace Data Cloud możesz szybko zintegrować Wan za pomocą JavaScript, realizując funkcje takie jak generowanie wideo z tekstu, generowanie wideo z obrazu, generowanie wideo referencyjnego oraz obsługę różnych rozdzielczości.

Wymagania wstępne

  • Konto w Ace Data Cloud oraz uzyskany token API
  • Node.js 18+ lub nowoczesne środowisko przeglądarki

Podstawowe użycie

Główny endpoint API Wan to:
POST https://api.acedata.cloud/wan/videos
W tym przykładzie używany jest model wan2.6-t2v. Dostępne modele to: wan2.6-t2v, wan2.6-i2v, wan2.6-r2v, wan2.6-i2v-flash. Pełny przykład kodu 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);
Proszę zastąpić YOUR_API_TOKEN rzeczywistym tokenem uzyskanym na platformie Ace Data Cloud.

Obsługa odpowiedzi

Zaleca się sprawdzenie kodu statusu odpowiedzi i obsługę błędów:
if (response.ok) {
  const result = await response.json();
  console.log("Wywołanie zakończone sukcesem:", result);
} else {
  console.error(`Wywołanie nie powiodło się, kod statusu: ${response.status}`);
  const error = await response.text();
  console.error(error);
}

Opakowanie w Node.js

Zaleca się opakowanie w funkcję wielokrotnego użytku:
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(`Błąd API: ${response.status}`);
  return response.json();
}

Obsługa błędów

Typowe kody błędów:
Kod statusuOpis
401Nieautoryzowany, proszę sprawdzić token API
403Niewystarczające środki lub brak dostępu
429Przekroczona częstotliwość żądań
500Błąd wewnętrzny serwera

Kolejne kroki