Skip to main content
W tym artykule przedstawimy sposób integracji Hailuo Videos Generation API, które pozwala na generowanie oficjalnych filmów Hailuo poprzez wprowadzenie niestandardowych parametrów.

​
Proces aplikacji

Aby korzystać z Hailuo Videos Generation API, najpierw przejdź do konsoli Ace Data Cloud, aby uzyskać swój token API, który należy zachować na przyszłość. Jeśli nie jesteś zalogowany lub zarejestrowany, automatycznie zostaniesz przekierowany na stronę logowania, aby zarejestrować się i zalogować, a po zakończeniu zostaniesz automatycznie przekierowany z powrotem na bieżącą stronę. Jeden token API wystarczy do wywołania wszystkich usług platformy, nie ma potrzeby składania osobnych wniosków dla każdej usługi. Przy pierwszym wniosku otrzymasz darmowy limit, aby móc go przetestować; w przypadku niewystarczającego limitu możesz doładować saldo ogólne w konsoli.
📘 Pełna dokumentacja: Hailuo Videos Generation API →

​
Podstawowe użycie

Najpierw zapoznaj się z podstawowym sposobem użycia, czyli wprowadzeniem słowa kluczowego prompt, działania action, linku do pierwszego obrazu first_image_url oraz modelu model, aby uzyskać przetworzony wynik. Najpierw musimy przekazać pole action, którego wartość to generate, a następnie musimy wprowadzić model, który obecnie obejmuje model wideo generowany z obrazu minimax-i2v oraz model wideo generowany z tekstu minimax-t2v, szczegóły są następujące:

Możemy zobaczyć, że ustawiliśmy nagłówki żądania, w tym:
  • accept: jakiego formatu odpowiedzi oczekujemy, tutaj wpisujemy application/json, czyli format JSON.
  • authorization: klucz do wywołania API, który można wybrać z rozwijanej listy po złożeniu wniosku.
Dodatkowo ustawiliśmy ciało żądania, które obejmuje:
  • model: model generujący wideo, głównie dwa modele: minimax-i2v i minimax-t2v.
  • action: działanie związane z zadaniem generowania wideo.
  • first_image_url: link do pierwszego obrazu referencyjnego, który musi być przesłany, gdy wybierzesz model minimax-i2v, nie obsługuje kodowania Base64.
  • prompt: słowo kluczowe.
  • callback_url: URL, na który mają być zwracane wyniki.
  • async: opcjonalne, ustawione na true, gdy interfejs natychmiast zwraca task_id, nie ma potrzeby podawania callback_url, a następnie można uzyskać wyniki, korzystając z odpowiedniego interfejsu zapytań o zadania.
Po dokonaniu wyboru, można zauważyć, że po prawej stronie wygenerowano odpowiedni kod, jak pokazano na rysunku:

Kliknij przycisk „Try”, aby przeprowadzić test, jak pokazano na powyższym obrazku, otrzymujemy następujący wynik:
Zwrócony wynik zawiera wiele pól, które są opisane poniżej:
  • success, status zadania generowania wideo.
  • task_id, ID zadania generowania wideo.
  • trace_id, ID śledzenia generowania wideo.
  • data, lista wyników zadania generowania wideo.
    • id, ID wideo generowanego w ramach zadania.
    • prompt, słowo kluczowe zadania generowania wideo.
    • model, link do okładki zadania generowania wideo.
    • video_url, link do wideo generowanego w ramach zadania.
    • state, status zadania generowania wideo.
Możemy zobaczyć, że otrzymaliśmy satysfakcjonujące informacje o wideo, wystarczy, że uzyskamy wygenerowane wideo Hailuo na podstawie adresu linku wideo w data. Jeśli chcesz wygenerować odpowiedni kod do integracji, możesz go po prostu skopiować, na przykład kod CURL wygląda następująco:

​
Asynchroniczny callback

Ponieważ czas generowania Hailuo Videos Generation API jest stosunkowo długi, wynosi około 1-2 minut, jeśli API nie odpowiada przez dłuższy czas, żądanie HTTP będzie utrzymywać połączenie, co prowadzi do dodatkowego zużycia zasobów systemowych, dlatego to API oferuje również wsparcie dla asynchronicznych callbacków. Cały proces polega na tym, że klient podczas wysyłania żądania dodatkowo określa pole callback_url. Po wysłaniu żądania API natychmiast zwraca wynik, zawierający pole task_id, które reprezentuje aktualne ID zadania. Po zakończeniu zadania wynik generowania wideo zostanie wysłany do określonego przez klienta callback_url w formie POST JSON, w tym również pole task_id, dzięki czemu wyniki zadania można powiązać za pomocą ID. Poniżej przedstawiamy przykład, aby zrozumieć, jak to działa. Najpierw, callback Webhook to usługa, która może odbierać żądania HTTP, deweloperzy powinni zastąpić ją URL swojego serwera HTTP. W celu wygodnej demonstracji używamy publicznej strony przykładowej Webhook https://webhook.site/, otwierając tę stronę, można uzyskać URL Webhook, jak pokazano na rysunku: Skopiuj ten URL, aby użyć go jako Webhook, przykładowy URL to https://webhook.site/580b81f5-596e-4321-b03f-606770b0bb83. Następnie możemy ustawić pole callback_url na powyższy URL Webhook, a także wprowadzić odpowiednie parametry, szczegóły są pokazane na rysunku:

Klikając „Uruchom”, można zauważyć, że natychmiast otrzymujemy wynik, jak poniżej:
Po chwili możemy obserwować wyniki generowania wideo na https://webhook.site/580b81f5-596e-4321-b03f-606770b0bb83, jak pokazano na rysunku: Treść jest następująca:
Można zauważyć, że w wynikach znajduje się pole task_id, a pozostałe pola są podobne do powyższych, dzięki czemu można powiązać zadania.

​
Obsługa błędów

Podczas wywoływania API, jeśli wystąpi błąd, API zwróci odpowiedni kod błędu i informacje. Na przykład:
  • 400 token_mismatched: Złe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
  • 400 api_not_implemented: Złe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
  • 401 invalid_token: Nieautoryzowany, nieprawidłowy lub brakujący token autoryzacyjny.
  • 429 too_many_requests: Zbyt wiele żądań, przekroczono limit szybkości.
  • 500 api_error: Błąd wewnętrzny serwera, coś poszło nie tak na serwerze.

​
Przykład odpowiedzi błędu

​
Wnioski

Dzięki temu dokumentowi zrozumieliście, jak korzystać z API Generacji Wideo Hailuo, które umożliwia generowanie wideo na podstawie wprowadzonych podpowiedzi oraz obrazu referencyjnego pierwszej klatki. Mamy nadzieję, że ten dokument pomoże Wam lepiej zintegrować i korzystać z tego API. W razie jakichkolwiek pytań, prosimy o kontakt z naszym zespołem wsparcia technicznego.