HappyHorse-1.1-R2V ustvarja novo videosceno na podlagi referenčnih slik in besedilnega navodila. Alibaba model usmerja v ohranjanje prepoznavnih likov, objektov in vizualnega sloga pri ustvarjanju gibanja. Reference določajo vsebino in videz scene, besedilo pa opisuje, kako naj ti elementi medsebojno delujejo.
Uporabite lahko od ene do devet slik. Te lahko določajo lik, predmet, okolje ali umetniško izvedbo. V opisu lahko navedete številko reference in konkreten objekt na njej, da vizualno gradivo povežete z ustreznim delom dogajanja. To je zlasti koristno, kadar je treba elemente več slik združiti v eno kompozicijo.
V nasprotju z načinom z začetnim kadrom reference tu služijo kot opora za vsebino nove scene. Besedilno navodilo je obvezno: videz objektov povezuje z dogajanjem, gibanjem kamere in celotno postavitvijo. Proizvajalec izpostavlja vizualno skladnost in filmsko gibanje; rezultat ostaja generirana vsebina in ne montaža izvirnih slik.
Sprejeti so formati JPEG, JPG, PNG in WEBP, vsak z velikostjo do 20 MB. Krajša stranica slike mora imeti najmanj 400 slikovnih pik; priporočeno je gradivo z ločljivostjo 720P ali višjo. Vhod v ta način sestavljajo prav slike in besedilo.
Rezultat se shrani v MP4 s hitrostjo 24 sličic na sekundo. Trajanje določite kot celo število od 3 do 15 sekund. Izbirate lahko med ločljivostmi 480P, 720P in 1080P; podprto je ustvarjanje zvočne spremljave.
Na voljo so ležeči, pokončni in kvadratni kadri: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 in 21:9. Izbira formata pomaga vnaprej določiti kompozicijski prostor nove scene.
Besedilo je lahko v katerem koli jeziku. Omejitev znaša 5000 nekitajskih ali 2500 kitajskih znakov, presežni del pa se zavrže. Najpomembnejše vloge referenc, dogajanje in gibanje morajo biti opisani znotraj tega obsega. Začetno naključno seme lahko usmerja podobnost različic, ne zagotavlja pa natančne ponovitve posameznega posnetka.
", "aboutText": "HappyHorse-1.1-R2V ustvarja novo videosceno na podlagi referenčnih slik in besedilnega navodila. Alibaba model usmerja v ohranjanje prepoznavnih likov, objektov in vizualnega sloga pri ustvarjanju gibanja. Reference določajo vsebino in videz scene, besedilo pa opisuje, kako naj ti elementi medsebojno delujejo.\n\n### Vloge vizualnih vzorcev\n\nUporabite lahko od ene do devet slik. Te lahko določajo lik, predmet, okolje ali umetniško izvedbo. V opisu lahko navedete številko reference in konkreten objekt na njej, da vizualno gradivo povežete z ustreznim delom dogajanja. To je zlasti koristno, kadar je treba elemente več slik združiti v eno kompozicijo.\n\nV nasprotju z načinom z začetnim kadrom reference tu služijo kot opora za vsebino nove scene. Besedilno navodilo je obvezno: videz objektov povezuje z dogajanjem, gibanjem kamere in celotno postavitvijo. Proizvajalec izpostavlja vizualno skladnost in filmsko gibanje; rezultat ostaja generirana vsebina in ne montaža izvirnih slik.\n\nSprejeti so formati JPEG, JPG, PNG in WEBP, vsak z velikostjo do 20 MB. Krajša stranica slike mora imeti najmanj 400 slikovnih pik; priporočeno je gradivo z ločljivostjo 720P ali višjo. Vhod v ta način sestavljajo prav slike in besedilo.\n\n### Trajanje, kader in zvok\n\nRezultat se shrani v MP4 s hitrostjo 24 sličic na sekundo. Trajanje določite kot celo število od 3 do 15 sekund. Izbirate lahko med ločljivostmi 480P, 720P in 1080P; podprto je ustvarjanje zvočne spremljave.\n\nNa voljo so ležeči, pokončni in kvadratni kadri: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 in 21:9. Izbira formata pomaga vnaprej določiti kompozicijski prostor nove scene.\n\nBesedilo je lahko v katerem koli jeziku. Omejitev znaša 5000 nekitajskih ali 2500 kitajskih znakov, presežni del pa se zavrže. Najpomembnejše vloge referenc, dogajanje in gibanje morajo biti opisani znotraj tega obsega. Začetno naključno seme lahko usmerja podobnost različic, ne zagotavlja pa natančne ponovitve posameznega posnetka.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "945b8373abdbaa119668ac991321df9f5d06c3d058677b1210a25ec80a7a0a95", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "sl", "methods": [ { "html": "happyhorse-1.1-r2vModel za ustvarjanje videa na podlagi referenčnih slik in besedilnega scenarija. Pomaga ohranjati videz likov, predmete in vizualni slog v novi sceni.
Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.
HappyHorse-1.1-R2V ustvarja novo videosceno na podlagi referenčnih slik in besedilnega navodila. Alibaba model usmerja v ohranjanje prepoznavnih likov, objektov in vizualnega sloga pri ustvarjanju gibanja. Reference določajo vsebino in videz scene, besedilo pa opisuje, kako naj ti elementi medsebojno delujejo.
Uporabite lahko od ene do devet slik. Te lahko določajo lik, predmet, okolje ali umetniško izvedbo. V opisu lahko navedete številko reference in konkreten objekt na njej, da vizualno gradivo povežete z ustreznim delom dogajanja. To je zlasti koristno, kadar je treba elemente več slik združiti v eno kompozicijo.
V nasprotju z načinom z začetnim kadrom reference tu služijo kot opora za vsebino nove scene. Besedilno navodilo je obvezno: videz objektov povezuje z dogajanjem, gibanjem kamere in celotno postavitvijo. Proizvajalec izpostavlja vizualno skladnost in filmsko gibanje; rezultat ostaja generirana vsebina in ne montaža izvirnih slik.
Sprejeti so formati JPEG, JPG, PNG in WEBP, vsak z velikostjo do 20 MB. Krajša stranica slike mora imeti najmanj 400 slikovnih pik; priporočeno je gradivo z ločljivostjo 720P ali višjo. Vhod v ta način sestavljajo prav slike in besedilo.
Rezultat se shrani v MP4 s hitrostjo 24 sličic na sekundo. Trajanje določite kot celo število od 3 do 15 sekund. Izbirate lahko med ločljivostmi 480P, 720P in 1080P; podprto je ustvarjanje zvočne spremljave.
Na voljo so ležeči, pokončni in kvadratni kadri: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 in 21:9. Izbira formata pomaga vnaprej določiti kompozicijski prostor nove scene.
Besedilo je lahko v katerem koli jeziku. Omejitev znaša 5000 nekitajskih ali 2500 kitajskih znakov, presežni del pa se zavrže. Najpomembnejše vloge referenc, dogajanje in gibanje morajo biti opisani znotraj tega obsega. Začetno naključno seme lahko usmerja podobnost različic, ne zagotavlja pa natančne ponovitve posameznega posnetka.
POST /v1/videos/generationstext, imagevideo| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve happyhorse-1.1-r2v | Privzeto— |
Poljeprompt | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve Najmanjša dolžina: 1 | Privzeto— |
Poljeduration | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 3 Največ: 15 Enota: sekunde | Privzeto5 |
Poljeresolution | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 480P, 720P, 1080P | Privzeto720P |
Poljeratio | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Privzeto16:9 |
Poljeimage_urls | Vrstahttps_url|data_image_url[] | ZahtevaObvezno | Vrednosti in omejitve Najmanjše število elementov: 1 Največ elementov: 9 Največ dekodiranih bajtov: 20.971.520 Vrste MIME: image/jpeg, image/png, image/webp | Privzeto— |
reference_images_to_video · Obvezno: prompt, image_urls
| Parameter | Specifikacija |
|---|---|
Parametercontent_type | Specifikacijaapplication/json |
Parameterrequired | Specifikacijamodel, prompt, image_urls |
Parametermaterial_types | Specifikacijatext, image |
Parameteroptional | Specifikacijaduration, resolution, ratio |
Parameterduration_integer_range | Specifikacija3, 15 |
Parameterdefault_duration | Specifikacija5 |
Parameterresolution | Specifikacija480P, 720P, 1080P |
Parameterdefault_resolution | Specifikacija720P |
Parameterratio | Specifikacija16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 |
Parameterratio_must_omit | Specifikacijafalse |
Parameterimage_urls | Specifikacija{"min_count":1,"max_count":9,"schemes":["https","data za rastrsko sliko v base64"],"max_data_image_bytes":20971520} |
Življenjski cikel: 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
Strukture metod in ID so natančno določeni; zmožnost ponudnika je ločena od sprejema zahteve.
POST /v1/videos/generationsAiloot 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 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_IMAGE_URLS_FILE:?Set a JSON file containing your actual reference-image URLs}"\nexport AILOOT_IMAGE_URLS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-1.1-r2v", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nf=Path(os.environ["AILOOT_IMAGE_URLS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual reference URL JSON file")\nurls=json.loads(f.read_text())\nif not isinstance(urls,list) or not 1<=len(urls)<=9:raise SystemExit("Provide one to nine reference-image URLs")\nfor u in urls:\n z=urlsplit(u) if isinstance(u,str) else None\n if not z or z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Each reference must be an actual HTTPS image URL")\np["image_urls"]=urls\np["ratio"]="16:9"\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\nShranite vsak dokončan video ali vrnjeno datoteko; pridobite vsebino z vsake dejansko vrnjene URL gradiva.
Ohranite vsak vrnjeni element data/indeks izhoda. content_url je samo prvi; pridobite vsako dejansko pot vsebine/sredstvo. GET vsebine brez index ne pomeni vseh izhodov.
Berite obstoječe prvotno opravilo; neznane oddaje nikoli ne ponovite.
| Polje | Vrsta |
|---|---|
Poljeid | Vrstastring |
Poljeobject | Vrstastring |
Poljemodel | Vrstastring |
Poljestatus | Vrstastring |
Poljecontent_url | Vrstasigned URL |
Poljedata[] | Vrstasigned URL |
Poljeusage | Vrstaobject |
Poljeresult_pending_check | Vrstaboolean |
| Odgovor | Pogoj | Naslednji korak |
|---|---|---|
Odgovor400 · invalid_request_error | PogojNeveljavna obvezna polja, predstavitev gradiva ali vrednost parametra | Naslednji korakPred novo zahtevo za ustvarjanje popravite navedena polja. |
Odgovor409 · video_not_ready | PogojPrvotna vsebina rezultata še ni na voljo | Naslednji korakPreverjajte prvotni vrnjeni ID in upoštevajte Retry-After. |
Odgovorserver_error | PogojVrnjeni odgovor navaja, da je treba operacijo ali rezultat preveriti | Naslednji korakShranite izvirni vrnjeni ID operacije/opravila, glave zahteve in odgovor; nadaljujte s podprtimi branji te izvirne operacije. Zahteve za ustvarjanje ne pošiljajte znova. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Uporabite zgoraj navedene poti metod.
happyhorse-r2vModel za ustvarjanje videa na podlagi referenčnih slik in besedilnega scenarija. Pomaga ohranjati videz likov, predmete in vizualni slog v novi sceni.
Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.
HappyHorse-1.1-R2V ustvarja novo videosceno na podlagi referenčnih slik in besedilnega navodila. Alibaba model usmerja v ohranjanje prepoznavnih likov, objektov in vizualnega sloga pri ustvarjanju gibanja. Reference določajo vsebino in videz scene, besedilo pa opisuje, kako naj ti elementi medsebojno delujejo.
Uporabite lahko od ene do devet slik. Te lahko določajo lik, predmet, okolje ali umetniško izvedbo. V opisu lahko navedete številko reference in konkreten objekt na njej, da vizualno gradivo povežete z ustreznim delom dogajanja. To je zlasti koristno, kadar je treba elemente več slik združiti v eno kompozicijo.
V nasprotju z načinom z začetnim kadrom reference tu služijo kot opora za vsebino nove scene. Besedilno navodilo je obvezno: videz objektov povezuje z dogajanjem, gibanjem kamere in celotno postavitvijo. Proizvajalec izpostavlja vizualno skladnost in filmsko gibanje; rezultat ostaja generirana vsebina in ne montaža izvirnih slik.
Sprejeti so formati JPEG, JPG, PNG in WEBP, vsak z velikostjo do 20 MB. Krajša stranica slike mora imeti najmanj 400 slikovnih pik; priporočeno je gradivo z ločljivostjo 720P ali višjo. Vhod v ta način sestavljajo prav slike in besedilo.
Rezultat se shrani v MP4 s hitrostjo 24 sličic na sekundo. Trajanje določite kot celo število od 3 do 15 sekund. Izbirate lahko med ločljivostmi 480P, 720P in 1080P; podprto je ustvarjanje zvočne spremljave.
Na voljo so ležeči, pokončni in kvadratni kadri: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 in 21:9. Izbira formata pomaga vnaprej določiti kompozicijski prostor nove scene.
Besedilo je lahko v katerem koli jeziku. Omejitev znaša 5000 nekitajskih ali 2500 kitajskih znakov, presežni del pa se zavrže. Najpomembnejše vloge referenc, dogajanje in gibanje morajo biti opisani znotraj tega obsega. Začetno naključno seme lahko usmerja podobnost različic, ne zagotavlja pa natančne ponovitve posameznega posnetka.
POST /v1/videos/generationstext, imagevideo| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve happyhorse-r2v | Privzeto— |
Poljeprompt | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve Najmanjša dolžina: 1 | Privzeto— |
Poljeduration | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 3 Največ: 15 Enota: sekunde | Privzeto5 |
Poljeresolution | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 480P, 720P, 1080P | Privzeto720P |
Poljeratio | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Privzeto16:9 |
Poljeimage_urls | Vrstahttps_url|data_image_url[] | ZahtevaObvezno | Vrednosti in omejitve Najmanjše število elementov: 1 Največ elementov: 9 Največ dekodiranih bajtov: 20.971.520 Vrste MIME: image/jpeg, image/png, image/webp | Privzeto— |
reference_images_to_video · Obvezno: prompt, image_urls
| Parameter | Specifikacija |
|---|---|
Parametermaterial_types | Specifikacijatext, image |
Parameterrequired | Specifikacijanull |
Parameteroptional_controls | Specifikacijanull |
Življenjski cikel: 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
Strukture metod in ID so natančno določeni; zmožnost ponudnika je ločena od sprejema zahteve.
POST /v1/videos/generationsAiloot 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 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_IMAGE_URLS_FILE:?Set a JSON file containing your actual reference-image URLs}"\nexport AILOOT_IMAGE_URLS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-r2v", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nf=Path(os.environ["AILOOT_IMAGE_URLS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual reference URL JSON file")\nurls=json.loads(f.read_text())\nif not isinstance(urls,list) or not 1<=len(urls)<=9:raise SystemExit("Provide one to nine reference-image URLs")\nfor u in urls:\n z=urlsplit(u) if isinstance(u,str) else None\n if not z or z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Each reference must be an actual HTTPS image URL")\np["image_urls"]=urls\np["ratio"]="16:9"\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\nShranite vsak dokončan video ali vrnjeno datoteko; pridobite vsebino z vsake dejansko vrnjene URL gradiva.
Ohranite vsak vrnjeni element data/indeks izhoda. content_url je samo prvi; pridobite vsako dejansko pot vsebine/sredstvo. GET vsebine brez index ne pomeni vseh izhodov.
Berite obstoječe prvotno opravilo; neznane oddaje nikoli ne ponovite.
| Polje | Vrsta |
|---|---|
Poljeid | Vrstastring |
Poljeobject | Vrstastring |
Poljemodel | Vrstastring |
Poljestatus | Vrstastring |
Poljecontent_url | Vrstasigned URL |
Poljedata[] | Vrstasigned URL |
Poljeusage | Vrstaobject |
Poljeresult_pending_check | Vrstaboolean |
| Odgovor | Pogoj | Naslednji korak |
|---|---|---|
Odgovor400 · invalid_request_error | PogojNeveljavna obvezna polja, predstavitev gradiva ali vrednost parametra | Naslednji korakPred novo zahtevo za ustvarjanje popravite navedena polja. |
Odgovor409 · video_not_ready | PogojPrvotna vsebina rezultata še ni na voljo | Naslednji korakPreverjajte prvotni vrnjeni ID in upoštevajte Retry-After. |
Odgovorserver_error | PogojVrnjeni odgovor navaja, da je treba operacijo ali rezultat preveriti | Naslednji korakShranite izvirni vrnjeni ID operacije/opravila, glave zahteve in odgovor; nadaljujte s podprtimi branji te izvirne operacije. Zahteve za ustvarjanje ne pošiljajte znova. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Uporabite zgoraj navedene poti metod.
happyhorse-r2v-latestModel za ustvarjanje videa na podlagi referenčnih slik in besedilnega scenarija. Pomaga ohranjati videz likov, predmete in vizualni slog v novi sceni.
Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.
HappyHorse-1.1-R2V ustvarja novo videosceno na podlagi referenčnih slik in besedilnega navodila. Alibaba model usmerja v ohranjanje prepoznavnih likov, objektov in vizualnega sloga pri ustvarjanju gibanja. Reference določajo vsebino in videz scene, besedilo pa opisuje, kako naj ti elementi medsebojno delujejo.
Uporabite lahko od ene do devet slik. Te lahko določajo lik, predmet, okolje ali umetniško izvedbo. V opisu lahko navedete številko reference in konkreten objekt na njej, da vizualno gradivo povežete z ustreznim delom dogajanja. To je zlasti koristno, kadar je treba elemente več slik združiti v eno kompozicijo.
V nasprotju z načinom z začetnim kadrom reference tu služijo kot opora za vsebino nove scene. Besedilno navodilo je obvezno: videz objektov povezuje z dogajanjem, gibanjem kamere in celotno postavitvijo. Proizvajalec izpostavlja vizualno skladnost in filmsko gibanje; rezultat ostaja generirana vsebina in ne montaža izvirnih slik.
Sprejeti so formati JPEG, JPG, PNG in WEBP, vsak z velikostjo do 20 MB. Krajša stranica slike mora imeti najmanj 400 slikovnih pik; priporočeno je gradivo z ločljivostjo 720P ali višjo. Vhod v ta način sestavljajo prav slike in besedilo.
Rezultat se shrani v MP4 s hitrostjo 24 sličic na sekundo. Trajanje določite kot celo število od 3 do 15 sekund. Izbirate lahko med ločljivostmi 480P, 720P in 1080P; podprto je ustvarjanje zvočne spremljave.
Na voljo so ležeči, pokončni in kvadratni kadri: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 in 21:9. Izbira formata pomaga vnaprej določiti kompozicijski prostor nove scene.
Besedilo je lahko v katerem koli jeziku. Omejitev znaša 5000 nekitajskih ali 2500 kitajskih znakov, presežni del pa se zavrže. Najpomembnejše vloge referenc, dogajanje in gibanje morajo biti opisani znotraj tega obsega. Začetno naključno seme lahko usmerja podobnost različic, ne zagotavlja pa natančne ponovitve posameznega posnetka.
POST /v1/videos/generationstext, imagevideo| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve happyhorse-r2v-latest | Privzeto— |
Poljeprompt | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve Najmanjša dolžina: 1 | Privzeto— |
Poljeduration | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 3 Največ: 15 Enota: sekunde | Privzeto5 |
Poljeresolution | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 480P, 720P, 1080P | Privzeto720P |
Poljeratio | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Privzeto16:9 |
Poljeimage_urls | Vrstahttps_url|data_image_url[] | ZahtevaObvezno | Vrednosti in omejitve Najmanjše število elementov: 1 Največ elementov: 9 Največ dekodiranih bajtov: 20.971.520 Vrste MIME: image/jpeg, image/png, image/webp | Privzeto— |
reference_images_to_video · Obvezno: prompt, image_urls
| Parameter | Specifikacija |
|---|---|
Parametermaterial_types | Specifikacijatext, image |
Parameterrequired | Specifikacijanull |
Parameteroptional_controls | Specifikacijanull |
Življenjski cikel: 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
Strukture metod in ID so natančno določeni; zmožnost ponudnika je ločena od sprejema zahteve.
POST /v1/videos/generationsAiloot 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 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_IMAGE_URLS_FILE:?Set a JSON file containing your actual reference-image URLs}"\nexport AILOOT_IMAGE_URLS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-r2v-latest", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nf=Path(os.environ["AILOOT_IMAGE_URLS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual reference URL JSON file")\nurls=json.loads(f.read_text())\nif not isinstance(urls,list) or not 1<=len(urls)<=9:raise SystemExit("Provide one to nine reference-image URLs")\nfor u in urls:\n z=urlsplit(u) if isinstance(u,str) else None\n if not z or z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Each reference must be an actual HTTPS image URL")\np["image_urls"]=urls\np["ratio"]="16:9"\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\nShranite vsak dokončan video ali vrnjeno datoteko; pridobite vsebino z vsake dejansko vrnjene URL gradiva.
Ohranite vsak vrnjeni element data/indeks izhoda. content_url je samo prvi; pridobite vsako dejansko pot vsebine/sredstvo. GET vsebine brez index ne pomeni vseh izhodov.
Berite obstoječe prvotno opravilo; neznane oddaje nikoli ne ponovite.
| Polje | Vrsta |
|---|---|
Poljeid | Vrstastring |
Poljeobject | Vrstastring |
Poljemodel | Vrstastring |
Poljestatus | Vrstastring |
Poljecontent_url | Vrstasigned URL |
Poljedata[] | Vrstasigned URL |
Poljeusage | Vrstaobject |
Poljeresult_pending_check | Vrstaboolean |
| Odgovor | Pogoj | Naslednji korak |
|---|---|---|
Odgovor400 · invalid_request_error | PogojNeveljavna obvezna polja, predstavitev gradiva ali vrednost parametra | Naslednji korakPred novo zahtevo za ustvarjanje popravite navedena polja. |
Odgovor409 · video_not_ready | PogojPrvotna vsebina rezultata še ni na voljo | Naslednji korakPreverjajte prvotni vrnjeni ID in upoštevajte Retry-After. |
Odgovorserver_error | PogojVrnjeni odgovor navaja, da je treba operacijo ali rezultat preveriti | Naslednji korakShranite izvirni vrnjeni ID operacije/opravila, glave zahteve in odgovor; nadaljujte s podprtimi branji te izvirne operacije. Zahteve za ustvarjanje ne pošiljajte znova. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Uporabite zgoraj navedene poti metod.