/happyhorse/videos i parametru action.
Proces aplikacji
Aby korzystać z HappyHorse Videos API, najpierw przejdź do konsoli Ace Data Cloud, aby uzyskać swój API Token i zachować go na później.
Jeśli nie jesteś jeszcze zalogowany ani zarejestrowany, zostaniesz automatycznie przekierowany na stronę logowania z zaproszeniem do rejestracji i zalogowania się, a po zakończeniu automatycznie wrócisz na bieżącą stronę.
Jeden API Token umożliwia wywoływanie wszystkich usług platformy, bez potrzeby osobnego składania wniosku dla każdej usługi. Przy pierwszym wniosku otrzymasz bezpłatny limit, aby móc korzystać z bezpłatnego okresu próbnego; gdy limit będzie niewystarczający, możesz doładować wspólne saldo w konsoli.
📘 Pełna dokumentacja: HappyHorse Videos API →
Typy operacji
action określa tryb generowania dla bieżącego żądania:
generate: generowanie wideo z tekstu, domyślna akcja, obsługujehappyhorse-1.0-t2vihappyhorse-1.1-t2v, należy przekazaćprompt.image_to_video: generowanie wideo z obrazu pierwszej klatki, obsługujehappyhorse-1.0-i2vihappyhorse-1.1-i2v, należy przekazaćimage_url.reference_to_video: generowanie wideo z obrazów referencyjnych, obsługujehappyhorse-1.0-r2vihappyhorse-1.1-r2v, należy przekazaćpromptoraz 1–9image_urls.video_edit: edycja wideo, obsługujehappyhorse-1.0-video-edit, należy przekazaćpromptivideo_url, można dodatkowo przekazać 0–5 obrazów referencyjnychimage_urls.
video_edit obecnie ma tylko happyhorse-1.0-video-edit.
Podstawowe użycie
Generowanie wideo z tekstu wymaga jedynie podaniaprompt; można również określić parametry takie jak resolution, ratio, duration itd.:
success: czy bieżące żądanie zakończyło się powodzeniem.task_id: ID zadania po stronie Ace Data Cloud, może być używane do sprawdzania statusu zadania.trace_id: ID śledzenia bieżącego żądania, używane do rozwiązywania problemów.data: lista wyników wideo.id: ID zadania po stronie HappyHorse.video_url: adres linku CDN wygenerowanego wideo.state: status zadania, dostępne wartości topending/succeeded/error.duration: rozliczany czas trwania wideo, w sekundach; dlavideo_editjest to łączny czas trwania wideo wejściowego i wyjściowego.resolution: rozdzielczość wyjściowa.ratio: proporcje szerokości do wysokości wyjścia.
Generowanie wideo z obrazu pierwszej klatki
Podczas używaniaimage_to_video, image_url będzie używany jako pierwsza klatka wideo. Wyjściowe proporcje szerokości do wysokości będą w miarę możliwości zgodne z obrazem pierwszej klatki, dlatego ta akcja nie wymaga przekazania ratio.
Generowanie wideo z obrazów referencyjnych
Podczas używaniareference_to_video, image_urls może przyjąć 1–9 obrazów referencyjnych. W promptcie można używać character1, character2 itd., aby odwoływać się do obrazów w odpowiedniej kolejności.
Edycja wideo
Podczas używaniavideo_edit należy przekazać edytowane wideo video_url oraz intencję edycji prompt. Opcjonalne image_urls będą używane jako obrazy referencyjne, na przykład do zmiany stroju, transferu stylu lub lokalnej zamiany. audio_setting może opcjonalnie przyjmować wartość auto lub origin, gdzie origin oznacza zachowanie oryginalnego dźwięku wideo.
Asynchroniczne wywołanie zwrotne
Generowanie wideo wymaga pewnego czasu przetwarzania. Jeśli nie chcesz utrzymywać długiego połączenia w oczekiwaniu, możesz przekazaćcallback_url, wtedy API natychmiast zwróci task_id, a po zakończeniu zadania wyśle końcowy wynik metodą POST na ten adres:
"async": true, a następnie sprawdzić wynik zadania za pomocą HappyHorse Tasks API.
Informacje o rozliczeniach
HappyHorse rozlicza według liczby sekund wyjściowego wideo i rozdzielczości:720P: już od około $0.105 / sekundę.1080P: już od około $0.18 / sekundę.video_edit: rozliczane według łącznego czasu trwania wejściowego i wyjściowego wideo, a rzeczywisty czas rozliczeniowy jest określany na podstawie statystyk po zakończeniu zadania.
Obsługa błędów
Gdy wystąpi problem z żądaniem, API zwróci odpowiedni kod błędu i opis, najczęstsze są następujące:400: parametry żądania są nieprawidłowe, na przykład action nie pasuje do modelu, brakujeprompt/image_url/video_urllubdurationwykracza poza zakres 3–15 sekund.401: uwierzytelnianie nie powiodło się, token jest nieprawidłowy lub nie pasuje do API.403: niewystarczające saldo lub monit został odrzucony przez moderację treści.429: żądania są zbyt częste, uruchomiono ograniczenie szybkości, spróbuj ponownie później.500: wewnętrzny błąd serwera lub niepowodzenie generowania.

