HappyHorse 1.1 API

alibaba/happyhorse-1.1/text-to-videoOd 105 kredytów za klip 5-sekundowy· Utwórz wideo

HappyHorse 1.1 to rodzina wideo od Alibaby z trzema endpointami: text-to-video, image-to-video i reference-to-video przyjmujące do dziewięciu obrazów referencyjnych. Klipy trwają od 3 do 15 pełnych sekund w 720p albo 1080p, w dziewięciu proporcjach, w tym 4:5, 5:4, 21:9 i 9:21.

Wywołujesz go nazwą modelu alibaba/happyhorse-1.1/text-to-video w POST /jobs/createTask, od 105 kredytów za klip 5-sekundowy (1,05 USD). Nowe konta dostają 30 darmowych kredytów, więc możesz najpierw przetestować go w Playgroundzie.

  • Utwórz wideo
  • Obraz w wideo
  • Wideo z referencji
  • Do 1080p
  • Klipy 3–15 s
  • Do 9 obrazów referencyjnych
  • Proporcje obrazu: 9

Ten poradnik jest na razie tylko po angielsku. →

Parametry żądania

ParametrWymaganyOpis
promptTakDescribe the scene, action, camera movement, and timing.
resolutionNieRozmiar wyniku. Większy jest ostrzejszy i droższy. 720p · 1080p · Domyślnie: 720p
aspect_ratioNieKształt kadru: szeroki, kwadratowy albo pionowy. 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 4:5 · 5:4 · 9:21 · 21:9 · Domyślnie: 16:9
duration_secondsNieDługość klipu. Płacisz za każdą sekundę. ≥ 3 · ≤ 15 · Domyślnie: 5

Ceny

Ceny podajemy w kredytach, tych samych, których używasz na stronie (1 kredyt = 0,01 $). Kwota jest rezerwowana, gdy zadanie zostaje przyjęte, a po zakończeniu rozliczana według rzeczywistego kosztu; za nieudane zadania kredyty wracają.

OpcjaKredyty za sekundę≈ USD
resolution 720p210,21 USD
resolution 1080p270,27 USD

Żeby poznać dokładną kwotę przed uruchomieniem, wyślij to samo body na POST /jobs/quote.

Szybki start z API

Wywołaj API HappyHorse 1.1 w trzech krokach

  1. Utwórz klucz API. Zaloguj się do PopNow i utwórz klucz w konsoli API. Klucze zaczynają się od sk-popnow- i korzystają z tych samych kredytów co strona.
  2. Wyślij żądanie. Wyślij POST /jobs/createTask z model alibaba/happyhorse-1.1/text-to-video i obiektem input zgodnym z tabelą parametrów. Odpowiedź od razu zwraca ID zadania.
  3. Odbierz wynik. Odpytuj GET /jobs/recordInfo po ID zadania albo podaj callBackUrl, a wyślemy tam wynik. Gdy zadanie się powiedzie, pobierz pliki z linków wyjściowych.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "alibaba/happyhorse-1.1/text-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration_seconds": 5
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Podmień prompt i linki na własne. Odniesienie do odpowiedzi, odpytywania i callbacku znajdziesz na karcie API.

Pytania o API HappyHorse 1.1

Ile kosztuje API HappyHorse 1.1?

HappyHorse 1.1 kosztuje od 105 kredytów (1,05 USD) za klip 5-sekundowy – najtańsze zadanie to „Utwórz wideo”. Ceny według opcji: 720p 21 kredytów za sekundę, 1080p 27 kredytów za sekundę. Kredyty są te same co na stronie (1 kredyt = 0,01 USD), nowe konta dostają 30 darmowych kredytów, a nieudane zadania są zwracane.

Jaka jest nazwa modelu HappyHorse 1.1 w API?

Wpisz alibaba/happyhorse-1.1/text-to-video do zadania Utwórz wideo; alibaba/happyhorse-1.1/image-to-video do zadania Obraz w wideo; alibaba/happyhorse-1.1/reference-to-video do zadania Wideo z referencji w polu model żądania POST /jobs/createTask.

Ile obrazów referencyjnych przyjmuje HappyHorse 1.1?

Od jednego do dziewięciu w reference-to-video, gdzie to pole jest wymagane. Wysyłaj je w kolejności, w jakiej odwołuje się do nich prompt, i daj każdemu obrazowi jedno zadanie – dziewięć nakładających się ujęć tego samego tematu zostanie uśrednionych, a nie pogodzonych.

Jakie proporcje obrazu są dostępne?

Dziewięć: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 i 21:9, domyślnie 16:9. Są wystawione w text-to-video i reference-to-video; image-to-video bierze kształt z klatki początkowej.

Czy HappyHorse 1.1 generuje dźwięk?

Tak. Klipy wracają z wygenerowaną ścieżką dźwiękową, choć żaden z trzech endpointów nie ma pola audio, więc nie da się jej wyłączyć. Opisz pożądany dźwięk w prompcie, a gdy klip idzie pod twój własny miks, wycisz albo podmień ścieżkę w montażu.

Czy mogę przypiąć ostatnią klatkę klipu?

Nie. W image-to-video nie ma pola klatki końcowej – jest tylko image_url. Jeśli ujęcie musi wylądować na konkretnej kompozycji, zrób z niej klatkę początkową odwróconego ruchu albo dojdź do niej cięciem w montażu.

Jakie rozdzielczości obsługuje?

720p i 1080p, przy czym na każdym z endpointów domyślne jest 720p. Szkicuj w 720p, a potem powtórz wybrane ujęcie w 1080p – każdy przebieg losuje własne ujęcie, więc trzymaj treść promptu bez zmian, zamiast liczyć na te same klatki.

Jakie limity ma API HappyHorse 1.1?

Długość klipu: 3–15 s; Rozdzielczości: 720p · 1080p; Proporcje obrazu: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 4:5 +3; Długość promptu (znaki): 2,500. Żądania poza tymi limitami są odrzucane, zanim cokolwiek zostanie pobrane.

Czy mogę wypróbować HappyHorse 1.1 bez pisania kodu?

Tak. Playground uruchamia HappyHorse 1.1 na twoich kredytach PopNow, nie wymaga klucza API i pokazuje kod do każdej generacji.

Więcej o HappyHorse 1.1