Przejdź do głównej treści

Wprowadzenie

Kling to usługa AI do wideo oferowana przez Ace Data Cloud, model szybkiego generowania wideo. Dzięki zunifikowanemu API Ace Data Cloud możesz szybko zintegrować Kling za pomocą JavaScript, realizując funkcje takie jak generowanie wideo z tekstu, generowanie wideo z obrazów, kontynuacja wideo, różne długości i proporcje.

Wymagania wstępne

  • Posiadanie konta w Ace Data Cloud i uzyskanie API Token
  • Node.js 18+ lub nowoczesne środowisko przeglądarki

Podstawowe użycie

Główny endpoint API Kling to:
POST https://api.acedata.cloud/kling/videos
W tym przykładzie używany jest model kling-v2-5-turbo. Dostępne modele to: kling-v1, kling-v1-6, kling-v2-master, kling-v2-1-master, kling-v2-5-turbo, kling-video-o1. Pełny przykład kodu JavaScript:
const response = await fetch("https://api.acedata.cloud/kling/videos", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "action": "text2video",
  "prompt": "A white cat walking in the snow",
  "model": "kling-v2-5-turbo",
  "duration": 5,
  "aspect_ratio": "16:9"
}),
});

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 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 callKling(data) {
  const response = await fetch("https://api.acedata.cloud/kling/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ź API Token
403Niewystarczające środki lub brak dostępu
429Przekroczona częstotliwość żądań
500Wewnętrzny błąd serwera

Kolejne kroki