Alibaba: HappyHorse 1.1
Az Alibaba HappyHorse 1.1 szöveges leírásból, egy első képkockából vagy legfeljebb kilenc referenciaképből készít rövid, hangos videókat. Gyártói profiljai a javított mozgást, bőrrészletezést és klipek közötti karakterkövetkezetességet hangsúlyozzák. Kimenete 3–15 másodperces MP4 24 fps mellett, 480p, 720p vagy 1080p lehetőséggel.
A modellről
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
Az Alibaba HappyHorse 1.1 videógeneráló kiadás külön megnevezett szöveg-videó, első képkockás kép-videó és referencia-videó profilokkal. A gyártó a jobb képi részletezést, mozgást, klipek közötti karakterazonosságot, szövegstabilitást és kép-hang szinkront hangsúlyozza. Az eredmény rövid, hangos videó, amely termékfelvételhez, portréanimációhoz vagy kis karakterjelenethez hasznos. A bemeneti módot annak alapján válaszd, mi határozza meg a jelenetet: írott koncepció, pontos nyitókép vagy több vizuális referencia.
Szöveg-videó módban írd le a témát, helyszínt, cselekvést, képkivágást, kameramozgást és hangszándékot. Rövid akciójelenetben egy kerékpáros álljon meg folyóparti kávézó mellett, miközben a kamera finoman a leparkolt kerékpár felé mozdul. A cselekvés illjen rövid kliphez, és a végső pillanatot is írd le. A gyártó jelenlegi szöveges útmutatója legfeljebb 5 000 nem kínai vagy 2 500 kínai karaktert enged, a többletet levágja. Úgy szervezd a leírást, hogy lényegi témája és cselekvése egyértelmű legyen, ne ismétlődő jelzők közé temetve szerepeljen.
Az első képkockás kép-videó mód pontosan egy képet használ nyitásként. Ebben az állóképben készítsd elő a témát, kompozíciót és kívánt kivágást, majd írd le, minek kell mozognia vagy hogyan változzon a kamera. A dokumentált képformátum JPEG/JPG, PNG és WEBP, legfeljebb 20 MB-tal, mindkét irányban legalább 300 pixellel és 1:2.5 és 2.5:1 közötti oldalaránnyal. A kimenet megközelíti a kiválasztott felbontási szintet, miközben megőrzi a forráskép arányait. Az álló eredmény tehát megfelelő álló kompozícióval indul, nem egy független oldalarány-utasítással.
A referencia-videó mód egy–kilenc képet fogad. A prompt [Image 1], [Image 2] és további pozíciók használatával azonosítja őket bemeneti sorrendben. Add meg minden referencia szerepét és nevezd meg a releváns tárgyat vagy személyt, hogy a jelenetképet ne tévessze össze karakterforrással. A referenciaútmutató JPEG/JPG, PNG vagy WEBP képet fogad legfeljebb 20 MB-tal; a legrövidebb oldal legyen legalább 400 pixel, és tiszta, legalább 720p-s referenciát ajánl. Kerüld az erősen tömörített referenciát, amelyből az azonosító részlet már hiányzik.
Több referenciás jelenetben helyezd az egyik képen látható személyt a másik szobájába, egy harmadik képről származó kabát vagy termék megtartásával. Ugyanabban a leírásban add meg a kölcsönhatást és a kamerát. Az 1.1 referenciaprofil a témák, jelenetstílus és filmszerű mozgás stabilitását emeli ki; a tényleges eredményen ellenőrizd a kívánt azonosságot, termékjelöléseket és térbeli elhelyezést. Több kép több információt ad a leírásnak, az ellenőrzésnek azonban továbbra is vizsgálnia kell, mely jellemzők kerültek át a videóba.
A gyártó az 1.1 generálási módjaihoz 480p, 720p és 1080p kimenetet sorol fel, egész másodpercben három–tizenöt másodperces időtartammal és 24 fps-es MP4-gyel. Az API-válasz H.264 kódolást ír le. A szöveges és referenciagenerálás formái között 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 és 21:9 szerepel; az első képkockás generálás a bemeneti képet követi. A célfelülethez válassz formát, és hagyj helyet későbbi feliratoknak vagy elrendezési elemeknek. A visszaadott videó tényleges képkivágását a tervezett megjelenítési méretben vizsgáld meg.
A modellcsalád kimenete hangot tartalmaz. Az előadásmódnak vagy hangulatnak adj világos szerepet a leírásban, és minden párbeszédet, effektust vagy háttérsávot a képpel együtt ellenőrizz. A beszélt anyag legyen elég rövid a cselekvéshez és szünetekhez, ne hosszú forgatókönyvet zsúfolj egyetlen rövid felvételbe. Beszédnél ellenőrizd az ajakmozgást, a beszélőhöz rendelést és a tényleges szöveget. A prompt nyelvének elfogadása önmagában nem határoz meg garantált kiejtést vagy külön hangreferencia-bemenetet.
A dokumentált gyártói folyamat aszinkron: feladatazonosító követi a feldolgozást, siker esetén pedig megkapod a videó helyét. Az eredménylinkhez és feladatlekérdezésekhez huszonnégy órás érvényességi időt dokumentálnak. Módosítási nyilvántartásként őrizd meg a kész klipet, referenciákat és promptot. Az útmutatók seed- és vízjelvezérlőket is dokumentálnak. A rögzített seed segítheti az összevetést, de a gyártó kifejezetten kimondja, hogy nem garantál azonos eredményt, ezért a visszaadott alkotást értékeld, ne feltételezd, hogy egyetlen beállítás minden képkockát rögzít.
A HappyHorse 1.0 és 1.1 külön kiadás. Az 1.1 kimeneti táblázata az 1.0 720p és 1080p lehetőségeihez 480p-t ad, az 1.1 modelloldalai pedig részletezés-, mozgás- és következetességbeli fejlesztéseket írnak le. A külön megnevezett HappyHorse 1.0 videószerkesztési profilnak saját bemenetei és korlátai vannak, és nem rendelhető észrevétlenül szerkesztési módként az 1.1-hez. Ellenőrizd a teljes 1.1 klip azonosságát, mozgását, képkivágását, szövegét és hangját, majd végezz konkrét javítást a leírás sikeres részeinek megőrzésével.
Ailoot Ultra · Videó POST /v1/videos alibaba/happyhorse-1.1
alibaba/happyhorse-1.1Kezdő lépések
Az Alibaba HappyHorse 1.1 szöveges leírásból, egy első képkockából vagy legfeljebb kilenc referenciaképből készít rövid, hangos videókat. Gyártói profiljai a javított mozgást, bőrrészletezést és klipek közötti karakterkövetkezetességet hangsúlyozzák. Kimenete 3–15 másodperces MP4 24 fps mellett, 480p, 720p vagy 1080p lehetőséggel.
- Elfogadott bemenetek
- Szöveg
- Eredmények
- Videó
Elérhető az Ailootban · bemenetek és metódusok
Ailoot Ultra · Videó POST /v1/videos
- Bemenet
text- Kimenet
video- Kimeneti formátum
- mp4
- Kimenetek száma
- Legfeljebb 4 kimenets
| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok alibaba/happyhorse-1.1 | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok Minimális hossz: 1 Maximális bájtszám: 10 000 Egység: UTF8-bájtok | Alapértelmezett— |
Meződuration | Típusinteger | KövetelményKötelező | Értékek és korlátok Minimum: 3 Maximum: 15 Egység: másodperc | Alapértelmezett— |
Mezőresolution | Típusstring | KövetelményKötelező | Értékek és korlátok 720p | Alapértelmezett— |
Mezőaspect_ratio | Típusstring | KövetelményKötelező | Értékek és korlátok 16:9 | Alapértelmezett— |
Bemeneti anyagok kombinációi
Szövegből videó · Kötelező: prompt
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, prompt, duration, resolution, aspect_ratio |
Paraméterother_options | Szerződésfalse |
Paraméterresolution | Szerződés720p |
Paraméterprompt_max_bytes | Szerződés10000 |
Paraméterduration_integer_range | Szerződés3, 15 |
Paraméteraspect_ratio | Szerződés16:9 |
Paramétergenerate_audio | Szerződésel kell hagyni (nem false értékkel megadni); AAC szerepel benne |
Paramétermaterial_types | Szerződéstext |
Paraméteradditional_properties | Szerződésfalse |
Metódus álnevei: /v1/videos/generations, /videos, /videos/generations
Életciklus: 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
Hozza létre egyszer, és mentse el a visszaadott azonosítót.
Kérdezze le az eredeti állapotot; őrizzen meg minden elkészült médiaállományt és időtartamot.
Díjcsomagok
A végső díj számítása
A megjelenített díjtételek a generálás előtti költségbecsléshez szolgálnak. A végleges díj az eredeti generáláshoz rögzített költségből számítódik. A kimenet mért időtartama és az előre jelzett mennyiségek nem azonosak a véglegesen elszámolandó mennyiséggel.
A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.
- Gyors mód
- Nincs megadva Ha a gyors mód van kiválasztva
- Flex mód
- Nincs megadva Ha a flex mód van kiválasztva
- Maximális gondolkodási ráfordítás
- Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik
Becsült díjak összehasonlításhoz
Árak beállításonként
Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.
| Beállítás | Díjtáblázat | Előre jelzett mennyiség | Elszámolási egység | Elszámolási feltételek | Díj |
|---|---|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Előre jelzett mennyiség— | Elszámolási egység— | Elszámolási feltételek— | Díj Bemenet · Bemeneti tokenek · Becslés, csak összehasonlításra — / 1K token Kimenet · Kimeneti tokenek · Becslés, csak összehasonlításra — / 1K token Bemenet · Gyorsítótár olvasása · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra · Becslés, csak összehasonlításra — / 1K token |
| BeállításVideó ára | Díjtáblázat— | Előre jelzett mennyiség— | Elszámolási egységvideómásodpercenként | Elszámolási feltételekresolution: 1080p | Díj Kimenet · Videó ára · Becslés, csak összehasonlításra $0.2556 videómásodpercenként |
| BeállításVideó ára | Díjtáblázat— | Előre jelzett mennyiség— | Elszámolási egységvideómásodpercenként | Elszámolási feltételekresolution: 720p | Díj Kimenet · Videó ára · Becslés, csak összehasonlításra $0.1976 videómásodpercenként |
| BeállításA generálás becsült költsége | Díjtáblázat— | Előre jelzett mennyiségbecslés egy generálásra | Elszámolási egység— | Elszámolási feltételek— | Díj Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra $0.5928 becslés a generálás előtt Ez a becslés nem jelent további díjat, és nem rögzített díjszabás az elkészült generálásra. |
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
A referencia-díjszabás részletei
A modellszintű referenciatáblázatok nem módosítják a metódusválasztást, az árajánlatokat vagy a díjakat. A tényleges díjak a kiválasztott Ailoot-metódus díjtételeit használják.
Videóbeállítások árhivatkozásai
Árak beállításonként
Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.
| Beállítás | Elszámolási feltételek | Díj |
|---|---|---|
| BeállításVideó ára | Elszámolási feltételekresolution: 720p | Díj Kimenet · Videó ára $0.1976 videómásodpercenként A megjelenített konfiguráció közzétett árreferenciája. A végleges díjak a ténylegesen elszámolt konfigurációt követik. |
| BeállításVideó ára | Elszámolási feltételekresolution: 1080p | Díj Kimenet · Videó ára $0.2556 videómásodpercenként A megjelenített konfiguráció közzétett árreferenciája. A végleges díjak a ténylegesen elszámolt konfigurációt követik. |
Példakérések
Ailoot Ultra · Videó
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
Eredmények fogadása és mentése
Ailoot Ultra · Videó
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Feladatállapot ellenőrzése
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
További tartalomlekérések
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
Őrizzen meg minden elkészült eredményt
Mentsen minden elkészült videót és visszaadott fájlt; töltse le az összes ténylegesen visszaadott médiafájl URL-jének tartalmát.
A befejezett data[] az összes saját aláírt tartalom-URL-címet tartalmazza. Kérje le mindegyik visszaadott URL-címet, vagy használja a tartalomvégpontot egy tényleges kimeneti indexre állított index értékkel. Egy sikertelen eredeti feladat charge_pending_check értéket adhat vissza; azt az eredeti feladatot ellenőrizze, ne hozza létre újra.
Ha az eredeti választ ellenőrizni kell
A meglévő eredeti feladatot kérdezze le; ismeretlen kimenetelű küldést soha ne küldjön be újra.
Maximális kimenetszám: 4.
Válaszmezők
| Mező | Típus | Jelentés |
|---|---|---|
Mezőid | Típusstring | Jelentés— |
Mezőobject | Típusstring | Jelentés— |
Mezőmodel | Típusstring | Jelentés— |
Mezőstatus | Típusstring | Jelentés— |
Meződata[] | Típussigned content URL | Jelentés— |
Mezőcharge_pending_check | Típusboolean | Jelentés— |
Mezőerror.code | Típusstring | Jelentés— |
Mezőerror.message | Típusstring | Jelentés— |
Mezőoperation_id | Típusstring | JelentésHTTP503 result_pending_check válasz az eredeti status/content lekérdezésre: az id ugyanaz az eredeti nyilvános videóazonosító. |
Mezőerror.type | Típusstring | Jelentésserver_error a HTTP503 result_pending_check válasznál. |
Hibák és következő lépések
| Válasz | Feltétel | Következő lépés |
|---|---|---|
Válasz400 · invalid_request_error | FeltételA nyers kéréstörzs beolvasása a videóprofil feldolgozása előtt sikertelen | Következő lépésŐrizze meg a visszaadott választ, és javítsa az olvashatatlan kéréstörzset. |
Válasz422 · price_unavailable | FeltételA pontos videóprofil feldolgozása sikertelen, vagy a teljes feldolgozott profilhoz nincs kész, pontos árkártya | Következő lépésŐrizze meg a választ; használja a teljes, pontosan engedélyezett profilt és annak közzétett árkártyáját. Ez az ág a szolgáltatónak történő küldés előtt fut le. |
Válasz409 · video_not_ready | FeltételAz eredeti eredmény tartalma még nem érhető el | Következő lépésKérdezze le az eredetileg visszaadott azonosítót, és tartsa be a Retry-After előírását. |
Válaszserver_error | FeltételA visszaadott válasz szerint a művelet vagy az eredmény ellenőrzést igényel | Következő lépésŐrizze meg az eredetileg visszaadott művelet- vagy feladatazonosítót, a kérés fejléceit és a választ; folytassa az eredeti művelet támogatott lekérdezéseit. Ne küldje be újra a létrehozási kérést. |
Válasz503 · result_pending_check | FeltételAz eredeti status/content GET lekérdezésekor: a feladat nincs közzétéve, az eredeti feladat állapota nem failed/cancelled/expired, és a helyi állapot unknown, vagy az eredeti feladat állapota completed. | Következő lépésŐrizze meg az eredeti id és operation_id értéket (ugyanaz a nyilvános videóazonosító), a választ és a fejléceket; csak az eredeti status/content értéket kérdezze le. Soha ne küldjön be új generálási kérést. |
Álnevek
Modell álnevei
Ailoot Ultra alibaba/happyhorse-1.1
Metódusútvonalak álnevei
/v1/videos/generations, /videos, /videos/generations
Kapcsolódó modellazonosítók
FAQ · Alibaba: HappyHorse 1.1
- Milyen bemenetek és eredmények érhetők el?
POST /v1/videos·alibaba/happyhorse-1.1:text→video- Mely mezőket használja a kérés?
POST /v1/videos·alibaba/happyhorse-1.1:model,prompt,duration,resolution,aspect_ratio- Milyen korlátok érvényesek?
POST /v1/videos·alibaba/happyhorse-1.1:duration.minimum:3;duration.maximum:15