Source: https://ailoot.ai/models/kk/heygen-heygen-video-1/
Canonical: https://ailoot.ai/models/kk/heygen-heygen-video-1/
Language: kk

# HeyGen: HeyGen Video

[Markdown](https://ailoot.ai/models/kk/heygen-heygen-video-1/index.md) · [JSON](https://ailoot.ai/models/kk/heygen-heygen-video-1/facts.json)

## [HeyGen: HeyGen Video](https://ailoot.ai/models/kk/heygen-heygen-video-1/)

HeyGen Video мәтіннен, алғашқы суреттен немесе көрнекі және дыбыстық референстерден диалогы, орта үні және әсерлері бар 5–15 секундтық көріністер жасайды. Әмбебап heygen-video-1 моделі өнім мен кейіпкер пландарын, референс басқаруын және MP4 нәтижесін қолдайды. Анық, шектеулі әрекеттер пайдалы өндірістік тапсырма береді.

- [**Ailoot Ultra · Бейне** `POST /v1/videos` `heygen/heygen-video-1`](https://ailoot.ai/models/kk/heygen-heygen-video-1/#method-0)

Модель туралы

Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.

HeyGen Video — өндіруші heygen-video-1 деп белгілейтін HeyGen әмбебап көрініс генерация моделі. Ол шығармашылық тапсырма бойынша нысанды, ортаны, жарықты және дыбысты бірге жасайды. Әр ролик 5–15 секундқа созылады және диалог, орта үні мен әсерлерді қамтитын жасалған дыбыс жолы болады. Пайдалы өндірістік кірістерге көрініс сипаттамасы, өнім фотосы немесе адамды, орынды не қозғалысты белгілейтін материал кіреді. Нәтиже — өнім таныстырылымына, таныстыру кірістірмесіне, жылжымайтын мүлік көрінісіне не басқа монтаж жұмысына арналған қысқа көрініс.

Үш режим кірістерге әртүрлі рөл береді. Мәтіннен бейне промпт бойынша көрініс жасайды. Суреттен бейне дәл берілген суреттен басталып, кейін әрекет тапсырмасына бағынады. Референстен бейне жаңа құрастырылған көріністі бағыттау үшін суреттерді, бейнені және қосымша дыбысты қолданады; кемінде бір референс сурет не бейне қажет. Ашылу композициясы фотомен сәйкес келуі керек болса, алғашқы кадр суретін, белгілі зат басқа композицияда көрінуі керек болса, референстерді таңдаңыз. Бұл көрініс моделі HeyGen аватар рендерлеу қозғалтқыштарынан және Video Agent композиция ағынынан бөлек.

Өндіруші нұсқаулығы егжей-тегжейлі, нақты план нұсқауларын ұсынады: бір нысан, бір орын, бір шектеулі әрекет және бекітілген не ақырын қозғалатын камера. Камера орнын, объективті не өріс тереңдігі мақсатын, жарықты, бет текстурасын және түс өңдеуін сипаттаңыз. Әрекет жанасуға тәуелді болса, заттардың қайда тиетінін түсіндіріңіз. Авторлық өнім мысалы үшін жол термосының референс фотосын қолданып, оны ағаш үстелге қойып, жанында жүргізуші сөйлесін және камера термосқа аздап жақындасын деп сұраңыз. Нәтижеде термос пішінін, орналасуын және көрінетін белгілерін тексеріңіз.

Референс тізімдері тоғызға дейін суретті, үш бейнені және үш дыбыс материалын, жалпы ең көбі он екі референсті қолдайды. Өндірушінің промпт пішімінде суреттер, бейнелер және дыбыс бөлек нөмірленеді: алғашқы сурет — \<Picture 1\>, алғашқы бейне — \<Video 1\>. Әр референске рөл беріп, оны тапсырмада анық атаңыз. Модель әр референс бейненің алғашқы бес секундын оқиды, сондықтан қажетті бөлікті басына дайындаңыз. API анықтамасы референс бейне пропорцияларын 1:4 пен 4:1 арасында белгілейді. Керекті қозғалысы тек соңында болатын ұзақ ролик осы бес секундтық кіріс терезесіне нашар дайындық болады.

Құжатталған референс интерфейсі тікелей қолжетімді HTTPS ресурсын, жүктелген ресурс идентификаторын немесе тікелей base64 дерегін қабылдайды. Нұсқаулық суреттер үшін URL арқылы 16 MB, тікелей енгізуде 5 MB шегін береді; бейне не дыбыс URL арқылы 32 MB-қа, тікелей енгізуде 16 MB-қа дейін. Маңызды нысаны оңай ажыратылатын және түрлі референстерде қайшы нұсқауы жоқ оқылатын бастапқы материал дайындаңыз. Алғашқы кадр суретінде қажетті бағдарды сақтаңыз. Бұл кіріс бөлшектері өндірушінің референс ағынына қатысты және таңдалған режимге шығармашылық материалды ұйымдастыруға көмектеседі.

Дыбысты суретпен бір тапсырмада бағыттаңыз. Диалогты, дауыс орындауын, бөлме үнін және нақты әсерлерді, оның ішінде дыбыс жақын ба әлде алыс па екенін көрсетіңіз. Көріністе тек сөйлеу мен орта үні керек болса, музыканың қажетті сипатын айтыңыз. Нұсқаулық жоспарлау бағасы ретінде секундына шамамен 2.5 сөзді ұсынады, сондықтан үзіліс пен көрінетін әрекетке орын қалдырыңыз. Қысқа таныстыруды бір сөйлем және өнімді ашып көрсететін кідіріс ретінде жоспарлауға болады. Нақты сөздерді және жасалған дыбыстың кеңістік пен әрекетке сәйкестігін тыңдаңыз.

Шығыс ұзақтығы бес–он бес аралығындағы бүтін секундпен таңдалады, әдепкісі — бес секунд. Ажыратымдылық — өлшем класы: 480p, 768p, 1080p немесе 2k. Құжатталған кадрлау нұсқалары — 21:9, 16:9, 4:3, 1:1, 3:4 және 9:16. Мәтіннен және референстен бейне жасауда 1080p не 2k үшін 16:9 немесе 9:16 таңдаңыз; бейімделмелі референс кадрлауы 480p және 768p-де құжатталған. Суреттен бейне алғашқы сурет пропорциясына бағынады, сондықтан керекті пішім өзгерсе, генерациядан бұрын қиыңыз. Өлшем класы бір қалыпты пиксель жұбын білдіреді деп ойламай, аяқталған нәтиженің нақты өлшемдерін тексеріңіз.

Модель нұсқаулығы H.264 сурет кодтауы және 32 kHz стерео AAC дыбысы бар MP4 бейнесін белгілейді. Генерация асинхронды өңделеді; аяқталған тапсырма ойнатылатын бейне орналасуын, ұзақтығын және өлшемдерін береді. Оның қол қойылған бейне мекенжайын тапсырманы қайта алу арқылы жаңартуға болады. Монтаж тексеруіне нақты роликті, референс материалын және тапсырманы сақтаңыз. Күту не өңдеу жазбасы генерацияны қадағалайды; дайын бейне — суретін, сөйлеуін және дыбысын бағалайтын өндірістік артефакт.

Өндіруші промпт жақсартудың turbo, quality және disabled таңдауларын құжаттайды; disabled дайын мәтінді жазылған күйінде сақтайды. Тұрақты seed басқа кірістерді сақтап, бір сөйлемдегі өзгерісті салыстыруға пайдалы. Таңдалған seed пен параметрлерді план тапсырмасымен бірге жазыңыз. Экран жазуы үшін қажетті тіркесті қысқа ұстап, дәл жазыңыз; нұсқаулық абзацтарды, ұсақ мәтінді және белгіленген диаграммаларды кейін композитингпен қосуды ұсынады. Мәтін дұрыс қайталанды деп ойламай, жасалған тақырыптағы әр таңбаны тексеріңіз.

Нұсқаулық ұзақ экран мәтінін, гүл күлтелері, қағаз не шаш сияқты жұмсақ органикалық қозғалысты және қолдың жақын әрекетін сенімділігі төмен аймақтар деп атайды. Процедураны түсіндіргенде қадамдарды анық жазылған сөйлем жеткізсін, ал сурет тұрақты адамды не затты көрсетсін; физикалық операция дәл болуы керек болса, бөлек тексерілген көріністер қолданыңыз. Бүкіл планда зат сабақтастығын, жанасуды, бет пен қол бөлшектерін, диалог пен дыбысты тексеріңіз. Келесі нұсқада өзгеретін нәрселердің қысқа тізімі егжей-тегжейлі өндірістік тапсырманы практикалық етеді.

**Ailoot Ultra · Бейне** `POST /v1/videos` `heygen/heygen-video-1`

[`heygen/heygen-video-1`](https://ailoot.ai/models/kk/#m=heygen%2Fheygen-video-1&route=Ultra&caller=heygen%2Fheygen-video-1&fmt=videos)

HeyGen /`heygen/heygen-video-1`

### Бастау

HeyGen Video мәтіннен, алғашқы суреттен немесе көрнекі және дыбыстық референстерден диалогы, орта үні және әсерлері бар 5–15 секундтық көріністер жасайды. Әмбебап heygen-video-1 моделі өнім мен кейіпкер пландарын, референс басқаруын және MP4 нәтижесін қолдайды. Анық, шектеулі әрекеттер пайдалы өндірістік тапсырма береді.

Қабылданатын кіріс деректері

Мәтін · Суреттер · Аудио · Бейне

Нәтижелер

Бейне

### Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер

**Ailoot Ultra · Бейне** `POST /v1/videos`

Кіріс

`text`, `image`, `audio`, `video`

Шығыс

`video`

Шығыс пішімі

бастапқы MP4 байттары; қалыпқа келтірусіз/қайта кодтаусыз

| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
| --- | --- | --- | --- | --- |
| Өріс`model` | Түрі`string` | ТалапМіндетті | Мәндер мен шектеулер heygen/heygen-video-1 | Әдепкі— |
| Өріс`prompt` | Түрі`string` | ТалапМіндетті | Мәндер мен шектеулер | Әдепкі— |
| Өріс`duration` | Түрі`integer` | ТалапМіндетті | Мәндер мен шектеулер 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Ең азы: 1 Ең көбі: 600 | Әдепкі— |
| Өріс`resolution` | Түрі`string` | ТалапМіндетті емес | Мәндер мен шектеулер 480p, 768p, 2K | Әдепкі— |
| Өріс`aspect_ratio` | Түрі`string` | ТалапМіндетті емес | Мәндер мен шектеулер 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Әдепкі— |
| Өріс`generate_audio` | Түрі`boolean` | ТалапМіндетті емес | Мәндер мен шектеулер false | Әдепкі— |
| Өріс`frame_images` | Түрі`array` | ТалапМіндетті емес | Мәндер мен шектеулер Элементтердің ең аз саны: 1 Элементтердің ең көп саны: 1 Кіріс мазмұны: Кадр объектілерінің массиві. Әр объектіде type=image\_url, ішінде url бар image\_url және frame\_type өрістері болады. HTTPS сурет URL мекенжайын пайдаланып, frame\_type өрісіне first\_frame мәнін орнатыңыз. Әр кадр рөлі ең көбі бір рет кездеседі. Нақты кілттер: type, image\_url, frame\_type Шарттар: Бұл кілттер әр кадр объектісін сипаттайды; image\_url ішінде тек url болады. Тек мәтіндік сұрауда frame\_images өрісін қоспаңыз. | Әдепкі— |
| Өріс`input_references` | Түрі`array` | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— |
| Өріс`seed` | Түрі`integer` | ТалапМіндетті емес | Мәндер мен шектеулер Ең азы: -9 223 372 036 854 775 808 Ең көбі: 9 223 372 036 854 775 807 | Әдепкі— |
| Өріс`callback_url` | Түрі`string` | ТалапМіндетті емес | Мәндер мен шектеулер Үлгі: ^https:// | Әдепкі— |
| Өріс`session_id` | Түрі`string` | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— |
| Өріс`trace` | Түрі`object` | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— |
| Өріс`user` | Түрі`string` | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— |

Кіріс материалдарының үйлесімдері

**Мәтіннен бейне жасау** · Жазбаша промпт. · Міндетті: model, prompt, duration

`Промптты мәтін түрінде, ал ұзақтықты бүтін секундпен беріңіз. Қолдау көрсетілетін ажыратымдылықты және қажет болса, жақтар арақатынасын таңдаңыз.`

`model`: Түрі: string · heygen/heygen-video-1

`prompt`: Түрі: string · UTF-8 байттарының ең көп саны: 10 000 · Бос таңбаға жатпайтын кемінде бір таңба қажет: Иә

**Суреттен бейне жасау** · Жазбаша промпт және алғашқы кадр суреті. · Міндетті: model, prompt, duration, frame\_images

`frame_images — массив. Әр кадр объектісінде type, image_url және frame_type өрістері бар; image_url ішінде url болады. type өрісіне image_url мәнін орнатыңыз. first_frame мәнін қолданыңыз. Әр кадр рөлі ең көбі бір рет кездеседі. Әр кадр үшін жалпыға қолжетімді HTTPS сурет URL мекенжайын беріңіз. Қолдау көрсетілетін ажыратымдылықты және қажет болса, жақтар арақатынасын таңдаңыз.`

Нақты кілттер: type, image\_url, frame\_type

`model`: Түрі: string · heygen/heygen-video-1

`prompt`: Түрі: string · UTF-8 байттарының ең көп саны: 10 000 · Бос таңбаға жатпайтын кемінде бір таңба қажет: Иә

**Reference to video** · Жазбаша промпт және қолдау көрсетілетін сурет, бейне, аудио үлгі материалдары. · Міндетті: model, prompt, duration, input\_references

`input_references — объектілер массиві. type өрісіне image_url, video_url, audio_url мәндерінің бірін орнатып, ішінде url бар сәйкес өрісті пайдаланыңыз. Жалпыға қолжетімді HTTPS URL мекенжайларын қолданыңыз. Үлгі материалдар режимін таңдау үшін frame_images өрісін қоспаңыз. Қолдау көрсетілетін ажыратымдылықты және қажет болса, жақтар арақатынасын таңдаңыз.`

`model`: Түрі: string · heygen/heygen-video-1

`prompt`: Түрі: string · UTF-8 байттарының ең көп саны: 10 000 · Бос таңбаға жатпайтын кемінде бір таңба қажет: Иә

Әдіс параметрлері мен өмірлік циклі

| Параметр | Параметр талаптары |
| --- | --- |
| Параметр`content_type` | Параметр талаптарыapplication/json |
| Параметр`required` | Параметр талаптарыmodel, prompt, duration |
| Параметр`material_types` | Параметр талаптарыtext, image, audio, video |
| Параметр`additional_properties` | Параметр талаптарыfalse |
| Параметр`optional_controls` | Параметр талаптарыresolution, aspect\_ratio, generate\_audio, frame\_images, input\_references, seed, callback\_url, session\_id, trace, user |

Өмірлік цикл: `submit_once_poll_original`

`GET /v1/videos/{public_id}`

`GET /v1/videos/{public_id}/content`

### Тарифтер

##### Қорытынды төлем қалай есептеледі

Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.

Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.

Жылдам режим

Көрсетілмеген Жылдам режим таңдалғанда

Икемді режим

Көрсетілмеген flex режимі таңдалғанда

Ой қорытудың ең жоғары деңгейі

Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда

#### Салыстыруға арналған болжамды мөлшерлемелер

#### Баптаулар бойынша бағалар

Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.

| Баптау | Мөлшерлемелер кестесі | Болжамды мөлшер | Есептеу бірлігі | Төлемді есептеу шарттары | Төлем |
| --- | --- | --- | --- | --- | --- |
| БаптауТокендердің базалық тарифтері | Мөлшерлемелер кестесіНегізгі мөлшерлеме | Болжамды мөлшер— | Есептеу бірлігі— | Төлемді есептеу шарттары— | Төлем Кіріс · Кіріс токендері · Тек салыстыруға арналған бағалау **—** / 1K токен Шығыс · Шығыс токендері · Тек салыстыруға арналған бағалау **—** / 1K токен Кіріс · Кэшті оқу · Тек салыстыруға арналған бағалау **—** / 1K токен Кіріс · Кэшке жазу · Тек салыстыруға арналған бағалау **—** / 1K токен Кіріс · Кэшке жазу, 1 сағ · Тек салыстыруға арналған бағалау **—** / 1K токен |
| БаптауБейне бағасы | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Есептеу бірлігібейне секунды үшін | Төлемді есептеу шарттарыresolution: 2k | Төлем Шығыс · Видео бағасы · Тек салыстыруға арналған бағалау **$0.2** бейне секунды үшін |
| БаптауБейне бағасы | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Есептеу бірлігібейне секунды үшін | Төлемді есептеу шарттарыresolution: 480p | Төлем Шығыс · Видео бағасы · Тек салыстыруға арналған бағалау **$0.04** бейне секунды үшін |
| БаптауБейне бағасы | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Есептеу бірлігібейне секунды үшін | Төлемді есептеу шарттарыresolution: 768p | Төлем Шығыс · Видео бағасы · Тек салыстыруға арналған бағалау **$0.072** бейне секунды үшін |
| БаптауБейне бағасы | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Есептеу бірлігібейне секунды үшін | Төлемді есептеу шарттарыжасау режимі: reference; ажыратымдылық: 2k | Төлем Шығыс · Видео бағасы · Тек салыстыруға арналған бағалау **$0.36** бейне секунды үшін |
| БаптауБейне бағасы | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Есептеу бірлігібейне секунды үшін | Төлемді есептеу шарттарыжасау режимі: reference; ажыратымдылық: 480p | Төлем Шығыс · Видео бағасы · Тек салыстыруға арналған бағалау **$0.14** бейне секунды үшін |
| БаптауБейне бағасы | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Есептеу бірлігібейне секунды үшін | Төлемді есептеу шарттарыжасау режимі: reference; ажыратымдылық: 768p | Төлем Шығыс · Видео бағасы · Тек салыстыруға арналған бағалау **$0.2** бейне секунды үшін |
| Баптауреференс кіріс кескін | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Есептеу бірлігіүлгі кіріс суреті үшін | Төлемді есептеу шарттары— | Төлем Кіріс · референс кіріс кескін · Тек салыстыруға арналған бағалау **$0.08** үлгі кіріс суреті үшін |
| БаптауГенерацияның болжамды құны | Мөлшерлемелер кестесі— | Болжамды мөлшербір генерацияға арналған болжам | Есептеу бірлігі— | Төлемді есептеу шарттары— | Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау **$0.2** жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес. |

Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. [Резервтеу мен төлемді есептеу тәртібі →](https://ailoot.ai/docs/kk/billing/reserve/)

#### Анықтамалық тариф мәліметтері

Модельдің анықтамалық кестелері әдіс таңдауын, баға есебін не төлемді өзгертпейді. Қолданыстағы төлемдер таңдалған Ailoot әдісінің мөлшерлемелерімен есептеледі.

Бейне конфигурацияларының баға сілтемелері

#### Баптаулар бойынша бағалар

Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.

| Баптау | Төлемді есептеу шарттары | Төлем |
| --- | --- | --- |
| БаптауБейне бағасы | Төлемді есептеу шарттарыresolution: 2k | Төлем Шығыс · Видео бағасы **$0.18** бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
| БаптауБейне бағасы | Төлемді есептеу шарттарыresolution: 480p | Төлем Шығыс · Видео бағасы **$0.04** бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
| БаптауБейне бағасы | Төлемді есептеу шарттарыresolution: 768p | Төлем Шығыс · Видео бағасы **$0.06** бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
| БаптауБейне бағасы | Төлемді есептеу шарттарыжасау режимі: reference; ажыратымдылық: 2k | Төлем Шығыс · Видео бағасы **$0.36** бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
| БаптауБейне бағасы | Төлемді есептеу шарттарыжасау режимі: reference; ажыратымдылық: 480p | Төлем Шығыс · Видео бағасы **$0.08** бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
| БаптауБейне бағасы | Төлемді есептеу шарттарыжасау режимі: reference; ажыратымдылық: 768p | Төлем Шығыс · Видео бағасы **$0.12** бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |

### Сұрау мысалдары

#### Ailoot Ultra · Бейне

curl · бейне құрыңыз

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"heygen/heygen-video-1","prompt":"A serene mountain landscape at sunset","resolution":"480p"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
```

### Нәтижелерді алу және сақтау

#### Ailoot Ultra · Бейне

иелігіңіздегі мазмұнның қолтаңбасы бар URL мекенжайлары

- `GET /v1/videos/{public_id}`
- `GET /v1/videos/{public_id}/content`

##### Тапсырма күйін тексеру

GET бастапқы операцияның күйі

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
```

Басқа мазмұнды оқу

Өзіңізге тиесілі әр дайын нәтижені сақтау

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
    urls.append((str(i),u))
for label,path in urls:
    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
    target=Path('owned-'+label+'.bin')
    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
```

##### Барлық дайын нәтижені сақтау

Әр дайын бейнені немесе қайтарылған файлды сақтаңыз; нақты қайтарылған әр материал URL арқылы мазмұнды алыңыз.

Иелігіңіздегі әрбір нақты шығыс нәтижесін және онымен қайтарылған өлшенген метадеректерді сақтаңыз.

##### Бастапқы жауапты тексеру қажет болса

503 result\_pending\_check + бастапқы id + X-Should-Retry:false; бастапқы сұрауды ешқашан қайталамаңыз

Жауап өрістері

| Өріс | Түрі | Мағынасы |
| --- | --- | --- |
| Өріс`index` | Түріinteger | МағынасыОсы бейненің шығыс тізіміндегі нөлден басталатын орны. |
| Өріс`content_url` | Түріstring | МағынасыОсы аяқталған бейнені жүктеп алуға арналған қолтаңбасы бар HTTPS URL мекенжайы. |
| Өріс`sha256` | Түріstring \| null | МағынасыБастапқы бейне байттарының SHA-256 хэші; қолжетімсіз болса, null. |
| Өріс`size_bytes` | Түріinteger \| null | МағынасыБастапқы бейне файлының байтпен өлшенетін көлемі; қолжетімсіз болса, null. |
| Өріс`duration_ms` | Түріinteger \| null | МағынасыБейненің миллисекундпен өлшенген ұзақтығы; қолжетімсіз болса, null. |
| Өріс`width` | Түріinteger \| null | МағынасыБейненің пиксельмен өлшенетін ені; қолжетімсіз болса, null. |
| Өріс`height` | Түріinteger \| null | МағынасыБейненің пиксельмен өлшенетін биіктігі; қолжетімсіз болса, null. |
| Өріс`video_codec` | Түріstring \| null | МағынасыБейне кодегінің идентификаторы; тіркелмесе, null. |
| Өріс`has_audio` | Түріboolean \| null | МағынасыБейнеде аудиожол бар-жоғы; өлшенбесе, null. |
| Өріс`audio_codec` | Түріstring \| null | МағынасыАудио кодегінің идентификаторы; идентификатор тіркелмесе, null. |

Қателер және келесі қадамдар

| Жауап | Шарт | Келесі қадам |
| --- | --- | --- |
| Жауап404 · `not_found_error` | ШартБейнеге қол жеткізу мүмкін емес немесе бұл бейне ID мәні табылмады. | Келесі қадамБейнеге қолжетімділікті тексеріңіз. Бар бейне үшін оның бастапқы ашық ID мәнін және сол API кілтін пайдаланыңыз. |
| Жауап401 · `authentication_error` | ШартAPI кілті аутентификациядан өткен есептік жазбаға сәйкес келмейді. | Келесі қадамЖібермес бұрын API кілтіңізді және есептік жазбаға қолжетімділікті тексеріңіз. |
| Жауап400 · `invalid_request_error` | ШартСұрауды оқу мүмкін болмады немесе жүктеп алу индексі жарамсыз. | Келесі қадамСұрау денесін түзетіңіз. Жүктеп алу үшін бастапқы тапсырма қайтарған шығыс индексін таңдаңыз. |
| Жауап422 · `price_unavailable` | ШартТаңдалған бейне конфигурациясының бағасын есептеу мүмкін емес. | Келесі қадамҚолдау көрсетілетін бейне конфигурациясын таңдап, түзетілген сұрауды жібермес бұрын оның міндетті параметрлерін толтырыңыз. |
| Жауап422 · `invalid_request_error` | ШартКіріс бейне немесе бастапқы жалғастыру тапсырмасы жарамсыз. | Келесі қадамЖарамды HTTPS кірістерін пайдаланыңыз. Жалғастыру үшін аяқталған бастапқы бейнеңіздің ашық ID мәнін сол API кілтімен қолданыңыз. |
| Жауап402 · `billing_error` | ШартҚолда бар баланс немесе лимиттер қаражатты резервтеуге мүмкіндік бермейді. | Келесі қадамЖаңа сұрауды жібермес бұрын қолда бар балансты және лимиттерді тексеріңіз. |
| Жауап503 · `server_error` | ШартБейнені тексеру, сақтау немесе қызметке қол жеткізу уақытша қолжетімсіз. | Келесі қадамҚызметтің қолжетімді болуын күтіңіз. Егер сізде бейне ID мәні бар болса, басқа генерация жасаудың орнына сол бастапқы тапсырманы тексеріңіз. |
| Жауап503 · `result_pending_check` | ШартБастапқы бейне нәтижесі мен есептелген төлемді тексеру қажет. | Келесі қадамҚайтарылған бейне ID мәнін сақтап, сол тапсырманы тексеріңіз. Тексеру жүріп жатқанда оның орнына жаңа генерация сұрауын жібермеңіз. |
| Жауап503 · `owned_result_unavailable` | ШартБар бейнені жүктеп алу уақытша қолжетімсіз. | Келесі қадамСол бейне тапсырмасын кейінірек тексеріп, оның бар шығыс нәтижесін жүктеп алыңыз. Жаңа генерация бөлек операция жасайды. |
| Жауап409 · `video_not_ready` | ШартБейне мазмұны жарияланбаған. | Келесі қадамБастапқы тапсырманың күйін тексеріңіз. completed күйін хабарлағаннан кейін жүктеп алыңыз; failed күйін хабарласа, оның төлемді тексеру туралы ескертуін орындаңыз. |

### Балама атаулар

#### Модельдердің балама атаулары

**Ailoot Ultra** [`heygen/heygen-video-1`](https://ailoot.ai/models/kk/#m=heygen%2Fheygen-video-1&route=Ultra&caller=heygen%2Fheygen-video-1&fmt=videos)

#### Әдіс жолдарының балама атаулары

Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.

#### Шақыруға арналған байланысты ID

[`heygen/heygen-video-1`](https://ailoot.ai/models/kk/#m=heygen%2Fheygen-video-1&route=Ultra&caller=heygen%2Fheygen-video-1&fmt=videos)

FAQ · HeyGen: HeyGen Video

Қандай кіріс деректері мен нәтижелер қолжетімді?

`POST /v1/videos` · `heygen/heygen-video-1`: `text`, `image`, `audio`, `video` → `video`

Сұрау қандай өрістерді пайдаланады?

`POST /v1/videos` · `heygen/heygen-video-1`: `model`, `prompt`, `duration`, `resolution`, `aspect_ratio`, `generate_audio`, `frame_images`, `input_references`, `seed`, `callback_url`, `session_id`, `trace`, `user`

Қандай шектеулер қолданылады?

`POST /v1/videos` · `heygen/heygen-video-1`: `duration.minimum`: `1`; `duration.maximum`: `600`; `frame_images.max_items`: `1`; `frame_images.min_items`: `1`; `seed.minimum`: `-9223372036854775808`; `seed.maximum`: `9223372036854775807`

Ailoot-ты Claude Code, OpenCode, Hermes не қолданбаңызға қосыңыз.

## Компания және оның жобалар портфелі

Компания және оның жобалар портфелі: миллиондаған клиент; ай сайынғы сату көлемі миллиардтармен есептеледі.

## Токенді жеңілдікпен сатып алыңыз.

Тұрақты жұмысқа жазылым жеңілдігі. Токен сатып алуға промокодтар — 50% дейін.

Жазылым

Тұрақты сұрауыңызға жеңілдікті тариф таңдаңыз.

50% дейінгі промокод

Сатып алғанда код енгізіңіз. Баға қазіргі науқанмен қайта есептеледі.

Тарихтағы шығындар

Әр сұрауға модель, токен және сома сақталады.

[Жазылым таңдау](https://ailoot.ai/docs/kk/billing/subscriptions/) · [Модель бағасын көру](https://ailoot.ai/models/kk/)

## API-ді сататын өніміңізге қосыңыз.

SaaS, қолданба мен бот Ailoot офертасы және лицензиялық шартына сай. Қайта сатуға реселлер лицензиясын сұраңыз.

Коммерциялық қолданба

Қызметіңіздің ақылы функциясына мәтін, сурет, бейне және дыбыс жасауды қосыңыз.

Реселлер лицензиясы

Жоба сипаттамасы мен кіру схемасын жіберіңіз. Пайдалану мен қайта сатуға жазбаша шарт сұраңыз.

Сайттағы құжаттар

Оферта, лицензиялық шарт және дерек саясаты қоспай тұрып қолжетімді.

[Реселлер лицензиясын сұрау](mailto:support@ailoot.ai) · [Оферта мен лицензиялық шарт](https://ailoot.ai/legal/offer?lang=kk)

## Ailoot · Компания және оның жобалар портфелі





Ailoot жинақталған жұмыс тәжірибесіне, кең клиенттік базаға, тұрақты қызметке және KPI көрсеткіштерін үздіксіз бақылауға сүйенеді.





Компания және оның жобалар портфелі: миллиондаған клиент; ай сайынғы сату көлемі миллиардтармен есептеледі.





Ailoot осы тәжірибені клиенттердің өнімдерінде, агенттерінде, қолданбаларында және автоматтандыруларында жасанды интеллект мүмкіндіктеріне API арқылы қол жеткізуді қамтамасыз етуге пайдаланады.