Przejdź do głównej treści

Wprowadzenie

Wan to usługa AI wideo oferowana przez Ace Data Cloud, model generowania wideo Wanxiang firmy Alibaba. Dzięki zunifikowanemu API Ace Data Cloud możesz szybko zintegrować Wan w Pythonie, 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
  • Środowisko Python 3.7 lub nowsze
  • Zainstalowana biblioteka requests: pip install requests

Podstawowe użycie

Główny endpoint API Wan to:
POST https://api.acedata.cloud/wan/videos
W tym przykładzie używamy modelu 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 w Python:
import requests

url = "https://api.acedata.cloud/wan/videos"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "action": "text2video",
    "model": "wan2.6-t2v",
    "prompt": "Astronauts shuttle from space to volcano",
    "resolution": "720P"
}

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 udanym wywołaniu API zwraca dane w formacie JSON. Zaleca się sprawdzenie 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 poprzez 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
401Nieautoryzowany, sprawdź token API
403Niewystarczające środki lub brak dostępu
429Przekroczono limit zapytań
500Błąd wewnętrzny serwera

Inne endpointy

Usługa Wan udostępnia również następujący endpoint:
  • POST https://api.acedata.cloud/wan/tasks

Kolejne kroki