Przejdź do głównej treści

Wprowadzenie

Veo to usługa AI wideo oferowana przez Ace Data Cloud, oparta na modelu generowania wideo Google Veo. Dzięki zunifikowanemu API Ace Data Cloud możesz szybko zintegrować Veo za pomocą JavaScript, realizując funkcje takie jak generowanie wideo z tekstu, generowanie wideo z obrazów, rozdzielczość 4K, różne proporcje 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 Veo to:
POST https://api.acedata.cloud/veo/videos
W tym przykładzie używany jest model veo3.
Dostępne modele to: veo2, veo2-fast, veo3, veo3-fast, veo31, veo31-fast.
Pełny przykład kodu JavaScript:
const response = await fetch("https://api.acedata.cloud/veo/videos", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "action": "text2video",
  "prompt": "A coffee mug rotating slowly on a marble counter",
  "model": "veo3"
}),
});

const result = await response.json();
console.log(result);
Zamień YOUR_API_TOKEN na rzeczywisty token, który otrzymałeś na platformie Ace Data Cloud.

Obsługa odpowiedzi

Zaleca się sprawdzenie kodu statusu odpowiedzi oraz 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 wywołania w funkcję wielokrotnego użytku:
async function callVeo(data) {
  const response = await fetch("https://api.acedata.cloud/veo/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();
}

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 żądań
500Błąd wewnętrzny serwera

Kolejne kroki