Alibaba: HappyHorse 1.1

Alibaba HappyHorse 1.1 generuje krátke videá so zvukom z textového zadania, jedného obrázka prvej snímky alebo až deviatich referenčných obrázkov. Jeho profily výrobcu zdôrazňujú zlepšený pohyb, detaily pokožky a konzistentnosť postáv medzi klipmi. Výstupom je 3–15-sekundové MP4 pri 24 snímkach za sekundu s možnosťami 480p, 720p alebo 1080p.

Ailoot Ultra · Video POST /v1/videos alibaba/happyhorse-1.1

O modeli

Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.

Alibaba HappyHorse 1.1 je edícia generovania videa so samostatne pomenovanými profilmi text-to-video, image-to-video z prvej snímky a reference-to-video. Výrobca zdôrazňuje zlepšené vizuálne detaily, pohyb, identitu postáv naprieč klipmi, stabilitu textu a synchronizáciu obrazu so zvukom. Výsledkom je krátke video so zvukom vhodné na produktový záber, animáciu portrétu alebo malú scénu s postavou. Vstupný režim vyberte podľa toho, čo má scénu určovať: písaný koncept, presný úvodný obrázok alebo niekoľko vizuálnych referencií.

Pri text-to-video opíšte subjekt, miesto, akciu, rámovanie, pohyb kamery a zvukový zámer. Pri krátkej akčnej scéne ukážte cyklistu zastavujúceho pri kaviarni pri rieke, zatiaľ čo sa kamera jemne približuje k zaparkovanému bicyklu. Akciu prispôsobte krátkemu klipu a opíšte záverečný okamih. Aktuálny textový návod výrobcu povoľuje najviac 5 000 nečínskych alebo 2 500 čínskych znakov a nadbytočný text oreže. Zadanie usporiadajte tak, aby jeho kľúčový subjekt a akcia boli výslovné a neboli ukryté v opakovaných prídavných menách.

Image-to-video z prvej snímky používa ako začiatok presne jeden obrázok. Na tejto statickej snímke pripravte subjekt, kompozíciu a zamýšľaný výrez a potom opíšte, čo sa má pohybovať alebo ako sa má meniť kamera. Dokumentované formáty obrázkov sú JPEG/JPG, PNG a WEBP do 20 MB, s oboma rozmermi aspoň 300 pixelov a pomerom strán od 1:2.5 do 2.5:1. Výstup sa približuje zvolenej úrovni rozlíšenia a zachováva proporcie zdrojového obrázka. Výsledok na výšku preto začína vhodnou portrétovou kompozíciou namiesto nesúvisiaceho pokynu na pomer strán.

Reference-to-video prijíma jeden až deväť obrázkov. Zadanie používa [Image 1], [Image 2] a ďalšie pozície na ich identifikáciu v poradí vstupu. Určte úlohu každej referencie a pomenujte príslušný predmet či osobu, aby sa obrázok scény nezamenil za zdroj postavy. Referenčný návod prijíma JPEG/JPG, PNG alebo WEBP do 20 MB, vyžaduje kratšiu stranu aspoň 400 pixelov a odporúča jasné referencie v 720p alebo vyššom rozlíšení. Vyhnite sa silne komprimovanej referencii, ktorej identifikačný detail už chýba.

Pri scéne s viacerými referenciami umiestnite osobu z jedného obrázka do miestnosti z druhého pri zachovaní kabáta alebo produktu dodaného tretím. Interakciu aj kameru opíšte v tom istom zadaní. Referenčný profil 1.1 vyzdvihuje stabilitu subjektov, štýlu scény a filmového pohybu; skutočný výsledok skontrolujte z hľadiska zamýšľanej identity, označení produktu a priestorového umiestnenia. Viacero obrázkov dáva zadaniu viac informácií, ale kontrola stále musí overiť, ktoré vlastnosti sa preniesli do videa.

