HeyGen: HeyGen Video
HeyGen Video мәтіннен, алғашқы суреттен немесе көрнекі және дыбыстық референстерден диалогы, орта үні және әсерлері бар 5–15 секундтық көріністер жасайды. Әмбебап heygen-video-1 моделі өнім мен кейіпкер пландарын, референс басқаруын және MP4 нәтижесін қолдайды. Анық, шектеулі әрекеттер пайдалы өндірістік тапсырма береді.
Модель туралы
Бұл сипаттама модель мүмкіндіктерін қамтиды. 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Бастау
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 сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
Анықтамалық тариф мәліметтері
Модельдің анықтамалық кестелері әдіс таңдауын, баға есебін не төлемді өзгертпейді. Қолданыстағы төлемдер таңдалған 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 · Бейне
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
Тапсырма күйін тексеру
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
Басқа мазмұнды оқу
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
Әдіс жолдарының балама атаулары
Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.
Шақыруға арналған байланысты ID
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