Przejdź do głównej treści

​
Wprowadzenie

Hailuo to usługa AI wideo oferowana przez Ace Data Cloud, oparta na modelu generowania wideo MiniMax Hailuo. Dzięki zunifikowanemu API Ace Data Cloud możesz szybko zintegrować Hailuo za pomocą JavaScript, realizując funkcje takie jak generowanie wideo z tekstu, generowanie wideo z obrazu, tryb reżysera i inne.

​
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 Hailuo to: 
POST https://api.acedata.cloud/hailuo/videos
W tym przykładzie używany jest model minimax-t2v. Dostępne modele to: minimax-i2v, minimax-t2v, minimax-i2v-director. Pełny przykład kodu JavaScript: 
const response = await fetch("https://api.acedata.cloud/hailuo/videos", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "action": "generate",
  "model": "minimax-t2v",
  "prompt": "A golden sunset over the ocean waves"
}),
});

const result = await response.json();
console.log(result);
Zamień YOUR_API_TOKEN na rzeczywisty token uzyskany na platformie Ace Data Cloud.

​
Obsługa odpowiedzi

Zaleca się sprawdzenie 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

Rekomendowane jest opakowanie w funkcję wielokrotnego użytku: 
async function callHailuo(data) {
  const response = await fetch("https://api.acedata.cloud/hailuo/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
401Błąd uwierzytelniania, sprawdź token API
403Niewystarczające środki lub brak dostępu
429Przekroczono limit częstotliwości zapytań
500Wewnętrzny błąd serwera

​
Kolejne kroki