Výrobca pre režimy generovania 1.1 uvádza výstup 480p, 720p a 1080p s dĺžkou v celých sekundách od troch do pätnástich a MP4 pri 24 snímkach za sekundu. Odpoveď API opisuje kódovanie H.264. Textové a referenčné generovanie ponúkajú formáty vrátane 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 a 21:9; generovanie z prvej snímky sa riadi vstupným obrázkom. Formát zvoľte pre cieľové umiestnenie a nechajte priestor na neskoršie titulky či prvky rozloženia. Skontrolujte skutočné rámovanie vráteného videa pri zamýšľanej veľkosti zobrazenia.

Výstup rodiny modelov obsahuje zvuk. Dajte prednesu alebo atmosfére jasnú úlohu v zadaní a každý dialóg, efekty či hudobný podklad posudzujte spolu s obrazom. Hovorený materiál udržte dostatočne krátky na akciu a pauzy namiesto vtesnávania dlhého scenára do jedného krátkeho záberu. Ak je prítomná reč, kontrolujte pohyb pier, priradenie hovoriaceho a skutočné znenie. Prijatie jazyka zadania samo osebe neurčuje zaručenú výslovnosť ani samostatný vstup hlasovej referencie.

Dokumentovaný postup výrobcu je asynchrónny: identifikátor úlohy sleduje spracovanie a úspešný výsledok poskytuje umiestnenie videa. Pri odkaze na výsledok aj zisťovaní stavu úloh je dokumentovaná platnosť dvadsaťštyri hodín. Dokončený klip, referencie a zadanie uchovajte ako záznam revízie. Návody dokumentujú aj ovládanie seedu a vodoznaku. Pevný seed môže pomôcť pri porovnaní, ale výrobca výslovne uvádza, že nezaručuje identické výsledky, preto posudzujte vrátený výstup namiesto predpokladu, že jedno nastavenie zafixuje každú snímku.

HappyHorse 1.0 a 1.1 sú samostatné edície. Výstupná tabuľka 1.1 pridáva 480p k možnostiam 720p a 1080p z 1.0 a stránky modelov 1.1 opisujú zlepšenia detailov, pohybu a konzistentnosti. Samostatne pomenovaný profil HappyHorse 1.0 na úpravu videa má vlastné vstupy a limity a nie je režimom úprav, ktorý by sa mal potichu priradiť verzii 1.1. Celý klip 1.1 skontrolujte z hľadiska identity, pohybu, rámovania, textu a zvuku a potom vykonajte konkrétnu opravu pri zachovaní úspešných častí zadania.

Ailoot Ultra · Video POST /v1/videos alibaba/happyhorse-1.1

alibaba/happyhorse-1.1

Alibaba /alibaba/happyhorse-1.1

Úvod

Povolené vstupy: Text
Výsledky: Video

Dostupné v Ailoot · vstupy a metódy

Ailoot Ultra · Video POST /v1/videos

Vstup: text
Výstup: video
Výstupný formát: mp4
Počet výstupov: Do 4 výstups

Pole	Typ	Požiadavka	Hodnoty a limity	Predvolené
Pole`model`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity alibaba/happyhorse-1.1	Predvolené—
Pole`prompt`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity Minimálna dĺžka: 1 Maximálny počet bajtov: 10 000 Jednotka: bajty UTF8	Predvolené—
Pole`duration`	Typ`integer`	PožiadavkaPovinné	Hodnoty a limity Minimum: 3 Maximum: 15 Jednotka: sekundy	Predvolené—
Pole`resolution`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity 720p	Predvolené—
Pole`aspect_ratio`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity 16:9	Predvolené—

Kombinácie vstupných podkladov

Z textu na video · Povinné: prompt

Parametre a životný cyklus metódy

