HappyHorse-1.1-I2V — бейнесахнаны дайын суреттен бастайтын Alibaba моделі. Сурет бірінші кадрға айналады, ал мәтін кейінгі әрекетті: кейіпкер қозғалысын, сахнадағы өзгерістерді және камера бағытын анықтай алады. Бұл иллюстрацияны, заттың фотосуретін немесе алдын ала дайындалған визуалды тұжырымдаманы жандандыруға жарайды.
Мәтіндік сипаттама міндетті емес. Ол болмаса, модель бастапқы суреттің мазмұнына қарап ықтимал қозғалысты өзі анықтайды. Тапсырма нақты берілгенде бастапқы сурет композиция мен нысандардың сыртқы көрінісін белгілейді, ал сөздер сахнаның уақыт бойынша дамуын бағыттайды.
Alibaba кейіпкердің сыртқы көрінісін сақтауды, визуалды үйлесімділікті, қозғалыстың бірқалыптылығын және сурет пен дыбыстың үйлесуін атап көрсетеді. Мәлімделген бағыттардың қатарында жазулар мен текстуралардың тұрақтылығы да бар. Бұл қасиеттер модельдің көзделген мүмкіндіктеріне қатысты және барлық жасалған кадрда әрбір пиксельдің дәл сақталатынын білдірмейді.
Бұл режимде бір бастапқы сурет қолданылады. Ол жаңа композицияға арналған тәуелсіз үлгілер жиынын емес, бастапқы сахнаны белгілейді. Осы нақты нұсқа үшін жеке аяқтау кадрын тағайындау мүмкіндігі мәлімделмеген.
JPEG, JPG, PNG және WEBP қабылданады. Кіріс суреттің әр қабырғасы кемінде 300 пиксель болуы керек; рұқсат етілген арақатынас — 1:2,5-тен 2,5:1-ге дейін, файл өлшемі — 20 МБ-қа дейін. Дайын бейненің арақатынасы бірінші кадрға сәйкес келеді.
Ұзақтығы 3-тен 15 секундқа дейінгі бүтін санмен таңдалады. 480P, 720P және 1080P ажыратымдылық деңгейлері қолжетімді; шығыс форматы — MP4, жиілігі — секундына 24 кадр. Бейнеқатармен бірге дыбыстық сүйемелдеу жасау қолдау табады.
Сипаттама кез келген тілде беріле алады және қытайша емес 5000 немесе қытайша 2500 таңбаға дейін қамтиды. Шектен асса, артық бөлігі алынып тасталады, сондықтан маңызды әрекеттер мен қозғалыс ерекшеліктерін тапсырма көлеміне сыйғызу керек. Кездейсоқтықтың бірдей бастапқы мәні ұқсас роликтер беруі мүмкін, бірақ олардың кадр бойынша дәл сәйкес келуіне кепілдік бермейді.
", "aboutText": "HappyHorse-1.1-I2V — бейнесахнаны дайын суреттен бастайтын Alibaba моделі. Сурет бірінші кадрға айналады, ал мәтін кейінгі әрекетті: кейіпкер қозғалысын, сахнадағы өзгерістерді және камера бағытын анықтай алады. Бұл иллюстрацияны, заттың фотосуретін немесе алдын ала дайындалған визуалды тұжырымдаманы жандандыруға жарайды.\n\nМәтіндік сипаттама міндетті емес. Ол болмаса, модель бастапқы суреттің мазмұнына қарап ықтимал қозғалысты өзі анықтайды. Тапсырма нақты берілгенде бастапқы сурет композиция мен нысандардың сыртқы көрінісін белгілейді, ал сөздер сахнаның уақыт бойынша дамуын бағыттайды.\n\n### Бірінші кадрдан қозғалысқа\n\nAlibaba кейіпкердің сыртқы көрінісін сақтауды, визуалды үйлесімділікті, қозғалыстың бірқалыптылығын және сурет пен дыбыстың үйлесуін атап көрсетеді. Мәлімделген бағыттардың қатарында жазулар мен текстуралардың тұрақтылығы да бар. Бұл қасиеттер модельдің көзделген мүмкіндіктеріне қатысты және барлық жасалған кадрда әрбір пиксельдің дәл сақталатынын білдірмейді.\n\nБұл режимде бір бастапқы сурет қолданылады. Ол жаңа композицияға арналған тәуелсіз үлгілер жиынын емес, бастапқы сахнаны белгілейді. Осы нақты нұсқа үшін жеке аяқтау кадрын тағайындау мүмкіндігі мәлімделмеген.\n\nJPEG, JPG, PNG және WEBP қабылданады. Кіріс суреттің әр қабырғасы кемінде 300 пиксель болуы керек; рұқсат етілген арақатынас — 1:2,5-тен 2,5:1-ге дейін, файл өлшемі — 20 МБ-қа дейін. Дайын бейненің арақатынасы бірінші кадрға сәйкес келеді.\n\n### Ролик параметрлері\n\nҰзақтығы 3-тен 15 секундқа дейінгі бүтін санмен таңдалады. 480P, 720P және 1080P ажыратымдылық деңгейлері қолжетімді; шығыс форматы — MP4, жиілігі — секундына 24 кадр. Бейнеқатармен бірге дыбыстық сүйемелдеу жасау қолдау табады.\n\nСипаттама кез келген тілде беріле алады және қытайша емес 5000 немесе қытайша 2500 таңбаға дейін қамтиды. Шектен асса, артық бөлігі алынып тасталады, сондықтан маңызды әрекеттер мен қозғалыс ерекшеліктерін тапсырма көлеміне сыйғызу керек. Кездейсоқтықтың бірдей бастапқы мәні ұқсас роликтер беруі мүмкін, бірақ олардың кадр бойынша дәл сәйкес келуіне кепілдік бермейді.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "a2dd16a91bc65ba6035313a7e34197561997bc779f903188a94e30cd4a73b047", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "kk", "methods": [ { "html": "happyhorse-1.1-i2vСуретті қозғалысқа келтіретін модель: бастапқы сурет бірінші кадрды белгілейді, ал сипаттама кейінгі қозғалысты бағыттайды. Дыбыстық сүйемелдеуі болуы мүмкін қысқа бейнеролик жасайды.
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
HappyHorse-1.1-I2V — бейнесахнаны дайын суреттен бастайтын Alibaba моделі. Сурет бірінші кадрға айналады, ал мәтін кейінгі әрекетті: кейіпкер қозғалысын, сахнадағы өзгерістерді және камера бағытын анықтай алады. Бұл иллюстрацияны, заттың фотосуретін немесе алдын ала дайындалған визуалды тұжырымдаманы жандандыруға жарайды.
Мәтіндік сипаттама міндетті емес. Ол болмаса, модель бастапқы суреттің мазмұнына қарап ықтимал қозғалысты өзі анықтайды. Тапсырма нақты берілгенде бастапқы сурет композиция мен нысандардың сыртқы көрінісін белгілейді, ал сөздер сахнаның уақыт бойынша дамуын бағыттайды.
Alibaba кейіпкердің сыртқы көрінісін сақтауды, визуалды үйлесімділікті, қозғалыстың бірқалыптылығын және сурет пен дыбыстың үйлесуін атап көрсетеді. Мәлімделген бағыттардың қатарында жазулар мен текстуралардың тұрақтылығы да бар. Бұл қасиеттер модельдің көзделген мүмкіндіктеріне қатысты және барлық жасалған кадрда әрбір пиксельдің дәл сақталатынын білдірмейді.
Бұл режимде бір бастапқы сурет қолданылады. Ол жаңа композицияға арналған тәуелсіз үлгілер жиынын емес, бастапқы сахнаны белгілейді. Осы нақты нұсқа үшін жеке аяқтау кадрын тағайындау мүмкіндігі мәлімделмеген.
JPEG, JPG, PNG және WEBP қабылданады. Кіріс суреттің әр қабырғасы кемінде 300 пиксель болуы керек; рұқсат етілген арақатынас — 1:2,5-тен 2,5:1-ге дейін, файл өлшемі — 20 МБ-қа дейін. Дайын бейненің арақатынасы бірінші кадрға сәйкес келеді.
Ұзақтығы 3-тен 15 секундқа дейінгі бүтін санмен таңдалады. 480P, 720P және 1080P ажыратымдылық деңгейлері қолжетімді; шығыс форматы — MP4, жиілігі — секундына 24 кадр. Бейнеқатармен бірге дыбыстық сүйемелдеу жасау қолдау табады.
Сипаттама кез келген тілде беріле алады және қытайша емес 5000 немесе қытайша 2500 таңбаға дейін қамтиды. Шектен асса, артық бөлігі алынып тасталады, сондықтан маңызды әрекеттер мен қозғалыс ерекшеліктерін тапсырма көлеміне сыйғызу керек. Кездейсоқтықтың бірдей бастапқы мәні ұқсас роликтер беруі мүмкін, бірақ олардың кадр бойынша дәл сәйкес келуіне кепілдік бермейді.
POST /v1/videos/generationstext, imagevideo| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер happyhorse-1.1-i2v | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Ең аз ұзындық: 1 | Әдепкі— |
Өрісduration | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер Ең азы: 3 Ең көбі: 15 Бірлік: секунд | Әдепкі5 |
Өрісresolution | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 480P, 720P, 1080P | Әдепкі720P |
Өрісratio | Түріstring | ТалапҚолдау көрсетілмейді | Мәндер мен шектеулер | Әдепкі— |
Өрісimage_urls | Түріhttps_url|data_image_url[] | ТалапМіндетті | Мәндер мен шектеулер Элементтердің ең аз саны: 1 Элементтердің ең көп саны: 1 Декодталған байттардың ең көп саны: 20 971 520 MIME түрлері: image/jpeg, image/png, image/webp | Әдепкі— |
first_frame_to_video · Міндетті: image_urls
| Параметр | Параметр талаптары |
|---|---|
Параметрcontent_type | Параметр талаптарыapplication/json |
Параметрrequired | Параметр талаптарыmodel, image_urls |
Параметрmaterial_types | Параметр талаптарыtext, image |
Параметрoptional | Параметр талаптарыduration, resolution, ratio, prompt |
Параметрduration_integer_range | Параметр талаптары3, 15 |
Параметрdefault_duration | Параметр талаптары5 |
Параметрresolution | Параметр талаптары480P, 720P, 1080P |
Параметрdefault_resolution | Параметр талаптары720P |
Параметрratio | Параметр талаптары |
Параметрratio_must_omit | Параметр талаптарыtrue |
Параметрimage_urls | Параметр талаптары{"min_count":1,"max_count":1,"schemes":["https","data схемасындағы base64 растрлық деректері"],"max_data_image_bytes":20971520} |
Өмірлік цикл: 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
Әдіс құрылымдары мен ID мәндері дәл берілген; жеткізушінің мүмкіндігі сұрауды қабылдаудан бөлек қаралады.
POST /v1/videos/generationsAiloot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
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\nӘр дайын бейнені немесе қайтарылған файлды сақтаңыз; нақты қайтарылған әр материал URL арқылы мазмұнды алыңыз.
Қайтарылған әрбір дерек элементін және шығыс индексін сақтаңыз. content_url тек бірінші нәтижеге арналған; әрбір нақты мазмұн жолы немесе ресурс бойынша файлды алыңыз. Индекссіз мазмұн GET сұрауы барлық шығыс нәтижесін бермейді.
Бар бастапқы тапсырманы оқыңыз; жіберу нәтижесі белгісіз сұрауды ешқашан қайталап жібермеңіз.
| Өріс | Түрі |
|---|---|
Өрісid | Түріstring |
Өрісobject | Түріstring |
Өрісmodel | Түріstring |
Өрісstatus | Түріstring |
Өрісcontent_url | Түріsigned URL |
Өрісdata[] | Түріsigned URL |
Өрісusage | Түріobject |
Өрісresult_pending_check | Түріboolean |
| Жауап | Шарт | Келесі қадам |
|---|---|---|
Жауап400 · invalid_request_error | ШартМіндетті өрістер, материалды ұсыну тәсілі немесе параметр мәні қате | Келесі қадамЖаңадан жасау сұрауын жібермес бұрын көрсетілген өрістерді түзетіңіз. |
Жауап409 · video_not_ready | ШартБастапқы нәтиженің мазмұны әзірге қолжетімді емес | Келесі қадамБастапқы қайтарылған ID бойынша күйді мезгіл-мезгіл сұрап, Retry-After талабын сақтаңыз. |
Жауапserver_error | ШартҚайтарылған жауапта операцияны немесе нәтижені тексеру қажет екені көрсетілген | Келесі қадамБастапқыда қайтарылған операцияның/тапсырманың ID мәнін, сұрау тақырыптарын және жауабын сақтаңыз; сол бастапқы операцияны қолдау көрсетілетін тәсілдермен оқуды жалғастырыңыз. Жасау сұрауын қайта жібермеңіз. |
Ailoot happyhorse-1.1-i2v, happyhorse-i2v, happyhorse-i2v-latest
Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.
happyhorse-i2vСуретті қозғалысқа келтіретін модель: бастапқы сурет бірінші кадрды белгілейді, ал сипаттама кейінгі қозғалысты бағыттайды. Дыбыстық сүйемелдеуі болуы мүмкін қысқа бейнеролик жасайды.
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
HappyHorse-1.1-I2V — бейнесахнаны дайын суреттен бастайтын Alibaba моделі. Сурет бірінші кадрға айналады, ал мәтін кейінгі әрекетті: кейіпкер қозғалысын, сахнадағы өзгерістерді және камера бағытын анықтай алады. Бұл иллюстрацияны, заттың фотосуретін немесе алдын ала дайындалған визуалды тұжырымдаманы жандандыруға жарайды.
Мәтіндік сипаттама міндетті емес. Ол болмаса, модель бастапқы суреттің мазмұнына қарап ықтимал қозғалысты өзі анықтайды. Тапсырма нақты берілгенде бастапқы сурет композиция мен нысандардың сыртқы көрінісін белгілейді, ал сөздер сахнаның уақыт бойынша дамуын бағыттайды.
Alibaba кейіпкердің сыртқы көрінісін сақтауды, визуалды үйлесімділікті, қозғалыстың бірқалыптылығын және сурет пен дыбыстың үйлесуін атап көрсетеді. Мәлімделген бағыттардың қатарында жазулар мен текстуралардың тұрақтылығы да бар. Бұл қасиеттер модельдің көзделген мүмкіндіктеріне қатысты және барлық жасалған кадрда әрбір пиксельдің дәл сақталатынын білдірмейді.
Бұл режимде бір бастапқы сурет қолданылады. Ол жаңа композицияға арналған тәуелсіз үлгілер жиынын емес, бастапқы сахнаны белгілейді. Осы нақты нұсқа үшін жеке аяқтау кадрын тағайындау мүмкіндігі мәлімделмеген.
JPEG, JPG, PNG және WEBP қабылданады. Кіріс суреттің әр қабырғасы кемінде 300 пиксель болуы керек; рұқсат етілген арақатынас — 1:2,5-тен 2,5:1-ге дейін, файл өлшемі — 20 МБ-қа дейін. Дайын бейненің арақатынасы бірінші кадрға сәйкес келеді.
Ұзақтығы 3-тен 15 секундқа дейінгі бүтін санмен таңдалады. 480P, 720P және 1080P ажыратымдылық деңгейлері қолжетімді; шығыс форматы — MP4, жиілігі — секундына 24 кадр. Бейнеқатармен бірге дыбыстық сүйемелдеу жасау қолдау табады.
Сипаттама кез келген тілде беріле алады және қытайша емес 5000 немесе қытайша 2500 таңбаға дейін қамтиды. Шектен асса, артық бөлігі алынып тасталады, сондықтан маңызды әрекеттер мен қозғалыс ерекшеліктерін тапсырма көлеміне сыйғызу керек. Кездейсоқтықтың бірдей бастапқы мәні ұқсас роликтер беруі мүмкін, бірақ олардың кадр бойынша дәл сәйкес келуіне кепілдік бермейді.
POST /v1/videos/generationstext, imagevideo| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер happyhorse-i2v | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Ең аз ұзындық: 1 | Әдепкі— |
Өрісduration | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер Ең азы: 3 Ең көбі: 15 Бірлік: секунд | Әдепкі5 |
Өрісresolution | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 480P, 720P, 1080P | Әдепкі720P |
Өрісratio | Түріstring | ТалапҚолдау көрсетілмейді | Мәндер мен шектеулер | Әдепкі— |
Өрісimage_urls | Түріhttps_url|data_image_url[] | ТалапМіндетті | Мәндер мен шектеулер Элементтердің ең аз саны: 1 Элементтердің ең көп саны: 1 Декодталған байттардың ең көп саны: 20 971 520 MIME түрлері: image/jpeg, image/png, image/webp | Әдепкі— |
first_frame_to_video · Міндетті: image_urls
| Параметр | Параметр талаптары |
|---|---|
Параметрmaterial_types | Параметр талаптарыtext, image |
Параметрrequired | Параметр талаптарыnull |
Параметрoptional_controls | Параметр талаптарыnull |
Өмірлік цикл: 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
Әдіс құрылымдары мен ID мәндері дәл берілген; жеткізушінің мүмкіндігі сұрауды қабылдаудан бөлек қаралады.
POST /v1/videos/generationsAiloot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
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\nӘр дайын бейнені немесе қайтарылған файлды сақтаңыз; нақты қайтарылған әр материал URL арқылы мазмұнды алыңыз.
Қайтарылған әрбір дерек элементін және шығыс индексін сақтаңыз. content_url тек бірінші нәтижеге арналған; әрбір нақты мазмұн жолы немесе ресурс бойынша файлды алыңыз. Индекссіз мазмұн GET сұрауы барлық шығыс нәтижесін бермейді.
Бар бастапқы тапсырманы оқыңыз; жіберу нәтижесі белгісіз сұрауды ешқашан қайталап жібермеңіз.
| Өріс | Түрі |
|---|---|
Өрісid | Түріstring |
Өрісobject | Түріstring |
Өрісmodel | Түріstring |
Өрісstatus | Түріstring |
Өрісcontent_url | Түріsigned URL |
Өрісdata[] | Түріsigned URL |
Өрісusage | Түріobject |
Өрісresult_pending_check | Түріboolean |
| Жауап | Шарт | Келесі қадам |
|---|---|---|
Жауап400 · invalid_request_error | ШартМіндетті өрістер, материалды ұсыну тәсілі немесе параметр мәні қате | Келесі қадамЖаңадан жасау сұрауын жібермес бұрын көрсетілген өрістерді түзетіңіз. |
Жауап409 · video_not_ready | ШартБастапқы нәтиженің мазмұны әзірге қолжетімді емес | Келесі қадамБастапқы қайтарылған ID бойынша күйді мезгіл-мезгіл сұрап, Retry-After талабын сақтаңыз. |
Жауапserver_error | ШартҚайтарылған жауапта операцияны немесе нәтижені тексеру қажет екені көрсетілген | Келесі қадамБастапқыда қайтарылған операцияның/тапсырманың ID мәнін, сұрау тақырыптарын және жауабын сақтаңыз; сол бастапқы операцияны қолдау көрсетілетін тәсілдермен оқуды жалғастырыңыз. Жасау сұрауын қайта жібермеңіз. |
Ailoot happyhorse-1.1-i2v, happyhorse-i2v, happyhorse-i2v-latest
Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.
happyhorse-i2v-latestСуретті қозғалысқа келтіретін модель: бастапқы сурет бірінші кадрды белгілейді, ал сипаттама кейінгі қозғалысты бағыттайды. Дыбыстық сүйемелдеуі болуы мүмкін қысқа бейнеролик жасайды.
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
HappyHorse-1.1-I2V — бейнесахнаны дайын суреттен бастайтын Alibaba моделі. Сурет бірінші кадрға айналады, ал мәтін кейінгі әрекетті: кейіпкер қозғалысын, сахнадағы өзгерістерді және камера бағытын анықтай алады. Бұл иллюстрацияны, заттың фотосуретін немесе алдын ала дайындалған визуалды тұжырымдаманы жандандыруға жарайды.
Мәтіндік сипаттама міндетті емес. Ол болмаса, модель бастапқы суреттің мазмұнына қарап ықтимал қозғалысты өзі анықтайды. Тапсырма нақты берілгенде бастапқы сурет композиция мен нысандардың сыртқы көрінісін белгілейді, ал сөздер сахнаның уақыт бойынша дамуын бағыттайды.
Alibaba кейіпкердің сыртқы көрінісін сақтауды, визуалды үйлесімділікті, қозғалыстың бірқалыптылығын және сурет пен дыбыстың үйлесуін атап көрсетеді. Мәлімделген бағыттардың қатарында жазулар мен текстуралардың тұрақтылығы да бар. Бұл қасиеттер модельдің көзделген мүмкіндіктеріне қатысты және барлық жасалған кадрда әрбір пиксельдің дәл сақталатынын білдірмейді.
Бұл режимде бір бастапқы сурет қолданылады. Ол жаңа композицияға арналған тәуелсіз үлгілер жиынын емес, бастапқы сахнаны белгілейді. Осы нақты нұсқа үшін жеке аяқтау кадрын тағайындау мүмкіндігі мәлімделмеген.
JPEG, JPG, PNG және WEBP қабылданады. Кіріс суреттің әр қабырғасы кемінде 300 пиксель болуы керек; рұқсат етілген арақатынас — 1:2,5-тен 2,5:1-ге дейін, файл өлшемі — 20 МБ-қа дейін. Дайын бейненің арақатынасы бірінші кадрға сәйкес келеді.
Ұзақтығы 3-тен 15 секундқа дейінгі бүтін санмен таңдалады. 480P, 720P және 1080P ажыратымдылық деңгейлері қолжетімді; шығыс форматы — MP4, жиілігі — секундына 24 кадр. Бейнеқатармен бірге дыбыстық сүйемелдеу жасау қолдау табады.
Сипаттама кез келген тілде беріле алады және қытайша емес 5000 немесе қытайша 2500 таңбаға дейін қамтиды. Шектен асса, артық бөлігі алынып тасталады, сондықтан маңызды әрекеттер мен қозғалыс ерекшеліктерін тапсырма көлеміне сыйғызу керек. Кездейсоқтықтың бірдей бастапқы мәні ұқсас роликтер беруі мүмкін, бірақ олардың кадр бойынша дәл сәйкес келуіне кепілдік бермейді.
POST /v1/videos/generationstext, imagevideo| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер happyhorse-i2v-latest | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Ең аз ұзындық: 1 | Әдепкі— |
Өрісduration | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер Ең азы: 3 Ең көбі: 15 Бірлік: секунд | Әдепкі5 |
Өрісresolution | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 480P, 720P, 1080P | Әдепкі720P |
Өрісratio | Түріstring | ТалапҚолдау көрсетілмейді | Мәндер мен шектеулер | Әдепкі— |
Өрісimage_urls | Түріhttps_url|data_image_url[] | ТалапМіндетті | Мәндер мен шектеулер Элементтердің ең аз саны: 1 Элементтердің ең көп саны: 1 Декодталған байттардың ең көп саны: 20 971 520 MIME түрлері: image/jpeg, image/png, image/webp | Әдепкі— |
first_frame_to_video · Міндетті: image_urls
| Параметр | Параметр талаптары |
|---|---|
Параметрmaterial_types | Параметр талаптарыtext, image |
Параметрrequired | Параметр талаптарыnull |
Параметрoptional_controls | Параметр талаптарыnull |
Өмірлік цикл: 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
Әдіс құрылымдары мен ID мәндері дәл берілген; жеткізушінің мүмкіндігі сұрауды қабылдаудан бөлек қаралады.
POST /v1/videos/generationsAiloot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
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\nӘр дайын бейнені немесе қайтарылған файлды сақтаңыз; нақты қайтарылған әр материал URL арқылы мазмұнды алыңыз.
Қайтарылған әрбір дерек элементін және шығыс индексін сақтаңыз. content_url тек бірінші нәтижеге арналған; әрбір нақты мазмұн жолы немесе ресурс бойынша файлды алыңыз. Индекссіз мазмұн GET сұрауы барлық шығыс нәтижесін бермейді.
Бар бастапқы тапсырманы оқыңыз; жіберу нәтижесі белгісіз сұрауды ешқашан қайталап жібермеңіз.
| Өріс | Түрі |
|---|---|
Өрісid | Түріstring |
Өрісobject | Түріstring |
Өрісmodel | Түріstring |
Өрісstatus | Түріstring |
Өрісcontent_url | Түріsigned URL |
Өрісdata[] | Түріsigned URL |
Өрісusage | Түріobject |
Өрісresult_pending_check | Түріboolean |
| Жауап | Шарт | Келесі қадам |
|---|---|---|
Жауап400 · invalid_request_error | ШартМіндетті өрістер, материалды ұсыну тәсілі немесе параметр мәні қате | Келесі қадамЖаңадан жасау сұрауын жібермес бұрын көрсетілген өрістерді түзетіңіз. |
Жауап409 · video_not_ready | ШартБастапқы нәтиженің мазмұны әзірге қолжетімді емес | Келесі қадамБастапқы қайтарылған ID бойынша күйді мезгіл-мезгіл сұрап, Retry-After талабын сақтаңыз. |
Жауапserver_error | ШартҚайтарылған жауапта операцияны немесе нәтижені тексеру қажет екені көрсетілген | Келесі қадамБастапқыда қайтарылған операцияның/тапсырманың ID мәнін, сұрау тақырыптарын және жауабын сақтаңыз; сол бастапқы операцияны қолдау көрсетілетін тәсілдермен оқуды жалғастырыңыз. Жасау сұрауын қайта жібермеңіз. |
Ailoot happyhorse-1.1-i2v, happyhorse-i2v, happyhorse-i2v-latest
Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.