Alibaba: HappyHorse 1.0
Alibaba HappyHorse 1.0 iz besedila, prve slike ali do devetih referenčnih slik ustvarja kratke videe z zvokom. Njegovi načini ustvarjanja izdelajo 3–15-sekundni MP4 s 24 sličicami na sekundo v 720p ali 1080p. Ločeno poimenovani profil urejanja videa 1.0 spreminja priložene posnetke z neobveznimi vizualnimi referencami in lastnimi omejitvami.
O modelu
Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.
Alibaba HappyHorse 1.0 je različica za ustvarjanje videa s poimenovanimi profili ustvarjanja iz besedila, iz slike prve sličice in iz referenc. Proizvajalec kot njen ustvarjalni poudarek opisuje fizično prepričljivo gibanje, semantično razumevanje in avdiovizualno usklajenost. Njen referenčni profil lahko uporabi do devet slik za usmerjanje motivov in prizorov. Uporabno gradivo je kratek posnetek z zvokom: nov prizor, animacija iz pripravljene začetne slike ali kader z likom oziroma izdelkom na podlagi referenc.
Pri besedilnem prizoru določite motiv, okolje, dogajanje in kamero ter želeni zvok. Pri namiznem prizoru pokažite majhno modelno jadrnico, ki se premika po plitvem pladnju z vodo, medtem ko ji kamera sledi na višini mize. Pregled lahko nato preveri obliko jadrnice, merilo prizora, gibanje vode in razmerje med gibanjem in zvokom. Osredotočeno dejanje je lažje oceniti kot gosto zaporedje, katerega bistveni trenutek ni jasno naveden.
Pri ustvarjanju iz prve sličice uporabite sliko, katere motiv in kompozicija že ustrezata želenemu začetku. Opišite gibanje, ki sledi, in pot kamere. Proizvajalčev natančni slikovni profil 1.0 sprejme besedilni in slikovni vhod, njegova matrika ustvarjanja pa ga označuje kot ustvarjanje videa iz slike prve sličice. Izrez in vidne podrobnosti izdelka ali lika pripravite pred ustvarjanjem kadra. Preverite, ali te podrobnosti ostanejo prepoznavne med gibanjem, namesto da bi ocenjevali le začetno sličico.
Ustvarjanje iz referenc združuje ljudi, izdelke, slog ali okolje iz vizualnih virov v na novo opisan prizor. Stran natančnega referenčnega modela 1.0 dokumentira do devet slik. V opisu dodelite njihove vloge in opišite, kako naj motiv deluje v prizoru. Predstavitev izdelka lahko loči referenco predmeta od okoliške lokacije ali vizualnega sloga. Proizvajalčev poudarek na stabilnosti je cilj pregleda: motiv, oznake in postavitev skozi celoten posnetek primerjajte z dejanskimi referencami.
Družina 1.0 ima tudi ločeno poimenovan profil urejanja videa za spremembe sloga ter lokalne ali širše popravke obstoječih posnetkov. Ta profil sprejme natanko en izvorni video in od nič do pet referenčnih slik, namesto razporeditve z devetimi slikami pri ustvarjanju iz referenc. Navedite, kaj naj se spremeni in kaj ostane, denimo sprememba oblačila ob ohranitvi osebe, gibanja in ozadja. Rezultat urejanja je treba primerjati s celotnim izvornim posnetkom, ne le s sličico, ki kaže predvideno zamenjavo.
Natančni vodič za urejanje 1.0 sprejme izvorne posnetke MP4 ali MOV, priporoča H.264 in dovoljuje dolžino vira od treh do šestdesetih sekund. Navaja največ 100 MB, krajšo stranico vsaj 360 pikslov, daljšo največ 4.096 pikslov, razmerja med 1:2.5 in 2.5:1 ter vhodno hitrost od osem do šestdeset sličic na sekundo. Izhodne ureditve so omejene na tri do petnajst sekund: viri do petnajstih sekund ohranijo dolžino, daljši pa uporabijo le prvih petnajst sekund. Če se pomembno dejanje zgodi pozneje v viru, pred pripravo urejanja izrežite želeni odsek.
Neobvezne referenčne slike profila urejanja imajo lastno omejitev dvajset MB in zahteve formatov JPEG/JPG, PNG ali WEBP, pri čemer morata obe meri doseči vsaj 300 pikslov in veljati isti dokumentirani razpon razmerij. Vodič razlikuje tudi med samodejno obravnavo zvoka in ohranitvijo izvirnega zvoka. Pripravite referenco, ki določa predvideno spremembo, in izberite, kako naj se izvorni zvok poveže z njo. To so posebne možnosti profila urejanja 1.0, ločene od načinov ustvarjanja novih prizorov.
Za načine ustvarjanja 1.0 proizvajalčeva natančna matrika navaja 720p ali 1080p, tri do petnajst sekund, MP4 s 24 sličicami na sekundo in zvok. Profil urejanja prav tako vrne 720p ali 1080p v okviru svoje petnajstsekundne omejitve. Dokumentirani potek opravila najprej vrne identifikator obdelave, po uspehu pa lokacijo končnega videa; lokacije rezultatov veljajo štiriindvajset ur. Pri pripravi produkcijske montaže shranite dejanski posnetek, poziv in reference ter skupaj preverite vrnjeno kadriranje, dolžino in zvok.
HappyHorse 1.1 dodaja možnost ustvarjanja v 480p in poimenovane izboljšave vizualnih podrobnosti, gibanja ter doslednosti med posnetki. Te poznejše trditve o ustvarjanju niso jamstvo izboljšave nespremenjenega profila 1.0. Uporabna priprava 1.0 sledi izbranemu načinu in njegovemu dejanskemu izvornemu gradivu. Preverite identiteto, stik, geometrijo predmetov, besedilo in zvok, nato naslednji popravek konkretno določite. Pri urejenem posnetku preverite tudi, ali pomembne izvorne podrobnosti zunaj zahtevane spremembe ostajajo ustrezne za predvideni prizor.
Ailoot Ultra · Video POST /v1/videos alibaba/happyhorse-1.0
alibaba/happyhorse-1.0Začetek
Alibaba HappyHorse 1.0 iz besedila, prve slike ali do devetih referenčnih slik ustvarja kratke videe z zvokom. Njegovi načini ustvarjanja izdelajo 3–15-sekundni MP4 s 24 sličicami na sekundo v 720p ali 1080p. Ločeno poimenovani profil urejanja videa 1.0 spreminja priložene posnetke z neobveznimi vizualnimi referencami in lastnimi omejitvami.
- Dovoljeni vhodi
- Besedilo · Slike
- Rezultati
- Video
Na voljo v Ailoot · vhodi in metode
Ailoot Ultra · Video POST /v1/videos
- Vhod
text,image- Izhod
video- Izhodni format
- izvirni bajti MP4; brez normalizacije ali prekodiranja
| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve alibaba/happyhorse-1.0 | Privzeto— |
Poljeprompt | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve | Privzeto— |
Poljeduration | Vrstainteger | ZahtevaObvezno | Vrednosti in omejitve 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Najmanj: 1 Največ: 600 | Privzeto— |
Poljeresolution | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 720p, 1080p | Privzeto— |
Poljeaspect_ratio | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 9:21 | Privzeto— |
Poljegenerate_audio | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve false | Privzeto— |
Poljeframe_images | Vrstaarray | ZahtevaIzbirno | Vrednosti in omejitve Najmanjše število elementov: 1 Največ elementov: 1 Vhodna vsebina: Polje objektov sličic. Vsak objekt vsebuje type=image_url, image_url z url in frame_type. Uporabite URL slike HTTPS in nastavite frame_type na first_frame. Vsaka vloga sličice se lahko pojavi največ enkrat. Natančni ključi: type, image_url, frame_type Pogoji: Ti ključi opisujejo vsak objekt sličice; image_url vsebuje samo url. Pri zahtevi samo z besedilom izpustite frame_images. | Privzeto— |
Poljeinput_references | Vrstaarray | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljesize | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 1280x720, 720x1280, 720x720, 960x720, 720x960, 1680x720, 720x1680, 1920x1080, 1080x1920, 1080x1080, 1440x1080, 1080x1440, 2520x1080, 1080x2520 Vzorec: ^[1-9][0-9]*x[1-9][0-9]*$ | Privzeto— |
Poljeseed | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: −9.223.372.036.854.775.808 Največ: 9.223.372.036.854.775.807 | Privzeto— |
Poljecallback_url | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Vzorec: ^https:// | Privzeto— |
Poljesession_id | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljetrace | Vrstaobject | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljeuser | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Kombinacije vhodnih gradiv
Iz besedila v video · Pisni poziv. · Obvezno: model, prompt, duration
Podajte prompt kot besedilo in duration v celih sekundah. Izberite podprto ločljivost; dodajte razmerje stranic ali uporabite navedeno velikost.
model: Vrsta: string · alibaba/happyhorse-1.0
prompt: Vrsta: string · Največ bajtov UTF-8: 10.000 · Zahtevan je vsaj en znak, ki ni beli znak: Da
Iz slike v video · Pisni poziv in slika prve sličice. · Obvezno: model, prompt, duration, frame_images
frame_images je polje. Vsak objekt sličice vsebuje type, image_url in frame_type; image_url vsebuje url. Nastavite type na image_url. Uporabite first_frame. Vsaka vloga sličice se lahko pojavi največ enkrat. Za vsako sličico podajte javni URL slike HTTPS. Izberite podprto ločljivost; dodajte razmerje stranic ali uporabite navedeno velikost.
Natančni ključi: type, image_url, frame_type
model: Vrsta: string · alibaba/happyhorse-1.0
prompt: Vrsta: string · Največ bajtov UTF-8: 10.000 · Zahtevan je vsaj en znak, ki ni beli znak: Da
Reference to video · Pisni poziv in podprte slikovne reference. · Obvezno: model, prompt, duration, input_references
input_references je polje objektov. Nastavite type na image_url in uporabite ustrezno istoimensko polje, ki vsebuje url. Uporabite javne URL-je HTTPS. Za izbiro referenčnega načina izpustite frame_images. Izberite podprto ločljivost; dodajte razmerje stranic ali uporabite navedeno velikost.
model: Vrsta: string · alibaba/happyhorse-1.0
prompt: Vrsta: string · Največ bajtov UTF-8: 10.000 · Zahtevan je vsaj en znak, ki ni beli znak: Da
Parametri in življenjski cikel metode
| Parameter | Specifikacija |
|---|---|
Parametercontent_type | Specifikacijaapplication/json |
Parameterrequired | Specifikacijamodel, prompt, duration |
Parametermaterial_types | Specifikacijatext, image |
Parameteradditional_properties | Specifikacijafalse |
Parameteroptional_controls | Specifikacijaresolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, callback_url, session_id, trace, user |
Življenjski cikel: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Cenik
Kako se izračuna končni strošek
Prikazane cene so namenjene oceni stroškov pred generiranjem. Končni znesek se izračuna na podlagi stroška, zabeleženega za izvirno generiranje. Izmerjeno trajanje izhoda in napovedane količine niso končna obračunska količina.
Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.
- Hitri način
- Ni navedeno Ko je izbran hitri način
- Način flex
- Ni navedeno Ko je izbran način flex
- Najvišja raven razmišljanja
- Ni navedeno Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default)
Ocenjene cene za primerjavo
Cene po nastavitvah
Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.
| Nastavitev | Cenovna lestvica | Predvidena količina | Obračunska enota | Obračunski pogoji | Strošek |
|---|---|---|---|---|---|
| NastavitevOsnovne cene žetonov | Cenovna lestvicaOsnovna cena | Predvidena količina— | Obračunska enota— | Obračunski pogoji— | Strošek Vhod · Vhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Izhod · Izhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Vhod · Branje predpomnilnika · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura · Ocena samo za primerjavo — / 1K žetonov |
| NastavitevCena videa | Cenovna lestvica— | Predvidena količina— | Obračunska enotana sekundo videa | Obračunski pogojiresolution: 1080p | Strošek Izhod · Cena videa · Ocena samo za primerjavo $0.3388 na sekundo videa |
| NastavitevCena videa | Cenovna lestvica— | Predvidena količina— | Obračunska enotana sekundo videa | Obračunski pogojiresolution: 720p | Strošek Izhod · Cena videa · Ocena samo za primerjavo $0.1976 na sekundo videa |
| NastavitevOcenjeni strošek ustvarjanja | Cenovna lestvica— | Predvidena količinaocena za eno generiranje | Obračunska enota— | Obračunski pogoji— | Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo $0.5928 ocena pred ustvarjanjem Ta ocena ni dodatno plačilo ali fiksna cena za dokončano generiranje. |
Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →
Podrobnosti referenčne tarife
Referenčne lestvice modela ne spreminjajo izbire metode, ocen cen ali stroškov. Veljavni stroški uporabljajo cene izbrane metode Ailoot.
Cenovne reference konfiguracij videa
Cene po nastavitvah
Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.
| Nastavitev | Obračunski pogoji | Strošek |
|---|---|---|
| NastavitevCena videa | Obračunski pogojiresolution: 720p | Strošek Izhod · Cena videa $0.1976 na sekundo videa Objavljena referenčna cena za prikazano konfiguracijo. Končni zneski sledijo dejansko obračunani konfiguraciji. |
| NastavitevCena videa | Obračunski pogojiresolution: 1080p | Strošek Izhod · Cena videa $0.3388 na sekundo videa Objavljena referenčna cena za prikazano konfiguracijo. Končni zneski sledijo dejansko obračunani konfiguraciji. |
Primeri zahtev
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":3,"model":"alibaba/happyhorse-1.0","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
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
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.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
Prejmi in shrani rezultate
Ailoot Ultra · Video
podpisani URL-ji vsebine v vaši lasti
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Preveri stanje opravila
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
Branje druge vsebine
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
Ohrani vse dokončane rezultate
Shranite vsak dokončan video ali vrnjeno datoteko; pridobite vsebino z vsake dejansko vrnjene URL gradiva.
Ohranite vsak dejanski izhod v vaši lasti in njegove vrnjene izmerjene metapodatke.
Če je treba preveriti izvirni odgovor
503 result_pending_check + prvotni id + X-Should-Retry:false; prvotne zahteve nikoli ne ponovite
Polja odgovora
| Polje | Vrsta | Pomen |
|---|---|---|
Poljeindex | Vrstainteger | PomenPoložaj tega videa na seznamu izhodov, štet od nič. |
Poljecontent_url | Vrstastring | PomenPodpisani URL HTTPS za prenos tega dokončanega videa. |
Poljesha256 | Vrstastring | null | PomenIzvleček SHA-256 izvirnih video bajtov; null, če ni na voljo. |
Poljesize_bytes | Vrstainteger | null | PomenVelikost izvirne video datoteke v bajtih; null, če ni na voljo. |
Poljeduration_ms | Vrstainteger | null | PomenIzmerjeno trajanje videa v milisekundah; null, če ni na voljo. |
Poljewidth | Vrstainteger | null | PomenŠirina videa v slikovnih pikah; null, če ni na voljo. |
Poljeheight | Vrstainteger | null | PomenVišina videa v slikovnih pikah; null, če ni na voljo. |
Poljevideo_codec | Vrstastring | null | PomenIdentifikator video kodeka; null, če ni zabeležen. |
Poljehas_audio | Vrstaboolean | null | PomenAli video vsebuje zvočno sled; null, če ni izmerjeno. |
Poljeaudio_codec | Vrstastring | null | PomenIdentifikator zvočnega kodeka; null, kadar identifikator ni zabeležen. |
Napake in naslednji koraki
| Odgovor | Pogoj | Naslednji korak |
|---|---|---|
Odgovor404 · not_found_error | PogojDostop do videa ni na voljo ali ta ID videa ni bil najden. | Naslednji korakPreverite dostop do videa. Za obstoječi video uporabite njegov prvotni javni ID in isti ključ API. |
Odgovor401 · authentication_error | PogojKljuč API se ne ujema z overjenim računom. | Naslednji korakPred oddajo preverite svoj ključ API in dostop do računa. |
Odgovor400 · invalid_request_error | PogojZahteve ni bilo mogoče prebrati ali je indeks prenosa neveljaven. | Naslednji korakPopravite telo zahteve. Pri prenosu izberite indeks izhoda, ki ga je vrnilo prvotno opravilo. |
Odgovor422 · price_unavailable | PogojIzbrane video konfiguracije ni mogoče ovrednotiti. | Naslednji korakIzberite podprto konfiguracijo videa in izpolnite njene obvezne možnosti, preden oddate popravljeno zahtevo. |
Odgovor422 · invalid_request_error | PogojVideo vhod ali prvotno nadaljevalno opravilo ni veljavno. | Naslednji korakUporabite veljavne vhode HTTPS. Za nadaljevanje uporabite javni ID svojega dokončanega prvotnega videa z istim ključem API. |
Odgovor402 · billing_error | PogojRazpoložljivo dobroimetje ali omejitve ne omogočajo rezervacije. | Naslednji korakPreden pošljete novo zahtevo, preverite razpoložljivo dobroimetje in omejitve. |
Odgovor503 · server_error | PogojPreverjanje videa, shramba ali dostop do storitve začasno ni na voljo. | Naslednji korakPočakajte, da bo storitev na voljo. Če že imate ID videa, preverite to prvotno opravilo, namesto da ustvarite novo generacijo. |
Odgovor503 · result_pending_check | PogojPrvotni video rezultat in zaračunani znesek je treba preveriti. | Naslednji korakOhranite vrnjeni ID videa in preverjajte to opravilo. Med preverjanjem ne pošljite nadomestne zahteve za ustvarjanje. |
Odgovor503 · owned_result_unavailable | PogojPrenos obstoječega videa začasno ni na voljo. | Naslednji korakPozneje preverite isto video opravilo in prenesite njegov obstoječi izhod. Novo ustvarjanje ustvari ločeno operacijo. |
Odgovor409 · video_not_ready | PogojVideo vsebina ni objavljena. | Naslednji korakPreverite stanje prvotnega opravila. Prenesite, ko sporoči completed; če sporoči failed, upoštevajte njegovo obvestilo o preverjanju zaračunanega zneska. |
Druga imena
Druga imena modelov
Ailoot Ultra alibaba/happyhorse-1.0
Druga imena poti metod
Uporabite zgoraj navedene poti metod.
Povezani ID-ji za klic
FAQ · Alibaba: HappyHorse 1.0
- Kateri vhodi in rezultati so na voljo?
POST /v1/videos·alibaba/happyhorse-1.0:text,image→video- Katera polja uporablja zahteva?
POST /v1/videos·alibaba/happyhorse-1.0:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,seed,callback_url,session_id,trace,user- Katere omejitve veljajo?
POST /v1/videos·alibaba/happyhorse-1.0:duration.minimum:1;duration.maximum:600;frame_images.max_items:1;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807