HappyHorse-1.1-I2V — Alibaba modelis, pradedantis vaizdo sceną nuo paruošto vaizdo. Vaizdas tampa pirmuoju kadru, o tekstas gali nurodyti tolesnį veiksmą: veikėjo judėjimą, scenos pokyčius ir kameros kryptį. Tai tinka iliustracijai, daikto nuotraukai ar iš anksto parengtai vizualinei koncepcijai pagyvinti.
Tekstinis aprašymas neprivalomas. Jei jo nėra, modelis pats numato galimą judesį pagal pradinio vaizdo turinį. Kai užduotis pateikiama aiškiai, pradinis vaizdas nustato kompoziciją ir objektų išvaizdą, o žodžiai nukreipia scenos raidą laike.
Alibaba pabrėžia veikėjo išvaizdos išlaikymą, vizualinį nuoseklumą, judesio sklandumą ir vaizdo bei garso derinimą. Tarp deklaruojamų krypčių taip pat yra užrašų ir tekstūrų stabilumas. Šios savybės apibūdina modelio paskirtį ir nereiškia, kad kiekvienas pikselis bus tiksliai išlaikytas visuose sugeneruotuose kadruose.
Šiuo režimu naudojamas vienas pradinis vaizdas. Jis nustato pradinę sceną, o ne pateikia nepriklausomų pavyzdžių rinkinį naujai kompozicijai. Galimybė šiai konkrečiai versijai nustatyti atskirą baigiamąjį kadrą nėra deklaruota.
Priimami JPEG, JPG, PNG ir WEBP. Kiekviena įvesties vaizdo kraštinė turi būti ne trumpesnė kaip 300 pikselių; leidžiamas kraštinių santykis — nuo 1:2,5 iki 2,5:1, failo dydis — iki 20 MB. Galutinio vaizdo įrašo kraštinių santykis atitinka pirmąjį kadrą.
Trukmė pasirenkama sveikuoju skaičiumi nuo 3 iki 15 sekundžių. Galima rinktis 480P, 720P ir 1080P raišką; išvesties formatas — MP4, dažnis — 24 kadrai per sekundę. Palaikomas garso takelio kūrimas kartu su vaizdu.
Aprašymas gali būti bet kuria kalba ir turėti iki 5000 ne kinų arba 2500 kinų rašmenų. Viršijus ribą, perteklinė dalis atmetama, todėl svarbius veiksmus ir judėjimo ypatybes verta suformuluoti neviršijant užduoties apimties. Ta pati pradinė atsitiktinumo reikšmė gali duoti panašių vaizdo įrašų, tačiau negarantuoja, kad jų kadrai tiksliai sutaps.
", "aboutText": "HappyHorse-1.1-I2V — Alibaba modelis, pradedantis vaizdo sceną nuo paruošto vaizdo. Vaizdas tampa pirmuoju kadru, o tekstas gali nurodyti tolesnį veiksmą: veikėjo judėjimą, scenos pokyčius ir kameros kryptį. Tai tinka iliustracijai, daikto nuotraukai ar iš anksto parengtai vizualinei koncepcijai pagyvinti.\n\nTekstinis aprašymas neprivalomas. Jei jo nėra, modelis pats numato galimą judesį pagal pradinio vaizdo turinį. Kai užduotis pateikiama aiškiai, pradinis vaizdas nustato kompoziciją ir objektų išvaizdą, o žodžiai nukreipia scenos raidą laike.\n\n### Nuo pirmojo kadro iki judesio\n\nAlibaba pabrėžia veikėjo išvaizdos išlaikymą, vizualinį nuoseklumą, judesio sklandumą ir vaizdo bei garso derinimą. Tarp deklaruojamų krypčių taip pat yra užrašų ir tekstūrų stabilumas. Šios savybės apibūdina modelio paskirtį ir nereiškia, kad kiekvienas pikselis bus tiksliai išlaikytas visuose sugeneruotuose kadruose.\n\nŠiuo režimu naudojamas vienas pradinis vaizdas. Jis nustato pradinę sceną, o ne pateikia nepriklausomų pavyzdžių rinkinį naujai kompozicijai. Galimybė šiai konkrečiai versijai nustatyti atskirą baigiamąjį kadrą nėra deklaruota.\n\nPriimami JPEG, JPG, PNG ir WEBP. Kiekviena įvesties vaizdo kraštinė turi būti ne trumpesnė kaip 300 pikselių; leidžiamas kraštinių santykis — nuo 1:2,5 iki 2,5:1, failo dydis — iki 20 MB. Galutinio vaizdo įrašo kraštinių santykis atitinka pirmąjį kadrą.\n\n### Vaizdo įrašo parametrai\n\nTrukmė pasirenkama sveikuoju skaičiumi nuo 3 iki 15 sekundžių. Galima rinktis 480P, 720P ir 1080P raišką; išvesties formatas — MP4, dažnis — 24 kadrai per sekundę. Palaikomas garso takelio kūrimas kartu su vaizdu.\n\nAprašymas gali būti bet kuria kalba ir turėti iki 5000 ne kinų arba 2500 kinų rašmenų. Viršijus ribą, perteklinė dalis atmetama, todėl svarbius veiksmus ir judėjimo ypatybes verta suformuluoti neviršijant užduoties apimties. Ta pati pradinė atsitiktinumo reikšmė gali duoti panašių vaizdo įrašų, tačiau negarantuoja, kad jų kadrai tiksliai sutaps.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "097afefc374dbb95b63adc2d498904c928d308910985c02958ae17033d0b4c5e", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "lt", "methods": [ { "html": "happyhorse-1.1-i2vModelis, suteikiantis judesio vaizdui: pradinis vaizdas nustato pirmąjį kadrą, o aprašymas nukreipia tolesnį judėjimą. Kuria trumpą vaizdo įrašą su galimu garso takeliu.
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
HappyHorse-1.1-I2V — Alibaba modelis, pradedantis vaizdo sceną nuo paruošto vaizdo. Vaizdas tampa pirmuoju kadru, o tekstas gali nurodyti tolesnį veiksmą: veikėjo judėjimą, scenos pokyčius ir kameros kryptį. Tai tinka iliustracijai, daikto nuotraukai ar iš anksto parengtai vizualinei koncepcijai pagyvinti.
Tekstinis aprašymas neprivalomas. Jei jo nėra, modelis pats numato galimą judesį pagal pradinio vaizdo turinį. Kai užduotis pateikiama aiškiai, pradinis vaizdas nustato kompoziciją ir objektų išvaizdą, o žodžiai nukreipia scenos raidą laike.
Alibaba pabrėžia veikėjo išvaizdos išlaikymą, vizualinį nuoseklumą, judesio sklandumą ir vaizdo bei garso derinimą. Tarp deklaruojamų krypčių taip pat yra užrašų ir tekstūrų stabilumas. Šios savybės apibūdina modelio paskirtį ir nereiškia, kad kiekvienas pikselis bus tiksliai išlaikytas visuose sugeneruotuose kadruose.
Šiuo režimu naudojamas vienas pradinis vaizdas. Jis nustato pradinę sceną, o ne pateikia nepriklausomų pavyzdžių rinkinį naujai kompozicijai. Galimybė šiai konkrečiai versijai nustatyti atskirą baigiamąjį kadrą nėra deklaruota.
Priimami JPEG, JPG, PNG ir WEBP. Kiekviena įvesties vaizdo kraštinė turi būti ne trumpesnė kaip 300 pikselių; leidžiamas kraštinių santykis — nuo 1:2,5 iki 2,5:1, failo dydis — iki 20 MB. Galutinio vaizdo įrašo kraštinių santykis atitinka pirmąjį kadrą.
Trukmė pasirenkama sveikuoju skaičiumi nuo 3 iki 15 sekundžių. Galima rinktis 480P, 720P ir 1080P raišką; išvesties formatas — MP4, dažnis — 24 kadrai per sekundę. Palaikomas garso takelio kūrimas kartu su vaizdu.
Aprašymas gali būti bet kuria kalba ir turėti iki 5000 ne kinų arba 2500 kinų rašmenų. Viršijus ribą, perteklinė dalis atmetama, todėl svarbius veiksmus ir judėjimo ypatybes verta suformuluoti neviršijant užduoties apimties. Ta pati pradinė atsitiktinumo reikšmė gali duoti panašių vaizdo įrašų, tačiau negarantuoja, kad jų kadrai tiksliai sutaps.
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-i2v | Numatyta— |
Laukasprompt | Tipasstring | ReikalavimasNeprivaloma | 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 | ReikalavimasNepalaikoma | Reikšmės ir ribos | Numatyta— |
Laukasimage_urls | Tipashttps_url|data_image_url[] | ReikalavimasPrivaloma | Reikšmės ir ribos Mažiausias elementų skaičius: 1 Didžiausias elementų skaičius: 1 Didžiausias dekoduotų baitų skaičius: 20 971 520 MIME tipai: image/jpeg, image/png, image/webp | Numatyta— |
first_frame_to_video · Privaloma: image_urls
| Parametras | Specifikacija |
|---|---|
Parametrascontent_type | Specifikacijaapplication/json |
Parametrasrequired | Specifikacijamodel, image_urls |
Parametrasmaterial_types | Specifikacijatext, image |
Parametrasoptional | Specifikacijaduration, resolution, ratio, prompt |
Parametrasduration_integer_range | Specifikacija3, 15 |
Parametrasdefault_duration | Specifikacija5 |
Parametrasresolution | Specifikacija480P, 720P, 1080P |
Parametrasdefault_resolution | Specifikacija720P |
Parametrasratio | Specifikacija |
Parametrasratio_must_omit | Specifikacijatrue |
Parametrasimage_urls | Specifikacija{"min_count":1,"max_count":1,"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_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-1.1-i2v", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\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-i2v, happyhorse-i2v, happyhorse-i2v-latest
Naudokite aukščiau nurodytus metodų kelius.
happyhorse-i2vModelis, suteikiantis judesio vaizdui: pradinis vaizdas nustato pirmąjį kadrą, o aprašymas nukreipia tolesnį judėjimą. Kuria trumpą vaizdo įrašą su galimu garso takeliu.
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
HappyHorse-1.1-I2V — Alibaba modelis, pradedantis vaizdo sceną nuo paruošto vaizdo. Vaizdas tampa pirmuoju kadru, o tekstas gali nurodyti tolesnį veiksmą: veikėjo judėjimą, scenos pokyčius ir kameros kryptį. Tai tinka iliustracijai, daikto nuotraukai ar iš anksto parengtai vizualinei koncepcijai pagyvinti.
Tekstinis aprašymas neprivalomas. Jei jo nėra, modelis pats numato galimą judesį pagal pradinio vaizdo turinį. Kai užduotis pateikiama aiškiai, pradinis vaizdas nustato kompoziciją ir objektų išvaizdą, o žodžiai nukreipia scenos raidą laike.
Alibaba pabrėžia veikėjo išvaizdos išlaikymą, vizualinį nuoseklumą, judesio sklandumą ir vaizdo bei garso derinimą. Tarp deklaruojamų krypčių taip pat yra užrašų ir tekstūrų stabilumas. Šios savybės apibūdina modelio paskirtį ir nereiškia, kad kiekvienas pikselis bus tiksliai išlaikytas visuose sugeneruotuose kadruose.
Šiuo režimu naudojamas vienas pradinis vaizdas. Jis nustato pradinę sceną, o ne pateikia nepriklausomų pavyzdžių rinkinį naujai kompozicijai. Galimybė šiai konkrečiai versijai nustatyti atskirą baigiamąjį kadrą nėra deklaruota.
Priimami JPEG, JPG, PNG ir WEBP. Kiekviena įvesties vaizdo kraštinė turi būti ne trumpesnė kaip 300 pikselių; leidžiamas kraštinių santykis — nuo 1:2,5 iki 2,5:1, failo dydis — iki 20 MB. Galutinio vaizdo įrašo kraštinių santykis atitinka pirmąjį kadrą.
Trukmė pasirenkama sveikuoju skaičiumi nuo 3 iki 15 sekundžių. Galima rinktis 480P, 720P ir 1080P raišką; išvesties formatas — MP4, dažnis — 24 kadrai per sekundę. Palaikomas garso takelio kūrimas kartu su vaizdu.
Aprašymas gali būti bet kuria kalba ir turėti iki 5000 ne kinų arba 2500 kinų rašmenų. Viršijus ribą, perteklinė dalis atmetama, todėl svarbius veiksmus ir judėjimo ypatybes verta suformuluoti neviršijant užduoties apimties. Ta pati pradinė atsitiktinumo reikšmė gali duoti panašių vaizdo įrašų, tačiau negarantuoja, kad jų kadrai tiksliai sutaps.
POST /v1/videos/generationstext, imagevideo| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos happyhorse-i2v | Numatyta— |
Laukasprompt | Tipasstring | ReikalavimasNeprivaloma | 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 | ReikalavimasNepalaikoma | Reikšmės ir ribos | Numatyta— |
Laukasimage_urls | Tipashttps_url|data_image_url[] | ReikalavimasPrivaloma | Reikšmės ir ribos Mažiausias elementų skaičius: 1 Didžiausias elementų skaičius: 1 Didžiausias dekoduotų baitų skaičius: 20 971 520 MIME tipai: image/jpeg, image/png, image/webp | Numatyta— |
first_frame_to_video · Privaloma: 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_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-i2v", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\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-i2v, happyhorse-i2v, happyhorse-i2v-latest
Naudokite aukščiau nurodytus metodų kelius.
happyhorse-i2v-latestModelis, suteikiantis judesio vaizdui: pradinis vaizdas nustato pirmąjį kadrą, o aprašymas nukreipia tolesnį judėjimą. Kuria trumpą vaizdo įrašą su galimu garso takeliu.
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
HappyHorse-1.1-I2V — Alibaba modelis, pradedantis vaizdo sceną nuo paruošto vaizdo. Vaizdas tampa pirmuoju kadru, o tekstas gali nurodyti tolesnį veiksmą: veikėjo judėjimą, scenos pokyčius ir kameros kryptį. Tai tinka iliustracijai, daikto nuotraukai ar iš anksto parengtai vizualinei koncepcijai pagyvinti.
Tekstinis aprašymas neprivalomas. Jei jo nėra, modelis pats numato galimą judesį pagal pradinio vaizdo turinį. Kai užduotis pateikiama aiškiai, pradinis vaizdas nustato kompoziciją ir objektų išvaizdą, o žodžiai nukreipia scenos raidą laike.
Alibaba pabrėžia veikėjo išvaizdos išlaikymą, vizualinį nuoseklumą, judesio sklandumą ir vaizdo bei garso derinimą. Tarp deklaruojamų krypčių taip pat yra užrašų ir tekstūrų stabilumas. Šios savybės apibūdina modelio paskirtį ir nereiškia, kad kiekvienas pikselis bus tiksliai išlaikytas visuose sugeneruotuose kadruose.
Šiuo režimu naudojamas vienas pradinis vaizdas. Jis nustato pradinę sceną, o ne pateikia nepriklausomų pavyzdžių rinkinį naujai kompozicijai. Galimybė šiai konkrečiai versijai nustatyti atskirą baigiamąjį kadrą nėra deklaruota.
Priimami JPEG, JPG, PNG ir WEBP. Kiekviena įvesties vaizdo kraštinė turi būti ne trumpesnė kaip 300 pikselių; leidžiamas kraštinių santykis — nuo 1:2,5 iki 2,5:1, failo dydis — iki 20 MB. Galutinio vaizdo įrašo kraštinių santykis atitinka pirmąjį kadrą.
Trukmė pasirenkama sveikuoju skaičiumi nuo 3 iki 15 sekundžių. Galima rinktis 480P, 720P ir 1080P raišką; išvesties formatas — MP4, dažnis — 24 kadrai per sekundę. Palaikomas garso takelio kūrimas kartu su vaizdu.
Aprašymas gali būti bet kuria kalba ir turėti iki 5000 ne kinų arba 2500 kinų rašmenų. Viršijus ribą, perteklinė dalis atmetama, todėl svarbius veiksmus ir judėjimo ypatybes verta suformuluoti neviršijant užduoties apimties. Ta pati pradinė atsitiktinumo reikšmė gali duoti panašių vaizdo įrašų, tačiau negarantuoja, kad jų kadrai tiksliai sutaps.
POST /v1/videos/generationstext, imagevideo| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos happyhorse-i2v-latest | Numatyta— |
Laukasprompt | Tipasstring | ReikalavimasNeprivaloma | 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 | ReikalavimasNepalaikoma | Reikšmės ir ribos | Numatyta— |
Laukasimage_urls | Tipashttps_url|data_image_url[] | ReikalavimasPrivaloma | Reikšmės ir ribos Mažiausias elementų skaičius: 1 Didžiausias elementų skaičius: 1 Didžiausias dekoduotų baitų skaičius: 20 971 520 MIME tipai: image/jpeg, image/png, image/webp | Numatyta— |
first_frame_to_video · Privaloma: 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_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-i2v-latest", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\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-i2v, happyhorse-i2v, happyhorse-i2v-latest
Naudokite aukščiau nurodytus metodų kelius.