Co zbudujesz
Wyślesz zadanie Kling text-to-video, zapiszesz zwrócony identyfikator zadania, będziesz odpytwać pasujący endpoint zadania Kling i zdecydujesz, kiedy dodaćcallback_url do powiadomień push.
Wymagania wstępne
- Klucz API CometAPI zapisany w
COMETAPI_KEY - Python 3.10+ z
requestslub Node.js 18+ - Worker po stronie serwera do odpytywania lub endpoint callback HTTPS dla webhooków
Klucz API, bazowy URL, uwierzytelnianie
Utwórz zadanie Kling text-to-video za pomocą:Przykłady kodu
Użyj poniższych zakładek, aby skopiować przykłady w cURL, Python i Node.js.Wyjaśnienie przepływu
Generowanie wideo Kling jest asynchroniczne. Endpoint create zwracadata.task_id. Odpytuj GET /kling/v1/videos/text2video/<task_id>, aż data.task_status osiągnie succeed lub failed. Gdy zadanie zakończy się sukcesem, skopiuj URL gotowego zasobu z data.task_result do własnej pamięci masowej, jeśli potrzebujesz trwałego dostępu.
Dodaj callback_url, gdy chcesz, aby aktualizacje statusu zadania były wysyłane do kontrolowanego przez Ciebie endpointu HTTPS. Zachowaj polling jako mechanizm do uzgadniania stanu i obsługi pominiętych dostarczeń callbacków.
Typowe parametry
Rozwiązywanie problemów / FAQ
Kształt odpowiedzi różni się od tras wideo OpenAI
Kształt odpowiedzi różni się od tras wideo OpenAI
Kling używa specyficznych dla dostawcy pól JSON, takich jak
data.task_id, data.task_status i data.task_result. Nie parsuj tego tak jak zgodnych z OpenAI tras /v1/videos.Zadanie nigdy nie osiąga stanu succeed
Zadanie nigdy nie osiąga stanu succeed
Używaj ograniczonego pollingu i sprawdzaj
data.task_status_msg, gdy zadanie zakończy się niepowodzeniem. Zachowaj task ID do późniejszej diagnostyki.Czy powinienem używać callback_url czy pollingu
Czy powinienem używać callback_url czy pollingu
Używaj pollingu jako podstawy. Dodaj
callback_url do dostarczania push, a następnie uzgadniaj stan końcowy za pomocą pollingu.Następne kroki
- Przeczytaj dokumentację referencyjną API Kling text-to-video.
- Odpytuj za pomocą Pobierz zadanie Kling.
- Skonfiguruj callbacki za pomocą Używanie URL-i callbacków Kling.
- Znajdź modele wideo Kling w Models.
- Zapoznaj się z Używaniem pollingu i webhooków do generowania wideo.
- Oszacuj koszt zadania za pomocą Oszacuj koszt żądania przed wywołaniem modelu.