Przejdź do głównej treści

​
Wprowadzenie

Kling to usługa AI wideo oferowana przez Ace Data Cloud, model szybkiego generowania wideo. Dzięki zunifikowanemu API Ace Data Cloud możesz szybko zintegrować Kling za pomocą Pythona, 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

  • Konto w Ace Data Cloud oraz uzyskany token API
  • Środowisko Python 3.7 lub nowsze
  • Zainstalowana biblioteka requests: pip install requests

​
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 w Python: 
import requests

url = "https://api.acedata.cloud/kling/videos"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "action": "text2video",
    "prompt": "A white cat walking in the snow",
    "model": "kling-v2-5-turbo",
    "duration": 5,
    "aspect_ratio": "16:9"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Zamień YOUR_API_TOKEN na rzeczywisty token uzyskany na platformie Ace Data Cloud.

​
Obsługa odpowiedzi

Po pomyślnym wywołaniu API zwraca dane w formacie JSON. Zaleca się sprawdzenie kodu statusu HTTP: 
if response.status_code == 200:
    result = response.json()
    print("Wywołanie zakończone sukcesem:", result)
else:
    print(f"Wywołanie nie powiodło się, kod statusu: {response.status_code}")
    print(response.text)

​
Zaawansowane użycie

Dla API obsługujących zadania asynchroniczne można uzyskać wynik za pomocą callback URL: 
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# Wynik zostanie przesłany na Twój serwer przez callback URL

​
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
429Przekroczona częstotliwość żądań
500Błąd wewnętrzny serwera

​
Inne endpointy

Usługa Kling udostępnia także następujące endpointy:
  • POST https://api.acedata.cloud/kling/tasks
  • POST https://api.acedata.cloud/kling/motion

​
Kolejne kroki