HappyHorse-1.1-R2V kuria naują vaizdo sceną pagal pavyzdinius vaizdus ir tekstinę užduotį. Alibaba šį modelį skiria atpažįstamiems veikėjams, objektams ir vizualiniam stiliui išlaikyti generuojant judesį. Pavyzdiniai vaizdai nustato scenos turinį ir išvaizdą, o tekstas aprašo, kaip šie elementai turi sąveikauti.
Galima naudoti nuo vieno iki devynių vaizdų. Jie gali apibrėžti veikėją, daiktą, aplinką ar meninę išraišką. Aprašyme galima nurodyti pavyzdinio vaizdo numerį ir konkretų jame esantį objektą, kad vaizdinė medžiaga būtų susieta su reikiama veiksmo dalimi. Tai ypač naudinga, kai kelių vaizdų elementus reikia sujungti į vieną kompoziciją.
Skirtingai nuo režimo su pradiniu kadru, pavyzdiniai vaizdai čia yra naujos scenos turinio atramos. Tekstinė užduotis privaloma: ji susieja objektų išvaizdą su veiksmu, kameros judesiu ir bendru scenos pastatymu. Gamintojas pabrėžia vizualinį nuoseklumą ir kinematografišką judesį; rezultatas yra generuojamas, o ne sumontuojamas iš pradinių vaizdų.
Priimami JPEG, JPG, PNG ir WEBP, kurių kiekvieno dydis — iki 20 MB. Trumpesnioji vaizdo kraštinė turi būti ne trumpesnė kaip 400 pikselių; rekomenduojama 720P ar aukštesnės raiškos medžiaga. Šio režimo įvestį sudaro būtent vaizdai ir tekstas.
Rezultatas išsaugomas MP4 formatu, 24 kadrų per sekundę dažniu. Trukmė nurodoma sveikuoju skaičiumi nuo 3 iki 15 sekundžių. Galima rinktis 480P, 720P ir 1080P raišką; palaikomas garso takelio generavimas.
Galimi horizontalūs, vertikalūs ir kvadratiniai kadrai: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 ir 21:9. Formato pasirinkimas padeda iš anksto nustatyti naujos scenos kompozicijos erdvę.
Tekstas gali būti bet kuria kalba. Riba — 5000 ne kinų arba 2500 kinų rašmenų, perteklinė dalis atmetama. Svarbiausi pavyzdinių vaizdų vaidmenys, veiksmas ir judėjimas turi tilpti į šią apimtį. Pradinė atsitiktinumo reikšmė gali padėti gauti panašių variantų, tačiau negarantuoja tikslaus to paties vaizdo įrašo pakartojimo.
", "aboutText": "HappyHorse-1.1-R2V kuria naują vaizdo sceną pagal pavyzdinius vaizdus ir tekstinę užduotį. Alibaba šį modelį skiria atpažįstamiems veikėjams, objektams ir vizualiniam stiliui išlaikyti generuojant judesį. Pavyzdiniai vaizdai nustato scenos turinį ir išvaizdą, o tekstas aprašo, kaip šie elementai turi sąveikauti.\n\n### Vaizdinių pavyzdžių vaidmenys\n\nGalima naudoti nuo vieno iki devynių vaizdų. Jie gali apibrėžti veikėją, daiktą, aplinką ar meninę išraišką. Aprašyme galima nurodyti pavyzdinio vaizdo numerį ir konkretų jame esantį objektą, kad vaizdinė medžiaga būtų susieta su reikiama veiksmo dalimi. Tai ypač naudinga, kai kelių vaizdų elementus reikia sujungti į vieną kompoziciją.\n\nSkirtingai nuo režimo su pradiniu kadru, pavyzdiniai vaizdai čia yra naujos scenos turinio atramos. Tekstinė užduotis privaloma: ji susieja objektų išvaizdą su veiksmu, kameros judesiu ir bendru scenos pastatymu. Gamintojas pabrėžia vizualinį nuoseklumą ir kinematografišką judesį; rezultatas yra generuojamas, o ne sumontuojamas iš pradinių vaizdų.\n\nPriimami JPEG, JPG, PNG ir WEBP, kurių kiekvieno dydis — iki 20 MB. Trumpesnioji vaizdo kraštinė turi būti ne trumpesnė kaip 400 pikselių; rekomenduojama 720P ar aukštesnės raiškos medžiaga. Šio režimo įvestį sudaro būtent vaizdai ir tekstas.\n\n### Trukmė, kadras ir garsas\n\nRezultatas išsaugomas MP4 formatu, 24 kadrų per sekundę dažniu. Trukmė nurodoma sveikuoju skaičiumi nuo 3 iki 15 sekundžių. Galima rinktis 480P, 720P ir 1080P raišką; palaikomas garso takelio generavimas.\n\nGalimi horizontalūs, vertikalūs ir kvadratiniai kadrai: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 ir 21:9. Formato pasirinkimas padeda iš anksto nustatyti naujos scenos kompozicijos erdvę.\n\nTekstas gali būti bet kuria kalba. Riba — 5000 ne kinų arba 2500 kinų rašmenų, perteklinė dalis atmetama. Svarbiausi pavyzdinių vaizdų vaidmenys, veiksmas ir judėjimas turi tilpti į šią apimtį. Pradinė atsitiktinumo reikšmė gali padėti gauti panašių variantų, tačiau negarantuoja tikslaus to paties vaizdo įrašo pakartojimo.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "5c793c673cdb763869197a9f2250ac694358aa6ab499a627621612f9eb8c200d", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "lt", "methods": [ { "html": "happyhorse-1.1-r2vVaizdo įrašų generavimo modelis, naudojantis pavyzdinius vaizdus ir tekstinį scenarijų. Padeda naujoje scenoje išlaikyti veikėjų išvaizdą, daiktus ir vizualinį stilių.
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
HappyHorse-1.1-R2V kuria naują vaizdo sceną pagal pavyzdinius vaizdus ir tekstinę užduotį. Alibaba šį modelį skiria atpažįstamiems veikėjams, objektams ir vizualiniam stiliui išlaikyti generuojant judesį. Pavyzdiniai vaizdai nustato scenos turinį ir išvaizdą, o tekstas aprašo, kaip šie elementai turi sąveikauti.
Galima naudoti nuo vieno iki devynių vaizdų. Jie gali apibrėžti veikėją, daiktą, aplinką ar meninę išraišką. Aprašyme galima nurodyti pavyzdinio vaizdo numerį ir konkretų jame esantį objektą, kad vaizdinė medžiaga būtų susieta su reikiama veiksmo dalimi. Tai ypač naudinga, kai kelių vaizdų elementus reikia sujungti į vieną kompoziciją.
Skirtingai nuo režimo su pradiniu kadru, pavyzdiniai vaizdai čia yra naujos scenos turinio atramos. Tekstinė užduotis privaloma: ji susieja objektų išvaizdą su veiksmu, kameros judesiu ir bendru scenos pastatymu. Gamintojas pabrėžia vizualinį nuoseklumą ir kinematografišką judesį; rezultatas yra generuojamas, o ne sumontuojamas iš pradinių vaizdų.
Priimami JPEG, JPG, PNG ir WEBP, kurių kiekvieno dydis — iki 20 MB. Trumpesnioji vaizdo kraštinė turi būti ne trumpesnė kaip 400 pikselių; rekomenduojama 720P ar aukštesnės raiškos medžiaga. Šio režimo įvestį sudaro būtent vaizdai ir tekstas.
Rezultatas išsaugomas MP4 formatu, 24 kadrų per sekundę dažniu. Trukmė nurodoma sveikuoju skaičiumi nuo 3 iki 15 sekundžių. Galima rinktis 480P, 720P ir 1080P raišką; palaikomas garso takelio generavimas.
Galimi horizontalūs, vertikalūs ir kvadratiniai kadrai: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 ir 21:9. Formato pasirinkimas padeda iš anksto nustatyti naujos scenos kompozicijos erdvę.
Tekstas gali būti bet kuria kalba. Riba — 5000 ne kinų arba 2500 kinų rašmenų, perteklinė dalis atmetama. Svarbiausi pavyzdinių vaizdų vaidmenys, veiksmas ir judėjimas turi tilpti į šią apimtį. Pradinė atsitiktinumo reikšmė gali padėti gauti panašių variantų, tačiau negarantuoja tikslaus to paties vaizdo įrašo pakartojimo.
POST /v1/videos/generationstext, imagevideo| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos happyhorse-1.1-r2v | Numatyta— |
Laukasprompt | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos Mažiausias ilgis: 1 | Numatyta— |
Laukasduration | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausia reikšmė: 3 Didžiausia reikšmė: 15 Vienetas: sekundės | Numatyta5 |
Laukasresolution | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 480P, 720P, 1080P | Numatyta720P |
Laukasratio | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Numatyta16:9 |
Laukasimage_urls | Tipashttps_url|data_image_url[] | ReikalavimasPrivaloma | Reikšmės ir ribos Mažiausias elementų skaičius: 1 Didžiausias elementų skaičius: 9 Didžiausias dekoduotų baitų skaičius: 20 971 520 MIME tipai: image/jpeg, image/png, image/webp | Numatyta— |
reference_images_to_video · Privaloma: prompt, image_urls
| Parametras | Specifikacija |
|---|---|
Parametrascontent_type | Specifikacijaapplication/json |
Parametrasrequired | Specifikacijamodel, prompt, image_urls |
Parametrasmaterial_types | Specifikacijatext, image |
Parametrasoptional | Specifikacijaduration, resolution, ratio |
Parametrasduration_integer_range | Specifikacija3, 15 |
Parametrasdefault_duration | Specifikacija5 |
Parametrasresolution | Specifikacija480P, 720P, 1080P |
Parametrasdefault_resolution | Specifikacija720P |
Parametrasratio | Specifikacija16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 |
Parametrasratio_must_omit | Specifikacijafalse |
Parametrasimage_urls | Specifikacija{"min_count":1,"max_count":9,"schemes":["https","rastriniai data duomenys base64 formatu"],"max_data_image_bytes":20971520} |
Gyvavimo ciklas: 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
Metodų struktūros ir ID yra tikslūs; tiekėjo galimybės yra atskirtos nuo užklausos priėmimo.
POST /v1/videos/generationsAiloot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →
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\nIšsaugokite kiekvieną baigtą vaizdo įrašą arba grąžintą failą; gaukite turinį iš kiekvieno faktiškai grąžinto medžiagos URL.
Išsaugokite kiekvieną grąžintą data elementą ir išvesties indeksą. content_url nurodo tik pirmąjį; gaukite kiekvieną tikrą turinio kelią ar išteklių. GET content be index negrąžina visų rezultatų.
Skaitykite esamos pradinės užduoties duomenis; niekada nekartokite siuntimo, kurio baigtis nežinoma.
| Laukas | Tipas |
|---|---|
Laukasid | Tipasstring |
Laukasobject | Tipasstring |
Laukasmodel | Tipasstring |
Laukasstatus | Tipasstring |
Laukascontent_url | Tipassigned URL |
Laukasdata[] | Tipassigned URL |
Laukasusage | Tipasobject |
Laukasresult_pending_check | Tipasboolean |
| Atsakymas | Sąlyga | Kitas žingsnis |
|---|---|---|
Atsakymas400 · invalid_request_error | SąlygaNetinkami privalomi laukai, medžiagos pateikimo forma arba parametro reikšmė | Kitas žingsnisPrieš naują kūrimo užklausą pataisykite nurodytus laukus. |
Atsakymas409 · video_not_ready | SąlygaPradinio rezultato turinys dar nepasiekiamas | Kitas žingsnisPeriodiškai tikrinkite pradinį grąžintą ID ir laikykitės Retry-After. |
Atsakymasserver_error | SąlygaGrąžintame atsakyme nurodoma, kad operaciją arba rezultatą reikia patikrinti | Kitas žingsnisIšsaugokite pradinį grąžintą operacijos ar užduoties ID, užklausos antraštes ir atsakymą; toliau tikrinkite tos pačios pradinės operacijos duomenis palaikomais būdais. Kūrimo užklausos pakartotinai neteikite. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Naudokite aukščiau nurodytus metodų kelius.
happyhorse-r2vVaizdo įrašų generavimo modelis, naudojantis pavyzdinius vaizdus ir tekstinį scenarijų. Padeda naujoje scenoje išlaikyti veikėjų išvaizdą, daiktus ir vizualinį stilių.
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
HappyHorse-1.1-R2V kuria naują vaizdo sceną pagal pavyzdinius vaizdus ir tekstinę užduotį. Alibaba šį modelį skiria atpažįstamiems veikėjams, objektams ir vizualiniam stiliui išlaikyti generuojant judesį. Pavyzdiniai vaizdai nustato scenos turinį ir išvaizdą, o tekstas aprašo, kaip šie elementai turi sąveikauti.
Galima naudoti nuo vieno iki devynių vaizdų. Jie gali apibrėžti veikėją, daiktą, aplinką ar meninę išraišką. Aprašyme galima nurodyti pavyzdinio vaizdo numerį ir konkretų jame esantį objektą, kad vaizdinė medžiaga būtų susieta su reikiama veiksmo dalimi. Tai ypač naudinga, kai kelių vaizdų elementus reikia sujungti į vieną kompoziciją.
Skirtingai nuo režimo su pradiniu kadru, pavyzdiniai vaizdai čia yra naujos scenos turinio atramos. Tekstinė užduotis privaloma: ji susieja objektų išvaizdą su veiksmu, kameros judesiu ir bendru scenos pastatymu. Gamintojas pabrėžia vizualinį nuoseklumą ir kinematografišką judesį; rezultatas yra generuojamas, o ne sumontuojamas iš pradinių vaizdų.
Priimami JPEG, JPG, PNG ir WEBP, kurių kiekvieno dydis — iki 20 MB. Trumpesnioji vaizdo kraštinė turi būti ne trumpesnė kaip 400 pikselių; rekomenduojama 720P ar aukštesnės raiškos medžiaga. Šio režimo įvestį sudaro būtent vaizdai ir tekstas.
Rezultatas išsaugomas MP4 formatu, 24 kadrų per sekundę dažniu. Trukmė nurodoma sveikuoju skaičiumi nuo 3 iki 15 sekundžių. Galima rinktis 480P, 720P ir 1080P raišką; palaikomas garso takelio generavimas.
Galimi horizontalūs, vertikalūs ir kvadratiniai kadrai: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 ir 21:9. Formato pasirinkimas padeda iš anksto nustatyti naujos scenos kompozicijos erdvę.
Tekstas gali būti bet kuria kalba. Riba — 5000 ne kinų arba 2500 kinų rašmenų, perteklinė dalis atmetama. Svarbiausi pavyzdinių vaizdų vaidmenys, veiksmas ir judėjimas turi tilpti į šią apimtį. Pradinė atsitiktinumo reikšmė gali padėti gauti panašių variantų, tačiau negarantuoja tikslaus to paties vaizdo įrašo pakartojimo.
POST /v1/videos/generationstext, imagevideo| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos happyhorse-r2v | Numatyta— |
Laukasprompt | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos Mažiausias ilgis: 1 | Numatyta— |
Laukasduration | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausia reikšmė: 3 Didžiausia reikšmė: 15 Vienetas: sekundės | Numatyta5 |
Laukasresolution | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 480P, 720P, 1080P | Numatyta720P |
Laukasratio | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Numatyta16:9 |
Laukasimage_urls | Tipashttps_url|data_image_url[] | ReikalavimasPrivaloma | Reikšmės ir ribos Mažiausias elementų skaičius: 1 Didžiausias elementų skaičius: 9 Didžiausias dekoduotų baitų skaičius: 20 971 520 MIME tipai: image/jpeg, image/png, image/webp | Numatyta— |
reference_images_to_video · Privaloma: prompt, image_urls
| Parametras | Specifikacija |
|---|---|
Parametrasmaterial_types | Specifikacijatext, image |
Parametrasrequired | Specifikacijanull |
Parametrasoptional_controls | Specifikacijanull |
Gyvavimo ciklas: 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
Metodų struktūros ir ID yra tikslūs; tiekėjo galimybės yra atskirtos nuo užklausos priėmimo.
POST /v1/videos/generationsAiloot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →
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\nIšsaugokite kiekvieną baigtą vaizdo įrašą arba grąžintą failą; gaukite turinį iš kiekvieno faktiškai grąžinto medžiagos URL.
Išsaugokite kiekvieną grąžintą data elementą ir išvesties indeksą. content_url nurodo tik pirmąjį; gaukite kiekvieną tikrą turinio kelią ar išteklių. GET content be index negrąžina visų rezultatų.
Skaitykite esamos pradinės užduoties duomenis; niekada nekartokite siuntimo, kurio baigtis nežinoma.
| Laukas | Tipas |
|---|---|
Laukasid | Tipasstring |
Laukasobject | Tipasstring |
Laukasmodel | Tipasstring |
Laukasstatus | Tipasstring |
Laukascontent_url | Tipassigned URL |
Laukasdata[] | Tipassigned URL |
Laukasusage | Tipasobject |
Laukasresult_pending_check | Tipasboolean |
| Atsakymas | Sąlyga | Kitas žingsnis |
|---|---|---|
Atsakymas400 · invalid_request_error | SąlygaNetinkami privalomi laukai, medžiagos pateikimo forma arba parametro reikšmė | Kitas žingsnisPrieš naują kūrimo užklausą pataisykite nurodytus laukus. |
Atsakymas409 · video_not_ready | SąlygaPradinio rezultato turinys dar nepasiekiamas | Kitas žingsnisPeriodiškai tikrinkite pradinį grąžintą ID ir laikykitės Retry-After. |
Atsakymasserver_error | SąlygaGrąžintame atsakyme nurodoma, kad operaciją arba rezultatą reikia patikrinti | Kitas žingsnisIšsaugokite pradinį grąžintą operacijos ar užduoties ID, užklausos antraštes ir atsakymą; toliau tikrinkite tos pačios pradinės operacijos duomenis palaikomais būdais. Kūrimo užklausos pakartotinai neteikite. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Naudokite aukščiau nurodytus metodų kelius.
happyhorse-r2v-latestVaizdo įrašų generavimo modelis, naudojantis pavyzdinius vaizdus ir tekstinį scenarijų. Padeda naujoje scenoje išlaikyti veikėjų išvaizdą, daiktus ir vizualinį stilių.
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
HappyHorse-1.1-R2V kuria naują vaizdo sceną pagal pavyzdinius vaizdus ir tekstinę užduotį. Alibaba šį modelį skiria atpažįstamiems veikėjams, objektams ir vizualiniam stiliui išlaikyti generuojant judesį. Pavyzdiniai vaizdai nustato scenos turinį ir išvaizdą, o tekstas aprašo, kaip šie elementai turi sąveikauti.
Galima naudoti nuo vieno iki devynių vaizdų. Jie gali apibrėžti veikėją, daiktą, aplinką ar meninę išraišką. Aprašyme galima nurodyti pavyzdinio vaizdo numerį ir konkretų jame esantį objektą, kad vaizdinė medžiaga būtų susieta su reikiama veiksmo dalimi. Tai ypač naudinga, kai kelių vaizdų elementus reikia sujungti į vieną kompoziciją.
Skirtingai nuo režimo su pradiniu kadru, pavyzdiniai vaizdai čia yra naujos scenos turinio atramos. Tekstinė užduotis privaloma: ji susieja objektų išvaizdą su veiksmu, kameros judesiu ir bendru scenos pastatymu. Gamintojas pabrėžia vizualinį nuoseklumą ir kinematografišką judesį; rezultatas yra generuojamas, o ne sumontuojamas iš pradinių vaizdų.
Priimami JPEG, JPG, PNG ir WEBP, kurių kiekvieno dydis — iki 20 MB. Trumpesnioji vaizdo kraštinė turi būti ne trumpesnė kaip 400 pikselių; rekomenduojama 720P ar aukštesnės raiškos medžiaga. Šio režimo įvestį sudaro būtent vaizdai ir tekstas.
Rezultatas išsaugomas MP4 formatu, 24 kadrų per sekundę dažniu. Trukmė nurodoma sveikuoju skaičiumi nuo 3 iki 15 sekundžių. Galima rinktis 480P, 720P ir 1080P raišką; palaikomas garso takelio generavimas.
Galimi horizontalūs, vertikalūs ir kvadratiniai kadrai: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 ir 21:9. Formato pasirinkimas padeda iš anksto nustatyti naujos scenos kompozicijos erdvę.
Tekstas gali būti bet kuria kalba. Riba — 5000 ne kinų arba 2500 kinų rašmenų, perteklinė dalis atmetama. Svarbiausi pavyzdinių vaizdų vaidmenys, veiksmas ir judėjimas turi tilpti į šią apimtį. Pradinė atsitiktinumo reikšmė gali padėti gauti panašių variantų, tačiau negarantuoja tikslaus to paties vaizdo įrašo pakartojimo.
POST /v1/videos/generationstext, imagevideo| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos happyhorse-r2v-latest | Numatyta— |
Laukasprompt | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos Mažiausias ilgis: 1 | Numatyta— |
Laukasduration | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausia reikšmė: 3 Didžiausia reikšmė: 15 Vienetas: sekundės | Numatyta5 |
Laukasresolution | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 480P, 720P, 1080P | Numatyta720P |
Laukasratio | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Numatyta16:9 |
Laukasimage_urls | Tipashttps_url|data_image_url[] | ReikalavimasPrivaloma | Reikšmės ir ribos Mažiausias elementų skaičius: 1 Didžiausias elementų skaičius: 9 Didžiausias dekoduotų baitų skaičius: 20 971 520 MIME tipai: image/jpeg, image/png, image/webp | Numatyta— |
reference_images_to_video · Privaloma: prompt, image_urls
| Parametras | Specifikacija |
|---|---|
Parametrasmaterial_types | Specifikacijatext, image |
Parametrasrequired | Specifikacijanull |
Parametrasoptional_controls | Specifikacijanull |
Gyvavimo ciklas: 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
Metodų struktūros ir ID yra tikslūs; tiekėjo galimybės yra atskirtos nuo užklausos priėmimo.
POST /v1/videos/generationsAiloot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →
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\nIšsaugokite kiekvieną baigtą vaizdo įrašą arba grąžintą failą; gaukite turinį iš kiekvieno faktiškai grąžinto medžiagos URL.
Išsaugokite kiekvieną grąžintą data elementą ir išvesties indeksą. content_url nurodo tik pirmąjį; gaukite kiekvieną tikrą turinio kelią ar išteklių. GET content be index negrąžina visų rezultatų.
Skaitykite esamos pradinės užduoties duomenis; niekada nekartokite siuntimo, kurio baigtis nežinoma.
| Laukas | Tipas |
|---|---|
Laukasid | Tipasstring |
Laukasobject | Tipasstring |
Laukasmodel | Tipasstring |
Laukasstatus | Tipasstring |
Laukascontent_url | Tipassigned URL |
Laukasdata[] | Tipassigned URL |
Laukasusage | Tipasobject |
Laukasresult_pending_check | Tipasboolean |
| Atsakymas | Sąlyga | Kitas žingsnis |
|---|---|---|
Atsakymas400 · invalid_request_error | SąlygaNetinkami privalomi laukai, medžiagos pateikimo forma arba parametro reikšmė | Kitas žingsnisPrieš naują kūrimo užklausą pataisykite nurodytus laukus. |
Atsakymas409 · video_not_ready | SąlygaPradinio rezultato turinys dar nepasiekiamas | Kitas žingsnisPeriodiškai tikrinkite pradinį grąžintą ID ir laikykitės Retry-After. |
Atsakymasserver_error | SąlygaGrąžintame atsakyme nurodoma, kad operaciją arba rezultatą reikia patikrinti | Kitas žingsnisIšsaugokite pradinį grąžintą operacijos ar užduoties ID, užklausos antraštes ir atsakymą; toliau tikrinkite tos pačios pradinės operacijos duomenis palaikomais būdais. Kūrimo užklausos pakartotinai neteikite. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Naudokite aukščiau nurodytus metodų kelius.