Ten poradnik jest na razie tylko po angielsku. →
Parametry żądania
| Parametr | Wymagany | Opis |
|---|---|---|
duration_seconds | Nie | Długość klipu. Płacisz za każdą sekundę. ≥ 3 · ≤ 15 · Domyślnie: 5 |
image_url | Tak | Obraz, od którego zaczynasz. |
prompt | Tak | Describe the scene, action, camera movement, and timing. |
resolution | Nie | Rozmiar wyniku. Większy jest ostrzejszy i droższy. 720p · 1080p · Domyślnie: 720p |
seed | Nie | Ta sama liczba daje powtarzalny wynik. ≥ 0 · ≤ 2147483647 |
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ą.
| Opcja | Kredyty za sekundę | ≈ USD |
|---|---|---|
| resolution 720p | 21 | 0,21 USD |
| resolution 1080p | 27 | 0,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
- 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.
- Wyślij żądanie. Wyślij POST /jobs/createTask z model alibaba/happyhorse-1.1/image-to-video i obiektem input zgodnym z tabelą parametrów. Odpowiedź od razu zwraca ID zadania.
- 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/image-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"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 „Obraz w 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; 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.