Parameter	Špecifikácia
Parameter`content_type`	Špecifikáciaapplication/json
Parameter`required`	Špecifikáciamodel, prompt, duration, resolution, aspect_ratio
Parameter`other_options`	Špecifikáciafalse
Parameter`resolution`	Špecifikácia720p
Parameter`prompt_max_bytes`	Špecifikácia10000
Parameter`duration_integer_range`	Špecifikácia3, 15
Parameter`aspect_ratio`	Špecifikácia16:9
Parameter`generate_audio`	Špecifikáciamusí sa vynechať (nie false); AAC je zahrnuté
Parameter`material_types`	Špecifikáciatext
Parameter`additional_properties`	Špecifikáciafalse

Aliasy metódy: /v1/videos/generations, /videos, /videos/generations

Životný cyklus: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

Vytvorte iba raz a uložte vrátené ID.

Priebežne zisťujte pôvodný stav; zachovajte každý dokončený súbor a jeho dĺžku.

Cenník

Ako sa vypočíta konečný poplatok

Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.

Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.

Rýchly režim: Neuvedené Keď je zvolený rýchly režim
Režim Flex: Neuvedené Keď je zvolený režim flex
Maximálna úroveň uvažovania: Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)

Odhadované sadzby na porovnanie

Ceny podľa konfigurácie

Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.

Konfigurácia	Sadzobník	Odhadované množstvo	Účtovacia jednotka	Podmienky účtovania	Poplatok
KonfiguráciaZákladné sadzby za tokeny	SadzobníkZákladná sadzba	Odhadované množstvo—	Účtovacia jednotka—	Podmienky účtovania—	Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov
KonfiguráciaCena videa	Sadzobník—	Odhadované množstvo—	Účtovacia jednotkaza sekundu videa	Podmienky účtovaniaresolution: 1080p	Poplatok Výstup · Cena videa · Odhad iba na porovnanie $0.2556 za sekundu videa
KonfiguráciaCena videa	Sadzobník—	Odhadované množstvo—	Účtovacia jednotkaza sekundu videa	Podmienky účtovaniaresolution: 720p	Poplatok Výstup · Cena videa · Odhad iba na porovnanie $0.1976 za sekundu videa
KonfiguráciaOdhadované náklady na generovanie	Sadzobník—	Odhadované množstvoodhad pre jedno generovanie	Účtovacia jednotka—	Podmienky účtovania—	Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.5928 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie.

Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →

Podrobnosti referenčnej tarify

Referenčné sadzobníky modelu nemenia výber metódy, cenové odhady ani poplatky. Aktívne poplatky používajú sadzby vybranej metódy Ailoot.

Cenové referencie konfigurácií videa

Ceny podľa konfigurácie

Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.

Konfigurácia	Podmienky účtovania	Poplatok
KonfiguráciaCena videa	Podmienky účtovaniaresolution: 720p	Poplatok Výstup · Cena videa $0.1976 za sekundu videa Zverejnený cenový údaj pre zobrazenú konfiguráciu. Konečné poplatky sa riadia skutočne účtovanou konfiguráciou.
KonfiguráciaCena videa	Podmienky účtovaniaresolution: 1080p	Poplatok Výstup · Cena videa $0.2556 za sekundu videa Zverejnený cenový údaj pre zobrazenú konfiguráciu. Konečné poplatky sa riadia skutočne účtovanou konfiguráciou.

Príklady požiadaviek

Ailoot Ultra · Video

curl · presná uložená požiadavka na vytvorenie

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "alibaba/happyhorse-1.1", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 3, "resolution": "720p", "aspect_ratio": "16:9"}')

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json

Prijať a uložiť výsledky

Ailoot Ultra · Video

mp4

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

Skontrolovať stav úlohy

GET stav pôvodnej operácie

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT

Čítanie ďalšieho obsahu

Uložiť každý dokončený výstup, ktorý vám patrí

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
    urls.append((str(i),u))
for label,path in urls:
    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
    target=Path('owned-'+label+'.bin')
    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS

Uchovať všetky dokončené výsledky

Uložte každé dokončené video alebo vrátený súbor; načítajte obsah každej skutočne vrátenej URL podkladu.

Dokončené data[] obsahuje všetky podpísané URL obsahu vo vašom vlastníctve. Načítajte každú vrátenú URL alebo použite koncový bod obsahu s index nastaveným na skutočný index výstupu. Neúspešná pôvodná úloha môže vrátiť charge_pending_check; skontrolujte pôvodnú úlohu namiesto jej opätovného vytvorenia.

Ak treba overiť pôvodnú odpoveď

Načítajte existujúcu pôvodnú úlohu; odoslanie s neznámym výsledkom nikdy neopakujte.

Maximálny počet výstupov: 4.

Polia odpovede

Pole	Typ	Význam
Pole`id`	Typstring	Význam—
Pole`object`	Typstring	Význam—
Pole`model`	Typstring	Význam—
Pole`status`	Typstring	Význam—
Pole`data[]`	Typsigned content URL	Význam—
Pole`charge_pending_check`	Typboolean	Význam—
Pole`error.code`	Typstring	Význam—
Pole`error.message`	Typstring	Význam—
Pole`operation_id`	Typstring	VýznamPôvodná odpoveď stavu alebo obsahu HTTP503 result_pending_check: rovnaké pôvodné verejné ID videa ako id.
Pole`error.type`	Typstring	Významserver_error pri HTTP503 result_pending_check.

Chyby a ďalšie kroky

Odpoveď	Podmienka	Ďalší krok
Odpoveď400 · `invalid_request_error`	PodmienkaNačítanie nespracovaného tela požiadavky zlyhá pred parsovaním profilu videa	Ďalší krokZachovajte vrátenú odpoveď a opravte nečitateľné telo požiadavky.
Odpoveď422 · `price_unavailable`	PodmienkaParsovanie presného profilu videa zlyhá alebo úplný parsovaný profil nemá pripravenú presnú cenovú kartu	Ďalší krokZachovajte odpoveď; použite úplný presný povolený profil a jeho zverejnenú kartu. Táto vetva sa vykonáva pred odoslaním poskytovateľovi.
Odpoveď409 · `video_not_ready`	PodmienkaPôvodný obsah výsledku zatiaľ nie je dostupný	Ďalší krokPriebežne zisťujte stav pomocou pôvodne vráteného ID a rešpektujte Retry-After.
Odpoveď`server_error`	PodmienkaVrátená odpoveď uvádza, že operáciu alebo výsledok je potrebné skontrolovať	Ďalší krokUchovajte pôvodné vrátené ID operácie/úlohy, hlavičky požiadavky a odpoveď; naďalej čítajte údaje o tejto pôvodnej operácii podporovaným spôsobom. Požiadavku na vytvorenie znova neodosielajte.
Odpoveď503 · `result_pending_check`	PodmienkaGET pôvodného stavu alebo obsahu: úloha nie je zverejnená, pôvodná úloha nemá stav failed/cancelled/expired a miestny stav je unknown alebo je stav pôvodnej úlohy completed.	Ďalší krokZachovajte pôvodné id a operation_id (rovnaké verejné ID videa), odpoveď a hlavičky; načítavajte iba pôvodný stav alebo obsah. Nikdy neodosielajte novú požiadavku na generovanie.

Aliasy

Aliasy modelov

Ailoot Ultra alibaba/happyhorse-1.1

Aliasy ciest metód

/v1/videos/generations, /videos, /videos/generations

Súvisiace ID na volanie

alibaba/happyhorse-1.1

FAQ · Alibaba: HappyHorse 1.1

Aké vstupy a výsledky sú dostupné?: POST /v1/videos · alibaba/happyhorse-1.1: text → video
Aké polia používa požiadavka?: POST /v1/videos · alibaba/happyhorse-1.1: model, prompt, duration, resolution, aspect_ratio
Aké limity platia?: POST /v1/videos · alibaba/happyhorse-1.1: duration.minimum: 3; duration.maximum: 15

Alibaba: HappyHorse 1.1