{ "aboutHtml": "

Кейінгі оқытудан өткен жылдам H3 нұсқасы

MiniMax H3 Max — генерацияны жылдамдатуға, промптты орындауға және аудиовизуалдық сапаға оңтайланған MiniMax H3 базалық моделінің кейінгі оқыту нұсқасы. Нұсқаны fal Research кейінгі оқыту арқылы әзірлеген. Ол бірыңғай мультимодальды контексті және бастапқыдан үйлескен сурет пен дыбысты сақтайды. Жылдамдық — жобалау басымдығы; әр промптқа, ұзақтыққа не қолданбаға бекітілген аяқталу уақыты емес.

Max моделін бастапқы H3 жүйесінен және бөлек Max Turbo нұсқасынан ажыратыңыз. MiniMax қазіргі интерфейсі Max үшін 480P не 768P, әдепкі 768P, секундына 24 кадр және 5–15 аралығындағы бүтін секунд ұзақтығын көрсетеді. Құжатталған Max ағыны бастапқы H3 жүйесінің 2K параметрін немесе төрт секундтық нәтижені ұсынбайды.

Промпттан планға

Әр генерацияда бос емес мәтіндік тапсырма болады, әр мәтін элементі 7,000 таңбаға дейін. Нысанды, алғашқы композицияны, әрекетті және нәтижені сипаттап, камера мен дыбыс нұсқауларын анық беріңіз. Қысқа зат ашылымында көрермен алдымен нені көруі керегін, заттың кадрға қалай кіретінін және планның қалай аяқталатынын атаңыз.

Пайдалы бес секундтық тапсырма ағаш үстелдегі керамика кесені, жанына табақша қоятын қолды, камераның аздап жақындауын және керамиканың ағашқа тию дыбысын сипаттай алады. Әрекетті таңдалған ұзақтыққа сыятындай шағын ұстап, қайтарылған қозғалыс пен дыбыстың бір оқиғаға бағынуын тексеріңіз.

Кадрмен бағытталған жасау

Өндіруші алғашқы кадрды, соңғы кадрды немесе екеуін де құжаттайды. Бірінші сурет ролик басталатын күйді, соңғы сурет соңғы көрнекі күйді белгілейді. Оларды жалғайтын қозғалысты, соның ішінде қалып, зат орны, камера не жарық өзгерістерін түсіндіріңіз. Екі кадр ауысуында олардың арасына үйлеспейтін көрініс енгізетін тапсырмадан аулақ болыңыз.

Кадрмен бағытталған нәтиже арақатынасын кіріс суреттен алады. Тек мәтіндік жұмыста 21:9, 16:9, 4:3, 1:1, 3:4 немесе 9:16 ішінен нақты арақатынас таңдаңыз. Референспен бағытталған жұмыс бейімделмелі арақатынасты немесе құжатталған нақты таңдауды қолдана алады. Бір орналасу тік және көлденең пішімге бірдей жарайды деп ойламай, референсті не жазбаша көріністі мақсатты кадрға лайық құрыңыз.

Мультимодальды референстер

MiniMax қазіргі Max генерация схемасы референс суреттерді, бейнені және дыбысты да құжаттайды. Әрқайсысы неге әсер ететінін айтыңыз: кейіпкер тұлғасы, орта, қозғалыс үлгісі, камера траекториясы, дауыс тембрі немесе дыбыс сипаты. Бұл интерфейсте алғашқы/соңғы кадр рөлдері мен референс медиа рөлдері өзара үйлеспейді.

Кейіпкер планы үшін келбет пен қозғалыс референсін бөлек атап, мақсатты әрекет пен айтылатын сөйлемді беріңіз. Орындауды белгілейтін дауыс референсі оның толық дыбыс сигналын көшіруден бөлек. Тапсырмада сақталатын белгілер мен жасалатын өзгерістерді нақты көрсетіп, нақты аудиовизуалдық роликті әр референс рөлімен салыстырыңыз.

Промптты кеңейту

Max-қа тән кеңейту параметрі disabled, balanced және quality таңдауларын ұсынады; әдепкісі — balanced. Берілген тапсырма кеңейтусіз өтуі керек болса disabled таңдаңыз; қосымша түсіндіру қажет болса құжатталған кеңейту режимін қолданыңыз. Кеңейту кезінде енгізілген өзгерісті сұралған мазмұннан ажырату үшін бастапқы тапсырманы сақтаңыз.

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

Кірісті дайындау және шектер

Өндірушінің қазіргі схемасы JPG, JPEG, PNG, WebP, HEIC не HEIF суреттерін, әрқайсысы 30 MB-қа дейін, жақтары 256–5,760 пиксель және арақатынасы 0.4–2.5 аралығында қабылдайды. Алғашқы және соңғы рөлдің әрқайсысына бір сурет, референс режиміне тоғызға дейін сурет беріледі. Нысан мен танылуы қажет бөлшектердің анық көрінісін сақтаңыз.

Референс бейнеге үшке дейін MP4 не MOV ролик рұқсат: әрқайсысы 2–15 секунд, барлығы ең көбі 15 секунд, бір файлға 50 MB шек. H.264 не H.265 бейне, AAC не MP3 дыбыс, 256–5,760 пиксель жақтар, 0.4–2.5 арақатынас және 23.976–60 кадр жиілігі құжатталған. Референс дыбыс үшке дейін WAV не MP3 клипке рұқсат етеді: әрқайсысы 15 MB-қа дейін және 2–15 секунд, жалпы ең көбі 15 секунд. Сұрау денесінің бөлек шегі — 64 MB.

Планға үлес қосатын референстерді ғана пайдаланып, әр үлесін мәтінде атаңыз. Қысқа, қажетті қозғалыс ролигін нұсқау ретінде пайдалану қатысы жоқ оқиғалардың ұзақ жиынынан жеңіл. Нәтижені сол тапсырмамен салыстыру үшін қажетті ұзақтық пен шығыс ажыратымдылығын нақты ұстаңыз.

Дайын нәтиже

Өндірушінің асинхронды ағыны дайын бейне қолжетімді болғанша тапсырма идентификаторын қайтарады. Тапсырма сұрау интерфейсі алдыңғы жеті күндегі тапсырмаларды алады. Монтаж не кейінгі тексеруге нақты қайтарылған роликті және сипаттамасын сақтаңыз; тапсырма идентификаторы аудиовизуалдық артефакт емес. Жүктеу мекенжайлары уақытпен шектеледі, сондықтан таңдалған нәтижені сақтау үшін файлдың өзін қалдырыңыз.

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

", "aboutText": "Кейінгі оқытудан өткен жылдам H3 нұсқасы\n\nMiniMax H3 Max — генерацияны жылдамдатуға, промптты орындауға және аудиовизуалдық сапаға оңтайланған MiniMax H3 базалық моделінің кейінгі оқыту нұсқасы. Нұсқаны fal Research кейінгі оқыту арқылы әзірлеген. Ол бірыңғай мультимодальды контексті және бастапқыдан үйлескен сурет пен дыбысты сақтайды. Жылдамдық — жобалау басымдығы; әр промптқа, ұзақтыққа не қолданбаға бекітілген аяқталу уақыты емес.\n\nMax моделін бастапқы H3 жүйесінен және бөлек Max Turbo нұсқасынан ажыратыңыз. MiniMax қазіргі интерфейсі Max үшін 480P не 768P, әдепкі 768P, секундына 24 кадр және 5–15 аралығындағы бүтін секунд ұзақтығын көрсетеді. Құжатталған Max ағыны бастапқы H3 жүйесінің 2K параметрін немесе төрт секундтық нәтижені ұсынбайды.\n\nПромпттан планға\n\nӘр генерацияда бос емес мәтіндік тапсырма болады, әр мәтін элементі 7,000 таңбаға дейін. Нысанды, алғашқы композицияны, әрекетті және нәтижені сипаттап, камера мен дыбыс нұсқауларын анық беріңіз. Қысқа зат ашылымында көрермен алдымен нені көруі керегін, заттың кадрға қалай кіретінін және планның қалай аяқталатынын атаңыз.\n\nПайдалы бес секундтық тапсырма ағаш үстелдегі керамика кесені, жанына табақша қоятын қолды, камераның аздап жақындауын және керамиканың ағашқа тию дыбысын сипаттай алады. Әрекетті таңдалған ұзақтыққа сыятындай шағын ұстап, қайтарылған қозғалыс пен дыбыстың бір оқиғаға бағынуын тексеріңіз.\n\nКадрмен бағытталған жасау\n\nӨндіруші алғашқы кадрды, соңғы кадрды немесе екеуін де құжаттайды. Бірінші сурет ролик басталатын күйді, соңғы сурет соңғы көрнекі күйді белгілейді. Оларды жалғайтын қозғалысты, соның ішінде қалып, зат орны, камера не жарық өзгерістерін түсіндіріңіз. Екі кадр ауысуында олардың арасына үйлеспейтін көрініс енгізетін тапсырмадан аулақ болыңыз.\n\nКадрмен бағытталған нәтиже арақатынасын кіріс суреттен алады. Тек мәтіндік жұмыста 21:9, 16:9, 4:3, 1:1, 3:4 немесе 9:16 ішінен нақты арақатынас таңдаңыз. Референспен бағытталған жұмыс бейімделмелі арақатынасты немесе құжатталған нақты таңдауды қолдана алады. Бір орналасу тік және көлденең пішімге бірдей жарайды деп ойламай, референсті не жазбаша көріністі мақсатты кадрға лайық құрыңыз.\n\nМультимодальды референстер\n\nMiniMax қазіргі Max генерация схемасы референс суреттерді, бейнені және дыбысты да құжаттайды. Әрқайсысы неге әсер ететінін айтыңыз: кейіпкер тұлғасы, орта, қозғалыс үлгісі, камера траекториясы, дауыс тембрі немесе дыбыс сипаты. Бұл интерфейсте алғашқы/соңғы кадр рөлдері мен референс медиа рөлдері өзара үйлеспейді.\n\nКейіпкер планы үшін келбет пен қозғалыс референсін бөлек атап, мақсатты әрекет пен айтылатын сөйлемді беріңіз. Орындауды белгілейтін дауыс референсі оның толық дыбыс сигналын көшіруден бөлек. Тапсырмада сақталатын белгілер мен жасалатын өзгерістерді нақты көрсетіп, нақты аудиовизуалдық роликті әр референс рөлімен салыстырыңыз.\n\nПромптты кеңейту\n\nMax-қа тән кеңейту параметрі disabled, balanced және quality таңдауларын ұсынады; әдепкісі — balanced. Берілген тапсырма кеңейтусіз өтуі керек болса disabled таңдаңыз; қосымша түсіндіру қажет болса құжатталған кеңейту режимін қолданыңыз. Кеңейту кезінде енгізілген өзгерісті сұралған мазмұннан ажырату үшін бастапқы тапсырманы сақтаңыз.\n\nДыбысты көріністің бөлігі ретінде сипаттаңыз. Физикалық дыбыстарды, орта үнін және айтылатын сөздерді атап, оларды тек көрерменге арналған фон музыкасынан ажыратыңыз. Белгісіз диалог сұрамай, нақты сөйлем мен керекті сөйлеушіні беріңіз. Нәтижені көріп қана қоймай, тыңдаңыз; сенімді сурет сөздердің не уақыттың дұрыс екенін дәлелдемейді.\n\nКірісті дайындау және шектер\n\nӨндірушінің қазіргі схемасы JPG, JPEG, PNG, WebP, HEIC не HEIF суреттерін, әрқайсысы 30 MB-қа дейін, жақтары 256–5,760 пиксель және арақатынасы 0.4–2.5 аралығында қабылдайды. Алғашқы және соңғы рөлдің әрқайсысына бір сурет, референс режиміне тоғызға дейін сурет беріледі. Нысан мен танылуы қажет бөлшектердің анық көрінісін сақтаңыз.\n\nРеференс бейнеге үшке дейін MP4 не MOV ролик рұқсат: әрқайсысы 2–15 секунд, барлығы ең көбі 15 секунд, бір файлға 50 MB шек. H.264 не H.265 бейне, AAC не MP3 дыбыс, 256–5,760 пиксель жақтар, 0.4–2.5 арақатынас және 23.976–60 кадр жиілігі құжатталған. Референс дыбыс үшке дейін WAV не MP3 клипке рұқсат етеді: әрқайсысы 15 MB-қа дейін және 2–15 секунд, жалпы ең көбі 15 секунд. Сұрау денесінің бөлек шегі — 64 MB.\n\nПланға үлес қосатын референстерді ғана пайдаланып, әр үлесін мәтінде атаңыз. Қысқа, қажетті қозғалыс ролигін нұсқау ретінде пайдалану қатысы жоқ оқиғалардың ұзақ жиынынан жеңіл. Нәтижені сол тапсырмамен салыстыру үшін қажетті ұзақтық пен шығыс ажыратымдылығын нақты ұстаңыз.\n\nДайын нәтиже\n\nӨндірушінің асинхронды ағыны дайын бейне қолжетімді болғанша тапсырма идентификаторын қайтарады. Тапсырма сұрау интерфейсі алдыңғы жеті күндегі тапсырмаларды алады. Монтаж не кейінгі тексеруге нақты қайтарылған роликті және сипаттамасын сақтаңыз; тапсырма идентификаторы аудиовизуалдық артефакт емес. Жүктеу мекенжайлары уақытпен шектеледі, сондықтан таңдалған нәтижені сақтау үшін файлдың өзін қалдырыңыз.\n\nНысан сабақтастығын, қозғалысты, көрінетін мәтінді, диалогты және дыбыс уақытын ролик қолданылатын өлшемде тексеріңіз. Келесі шығармашылық тапсырмаға нақты кері байланыс беріңіз: өзгерген ым, түсіп қалған сөйлем немесе түзетілетін кадрлау. Пайдалы нәтиже — берілген мазмұнмен және анық референс байланыстарымен сабақтас қысқа аудиовизуалдық план.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "93314b92a07ed79a8603b6243351c16c8f932c9e14d682e0ff18956c55547004", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "kk", "methods": [ { "html": "
MM

MiniMax: H3 Max

MiniMax /minimax/hailuo-3-max

Бастау

MiniMax H3 Max — үйлескен дыбысы бар қысқа бейнеге арналған, кейінгі оқытудан өткен жылдам H3 нұсқасы. MiniMax құжатталған ағыны мәтінді, кадр суреттерін және мультимодальды референстерді қолдайды; 480P не 768P нәтиже, 5–15 секунд ұзақтық және өзіндік промпт кеңейту таңдаулары бар.

Қабылданатын кіріс деректері
Мәтін · Суреттер
Нәтижелер
Бейне
Модель туралы

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

Кейінгі оқытудан өткен жылдам H3 нұсқасы

MiniMax H3 Max — генерацияны жылдамдатуға, промптты орындауға және аудиовизуалдық сапаға оңтайланған MiniMax H3 базалық моделінің кейінгі оқыту нұсқасы. Нұсқаны fal Research кейінгі оқыту арқылы әзірлеген. Ол бірыңғай мультимодальды контексті және бастапқыдан үйлескен сурет пен дыбысты сақтайды. Жылдамдық — жобалау басымдығы; әр промптқа, ұзақтыққа не қолданбаға бекітілген аяқталу уақыты емес.

Max моделін бастапқы H3 жүйесінен және бөлек Max Turbo нұсқасынан ажыратыңыз. MiniMax қазіргі интерфейсі Max үшін 480P не 768P, әдепкі 768P, секундына 24 кадр және 5–15 аралығындағы бүтін секунд ұзақтығын көрсетеді. Құжатталған Max ағыны бастапқы H3 жүйесінің 2K параметрін немесе төрт секундтық нәтижені ұсынбайды.

Промпттан планға

Әр генерацияда бос емес мәтіндік тапсырма болады, әр мәтін элементі 7,000 таңбаға дейін. Нысанды, алғашқы композицияны, әрекетті және нәтижені сипаттап, камера мен дыбыс нұсқауларын анық беріңіз. Қысқа зат ашылымында көрермен алдымен нені көруі керегін, заттың кадрға қалай кіретінін және планның қалай аяқталатынын атаңыз.

Пайдалы бес секундтық тапсырма ағаш үстелдегі керамика кесені, жанына табақша қоятын қолды, камераның аздап жақындауын және керамиканың ағашқа тию дыбысын сипаттай алады. Әрекетті таңдалған ұзақтыққа сыятындай шағын ұстап, қайтарылған қозғалыс пен дыбыстың бір оқиғаға бағынуын тексеріңіз.

Кадрмен бағытталған жасау

Өндіруші алғашқы кадрды, соңғы кадрды немесе екеуін де құжаттайды. Бірінші сурет ролик басталатын күйді, соңғы сурет соңғы көрнекі күйді белгілейді. Оларды жалғайтын қозғалысты, соның ішінде қалып, зат орны, камера не жарық өзгерістерін түсіндіріңіз. Екі кадр ауысуында олардың арасына үйлеспейтін көрініс енгізетін тапсырмадан аулақ болыңыз.

Кадрмен бағытталған нәтиже арақатынасын кіріс суреттен алады. Тек мәтіндік жұмыста 21:9, 16:9, 4:3, 1:1, 3:4 немесе 9:16 ішінен нақты арақатынас таңдаңыз. Референспен бағытталған жұмыс бейімделмелі арақатынасты немесе құжатталған нақты таңдауды қолдана алады. Бір орналасу тік және көлденең пішімге бірдей жарайды деп ойламай, референсті не жазбаша көріністі мақсатты кадрға лайық құрыңыз.

Мультимодальды референстер

MiniMax қазіргі Max генерация схемасы референс суреттерді, бейнені және дыбысты да құжаттайды. Әрқайсысы неге әсер ететінін айтыңыз: кейіпкер тұлғасы, орта, қозғалыс үлгісі, камера траекториясы, дауыс тембрі немесе дыбыс сипаты. Бұл интерфейсте алғашқы/соңғы кадр рөлдері мен референс медиа рөлдері өзара үйлеспейді.

Кейіпкер планы үшін келбет пен қозғалыс референсін бөлек атап, мақсатты әрекет пен айтылатын сөйлемді беріңіз. Орындауды белгілейтін дауыс референсі оның толық дыбыс сигналын көшіруден бөлек. Тапсырмада сақталатын белгілер мен жасалатын өзгерістерді нақты көрсетіп, нақты аудиовизуалдық роликті әр референс рөлімен салыстырыңыз.

Промптты кеңейту

Max-қа тән кеңейту параметрі disabled, balanced және quality таңдауларын ұсынады; әдепкісі — balanced. Берілген тапсырма кеңейтусіз өтуі керек болса disabled таңдаңыз; қосымша түсіндіру қажет болса құжатталған кеңейту режимін қолданыңыз. Кеңейту кезінде енгізілген өзгерісті сұралған мазмұннан ажырату үшін бастапқы тапсырманы сақтаңыз.

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

Кірісті дайындау және шектер

Өндірушінің қазіргі схемасы JPG, JPEG, PNG, WebP, HEIC не HEIF суреттерін, әрқайсысы 30 MB-қа дейін, жақтары 256–5,760 пиксель және арақатынасы 0.4–2.5 аралығында қабылдайды. Алғашқы және соңғы рөлдің әрқайсысына бір сурет, референс режиміне тоғызға дейін сурет беріледі. Нысан мен танылуы қажет бөлшектердің анық көрінісін сақтаңыз.

Референс бейнеге үшке дейін MP4 не MOV ролик рұқсат: әрқайсысы 2–15 секунд, барлығы ең көбі 15 секунд, бір файлға 50 MB шек. H.264 не H.265 бейне, AAC не MP3 дыбыс, 256–5,760 пиксель жақтар, 0.4–2.5 арақатынас және 23.976–60 кадр жиілігі құжатталған. Референс дыбыс үшке дейін WAV не MP3 клипке рұқсат етеді: әрқайсысы 15 MB-қа дейін және 2–15 секунд, жалпы ең көбі 15 секунд. Сұрау денесінің бөлек шегі — 64 MB.

Планға үлес қосатын референстерді ғана пайдаланып, әр үлесін мәтінде атаңыз. Қысқа, қажетті қозғалыс ролигін нұсқау ретінде пайдалану қатысы жоқ оқиғалардың ұзақ жиынынан жеңіл. Нәтижені сол тапсырмамен салыстыру үшін қажетті ұзақтық пен шығыс ажыратымдылығын нақты ұстаңыз.

Дайын нәтиже

Өндірушінің асинхронды ағыны дайын бейне қолжетімді болғанша тапсырма идентификаторын қайтарады. Тапсырма сұрау интерфейсі алдыңғы жеті күндегі тапсырмаларды алады. Монтаж не кейінгі тексеруге нақты қайтарылған роликті және сипаттамасын сақтаңыз; тапсырма идентификаторы аудиовизуалдық артефакт емес. Жүктеу мекенжайлары уақытпен шектеледі, сондықтан таңдалған нәтижені сақтау үшін файлдың өзін қалдырыңыз.

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

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

Ailoot Ultra · Бейне POST /v1/videos
Кіріс
text, image
Шығыс
video
Шығыс пішімі
бастапқы MP4 байттары; қалыпқа келтірусіз/қайта кодтаусыз
ӨрісТүріТалапМәндер мен шектеулерӘдепкі
ӨрісmodelТүріstringТалапМіндеттіМәндер мен шектеулер
minimax/hailuo-3-max
Әдепкі—
ӨрісpromptТүріstringТалапМіндеттіМәндер мен шектеулерӘдепкі—
ӨрісdurationТүріintegerТалапМіндеттіМәндер мен шектеулер
5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Ең азы: 1
Ең көбі: 600
Әдепкі—
ӨрісresolutionТүріstringТалапМіндетті емесМәндер мен шектеулер
768p, 480p
Әдепкі—
Өрісaspect_ratioТүріstringТалапМіндетті емесМәндер мен шектеулер
21:9, 16:9, 4:3, 1:1, 3:4, 9:16
Әдепкі—
Өрісgenerate_audioТүріbooleanТалапМіндетті емесМәндер мен шектеулер
false
Әдепкі—
Өрісframe_imagesТүріarrayТалапМіндетті емесМәндер мен шектеулер
Элементтердің ең аз саны: 1
Элементтердің ең көп саны: 2
Кіріс мазмұны: Кадр объектілерінің массиві. Әр объектіде type=image_url, ішінде url бар image_url және frame_type өрістері болады. HTTPS сурет URL мекенжайын пайдаланып, frame_type өрісіне first_frame немесе last_frame мәнін орнатыңыз. Әр кадр рөлі ең көбі бір рет кездеседі.
Нақты кілттер: type, image_url, frame_type
Шарттар: Бұл кілттер әр кадр объектісін сипаттайды; image_url ішінде тек url болады. Тек мәтіндік сұрауда frame_images өрісін қоспаңыз.
Әдепкі—
Өрісinput_referencesТүріarrayТалапМіндетті емесМәндер мен шектеулерӘдепкі—
Өрісcallback_urlТүріstringТалапМіндетті емесМәндер мен шектеулер
Үлгі: ^https://
Әдепкі—
Өрісsession_idТүріstringТалапМіндетті емесМәндер мен шектеулерӘдепкі—
ӨрісtraceТүріobjectТалапМіндетті емесМәндер мен шектеулерӘдепкі—
ӨрісuserТүріstringТалапМіндетті емесМәндер мен шектеулерӘдепкі—
Кіріс материалдарының үйлесімдері

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

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

model: Түрі: string · minimax/hailuo-3-max

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 мәнін қолданыңыз, last_frame міндетті емес. Әр кадр рөлі ең көбі бір рет кездеседі. Әр кадр үшін жалпыға қолжетімді HTTPS сурет URL мекенжайын беріңіз. Қолдау көрсетілетін ажыратымдылықты және қажет болса, жақтар арақатынасын таңдаңыз.

Нақты кілттер: type, image_url, frame_type

model: Түрі: string · minimax/hailuo-3-max

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

Әдіс параметрлері мен өмірлік циклі
ПараметрПараметр талаптары
Параметрcontent_typeПараметр талаптарыapplication/json
ПараметрrequiredПараметр талаптарыmodel, prompt, duration
Параметрmaterial_typesПараметр талаптарыtext, image
Параметрadditional_propertiesПараметр талаптарыfalse
Параметрoptional_controlsПараметр талаптарыresolution, aspect_ratio, generate_audio, frame_images, input_references, 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 токен
БаптауБейне шығысы · Анықтамалық тарифМөлшерлемелер кестесі—Болжамды мөлшер—Төлем құрамдасыreference_output_rateЕсептеу бірлігінәтиженің секунды үшінТөлемді есептеу шарттары—Төлем
Шығыс · Шығыс видео секундының анықтамалық тарифі · Тек салыстыруға арналған бағалау $0.16 нәтиженің секунды үшін
БаптауБейне бағасыМөлшерлемелер кестесі—Болжамды мөлшер—Төлем құрамдасы—Есептеу бірлігібейне секунды үшінТөлемді есептеу шарттарыresolution: 480pТөлем
Шығыс · Видео бағасы · Тек салыстыруға арналған бағалау $0.1 бейне секунды үшін
БаптауБейне бағасыМөлшерлемелер кестесі—Болжамды мөлшер—Төлем құрамдасы—Есептеу бірлігібейне секунды үшінТөлемді есептеу шарттарыresolution: 768pТөлем
Шығыс · Видео бағасы · Тек салыстыруға арналған бағалау $0.16 бейне секунды үшін
БаптауГенерацияның болжамды құныМөлшерлемелер кестесі—Болжамды мөлшербір генерацияға арналған болжамТөлем құрамдасы—Есептеу бірлігі—Төлемді есептеу шарттары—Төлем
Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.5 жасауға дейінгі бағалау

Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.

Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →

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

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

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

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

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

БаптауТөлемді есептеу шарттарыТөлем
БаптауБейне бағасыТөлемді есептеу шарттарыБұл баға кілтінде қосымша шарт көрсетілмеген.Төлем
Шығыс · Видео бағасы $0.16 бейне секунды үшін

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

БаптауБейне бағасыТөлемді есептеу шарттарыresolution: 480pТөлем
Шығыс · Видео бағасы $0.1 бейне секунды үшін

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

БаптауБейне бағасыТөлемді есептеу шарттарыresolution: 768pТөлем
Шығыс · Видео бағасы $0.16 бейне секунды үшін

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

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

Ailoot Ultra · Бейне

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"minimax/hailuo-3-max","prompt":"A serene mountain landscape at sunset","resolution":"480p"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\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,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n

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

Ailoot Ultra · Бейне

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

Тапсырма күйін тексеру
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error "$(cat status-url.txt)" \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n
Басқа мазмұнды оқу
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n    urls.append((str(i),u))\nfor label,path in urls:\n    u=urljoin('https://api.ailoot.ai',path);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 returned Ailoot owned content URL')\n    target=Path('owned-'+label+'.bin')\n    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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n
Барлық дайын нәтижені сақтау

Әр дайын бейнені немесе қайтарылған файлды сақтаңыз; нақты қайтарылған әр материал 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 minimax/hailuo-3-max

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

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

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

minimax/hailuo-3-max

", "method_identity": { "effective_request_model_id": "minimax/hailuo-3-max", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "minimax/hailuo-3-max", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|minimax%2Fhailuo-3-max", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Иелігіңіздегі әрбір нақты шығыс нәтижесін және онымен қайтарылған өлшенген метадеректерді сақтаңыз.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "Бейнеге қол жеткізу мүмкін емес немесе бұл бейне ID мәні табылмады.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Бейнеге қолжетімділікті тексеріңіз. Бар бейне үшін оның бастапқы ашық ID мәнін және сол API кілтін пайдаланыңыз.", "type": "not_found_error" }, { "condition": "API кілті аутентификациядан өткен есептік жазбаға сәйкес келмейді.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Жібермес бұрын API кілтіңізді және есептік жазбаға қолжетімділікті тексеріңіз.", "type": "authentication_error" }, { "condition": "Сұрауды оқу мүмкін болмады немесе жүктеп алу индексі жарамсыз.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Сұрау денесін түзетіңіз. Жүктеп алу үшін бастапқы тапсырма қайтарған шығыс индексін таңдаңыз.", "type": "invalid_request_error" }, { "condition": "Таңдалған бейне конфигурациясының бағасын есептеу мүмкін емес.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Қолдау көрсетілетін бейне конфигурациясын таңдап, түзетілген сұрауды жібермес бұрын оның міндетті параметрлерін толтырыңыз.", "type": "price_unavailable" }, { "condition": "Кіріс бейне немесе бастапқы жалғастыру тапсырмасы жарамсыз.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Жарамды HTTPS кірістерін пайдаланыңыз. Жалғастыру үшін аяқталған бастапқы бейнеңіздің ашық ID мәнін сол API кілтімен қолданыңыз.", "type": "invalid_request_error" }, { "condition": "Қолда бар баланс немесе лимиттер қаражатты резервтеуге мүмкіндік бермейді.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Жаңа сұрауды жібермес бұрын қолда бар балансты және лимиттерді тексеріңіз.", "type": "billing_error" }, { "condition": "Бейнені тексеру, сақтау немесе қызметке қол жеткізу уақытша қолжетімсіз.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Қызметтің қолжетімді болуын күтіңіз. Егер сізде бейне ID мәні бар болса, басқа генерация жасаудың орнына сол бастапқы тапсырманы тексеріңіз.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Бастапқы бейне нәтижесі мен есептелген төлемді тексеру қажет.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Қайтарылған бейне ID мәнін сақтап, сол тапсырманы тексеріңіз. Тексеру жүріп жатқанда оның орнына жаңа генерация сұрауын жібермеңіз.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Бар бейнені жүктеп алу уақытша қолжетімсіз.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Сол бейне тапсырмасын кейінірек тексеріп, оның бар шығыс нәтижесін жүктеп алыңыз. Жаңа генерация бөлек операция жасайды.", "type": "server_error" }, { "condition": "Бейне мазмұны жарияланбаған.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Бастапқы тапсырманың күйін тексеріңіз. completed күйін хабарлағаннан кейін жүктеп алыңыз; failed күйін хабарласа, оның төлемді тексеру туралы ескертуін орындаңыз.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + бастапқы id + X-Should-Retry:false; бастапқы сұрауды ешқашан қайталамаңыз" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Промптты мәтін түрінде, ал ұзақтықты бүтін секундпен беріңіз. Қолдау көрсетілетін ажыратымдылықты және қажет болса, жақтар арақатынасын таңдаңыз.", "required": [ "model", "prompt", "duration" ], "required_material": "Жазбаша промпт." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images — массив. Әр кадр объектісінде type, image_url және frame_type өрістері бар; image_url ішінде url болады. type өрісіне image_url мәнін орнатыңыз. first_frame мәнін қолданыңыз, last_frame міндетті емес. Әр кадр рөлі ең көбі бір рет кездеседі. Әр кадр үшін жалпыға қолжетімді HTTPS сурет URL мекенжайын беріңіз. Қолдау көрсетілетін ажыратымдылықты және қажет болса, жақтар арақатынасын таңдаңыз.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Жазбаша промпт және алғашқы кадр суреті." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Осы бейненің шығыс тізіміндегі нөлден басталатын орны.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Осы аяқталған бейнені жүктеп алуға арналған қолтаңбасы бар HTTPS URL мекенжайы.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "Бастапқы бейне байттарының SHA-256 хэші; қолжетімсіз болса, null.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Бастапқы бейне файлының байтпен өлшенетін көлемі; қолжетімсіз болса, null.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Бейненің миллисекундпен өлшенген ұзақтығы; қолжетімсіз болса, null.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Бейненің пиксельмен өлшенетін ені; қолжетімсіз болса, null.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Бейненің пиксельмен өлшенетін биіктігі; қолжетімсіз болса, null.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Бейне кодегінің идентификаторы; тіркелмесе, null.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Бейнеде аудиожол бар-жоғы; өлшенбесе, null.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Аудио кодегінің идентификаторы; идентификатор тіркелмесе, null.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "иелігіңіздегі мазмұнның қолтаңбасы бар URL мекенжайлары", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "minimax/hailuo-3-max" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "768p", "480p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "768p", "480p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Бұл кілттер әр кадр объектісін сипаттайды; image_url ішінде тек url болады. Тек мәтіндік сұрауда frame_images өрісін қоспаңыз.", "content": "Кадр объектілерінің массиві. Әр объектіде type=image_url, ішінде url бар image_url және frame_type өрістері болады. HTTPS сурет URL мекенжайын пайдаланып, frame_type өрісіне first_frame немесе last_frame мәнін орнатыңыз. Әр кадр рөлі ең көбі бір рет кездеседі.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxItems": 0, "name": "input_references", "required": false, "schema": { "items": false, "maxItems": 0, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": false, "maxItems": 0, "type": "array" }, "model": { "const": "minimax/hailuo-3-max" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "768p", "480p" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": false, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist." ] }, "unsupported": [ "size", "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_component_role": "reference_output_rate", "billing_input": false, "estimate_only": true, "fallback_reference": true, "quoted_unit": "per output second", "selectable_request_branch": false, "selector_reference_only": true }, "label": "Бейне шығысы · Анықтамалық тариф", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" } ] }, { "dimensions": { "conditions": "resolution: 480p", "quoted_unit": "per video second" }, "label": "Бейне бағасы", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 768p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Генерацияның болжамды құны", "units": [ { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"minimax/hailuo-3-max\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"480p\"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\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,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);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 returned Ailoot owned content URL')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_component_role": "reference_output_rate", "billing_input": false, "estimate_only": true, "fallback_reference": true, "quoted_unit": "per output second", "selectable_request_branch": false, "selector_reference_only": true }, "label": "Video output · reference rate", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" } ] }, { "dimensions": { "conditions": "resolution: 480p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 768p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "minimax/hailuo-3-max", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" }, { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "minimax/hailuo-3-max", "nativeProvenance": { "input_facts_canonical_sha256": "b6e14c23f12ba076a83a71056ffe970b53116b732ecf9043233eb6da8633aa3d", "input_html_sha256": "a467e2175fd3e57f7277d013b36457d93a3c776e9e895b6a561ac4846232dff5", "private_audit_sha256": "dd4b228113bb927fe2d9095c2bf17aac393a14d1ba2f3aefee3d83c1fc5253d3", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/kk/minimax-hailuo-3-max/", "description": "MiniMax H3 Max — үйлескен дыбысы бар қысқа бейнеге арналған, кейінгі оқытудан өткен жылдам H3 нұсқасы. MiniMax құжатталған ағыны мәтінді, кадр суреттерін және мультимодальды референстерді қолдайды; 480P не 768P нәтиже, 5–15 секунд ұзақтық және өзіндік промпт кеңейту таңдаулары бар.", "locale": "kk", "md_url": "https://ailoot.ai/models/kk/minimax-hailuo-3-max/index.md", "title": "MiniMax: H3 Max — Ailoot", "url": "https://ailoot.ai/models/kk/minimax-hailuo-3-max/" }, "rawModel": { "about": "Кейінгі оқытудан өткен жылдам H3 нұсқасы\n\nMiniMax H3 Max — генерацияны жылдамдатуға, промптты орындауға және аудиовизуалдық сапаға оңтайланған MiniMax H3 базалық моделінің кейінгі оқыту нұсқасы. Нұсқаны fal Research кейінгі оқыту арқылы әзірлеген. Ол бірыңғай мультимодальды контексті және бастапқыдан үйлескен сурет пен дыбысты сақтайды. Жылдамдық — жобалау басымдығы; әр промптқа, ұзақтыққа не қолданбаға бекітілген аяқталу уақыты емес.\n\nMax моделін бастапқы H3 жүйесінен және бөлек Max Turbo нұсқасынан ажыратыңыз. MiniMax қазіргі интерфейсі Max үшін 480P не 768P, әдепкі 768P, секундына 24 кадр және 5–15 аралығындағы бүтін секунд ұзақтығын көрсетеді. Құжатталған Max ағыны бастапқы H3 жүйесінің 2K параметрін немесе төрт секундтық нәтижені ұсынбайды.\n\nПромпттан планға\n\nӘр генерацияда бос емес мәтіндік тапсырма болады, әр мәтін элементі 7,000 таңбаға дейін. Нысанды, алғашқы композицияны, әрекетті және нәтижені сипаттап, камера мен дыбыс нұсқауларын анық беріңіз. Қысқа зат ашылымында көрермен алдымен нені көруі керегін, заттың кадрға қалай кіретінін және планның қалай аяқталатынын атаңыз.\n\nПайдалы бес секундтық тапсырма ағаш үстелдегі керамика кесені, жанына табақша қоятын қолды, камераның аздап жақындауын және керамиканың ағашқа тию дыбысын сипаттай алады. Әрекетті таңдалған ұзақтыққа сыятындай шағын ұстап, қайтарылған қозғалыс пен дыбыстың бір оқиғаға бағынуын тексеріңіз.\n\nКадрмен бағытталған жасау\n\nӨндіруші алғашқы кадрды, соңғы кадрды немесе екеуін де құжаттайды. Бірінші сурет ролик басталатын күйді, соңғы сурет соңғы көрнекі күйді белгілейді. Оларды жалғайтын қозғалысты, соның ішінде қалып, зат орны, камера не жарық өзгерістерін түсіндіріңіз. Екі кадр ауысуында олардың арасына үйлеспейтін көрініс енгізетін тапсырмадан аулақ болыңыз.\n\nКадрмен бағытталған нәтиже арақатынасын кіріс суреттен алады. Тек мәтіндік жұмыста 21:9, 16:9, 4:3, 1:1, 3:4 немесе 9:16 ішінен нақты арақатынас таңдаңыз. Референспен бағытталған жұмыс бейімделмелі арақатынасты немесе құжатталған нақты таңдауды қолдана алады. Бір орналасу тік және көлденең пішімге бірдей жарайды деп ойламай, референсті не жазбаша көріністі мақсатты кадрға лайық құрыңыз.\n\nМультимодальды референстер\n\nMiniMax қазіргі Max генерация схемасы референс суреттерді, бейнені және дыбысты да құжаттайды. Әрқайсысы неге әсер ететінін айтыңыз: кейіпкер тұлғасы, орта, қозғалыс үлгісі, камера траекториясы, дауыс тембрі немесе дыбыс сипаты. Бұл интерфейсте алғашқы/соңғы кадр рөлдері мен референс медиа рөлдері өзара үйлеспейді.\n\nКейіпкер планы үшін келбет пен қозғалыс референсін бөлек атап, мақсатты әрекет пен айтылатын сөйлемді беріңіз. Орындауды белгілейтін дауыс референсі оның толық дыбыс сигналын көшіруден бөлек. Тапсырмада сақталатын белгілер мен жасалатын өзгерістерді нақты көрсетіп, нақты аудиовизуалдық роликті әр референс рөлімен салыстырыңыз.\n\nПромптты кеңейту\n\nMax-қа тән кеңейту параметрі disabled, balanced және quality таңдауларын ұсынады; әдепкісі — balanced. Берілген тапсырма кеңейтусіз өтуі керек болса disabled таңдаңыз; қосымша түсіндіру қажет болса құжатталған кеңейту режимін қолданыңыз. Кеңейту кезінде енгізілген өзгерісті сұралған мазмұннан ажырату үшін бастапқы тапсырманы сақтаңыз.\n\nДыбысты көріністің бөлігі ретінде сипаттаңыз. Физикалық дыбыстарды, орта үнін және айтылатын сөздерді атап, оларды тек көрерменге арналған фон музыкасынан ажыратыңыз. Белгісіз диалог сұрамай, нақты сөйлем мен керекті сөйлеушіні беріңіз. Нәтижені көріп қана қоймай, тыңдаңыз; сенімді сурет сөздердің не уақыттың дұрыс екенін дәлелдемейді.\n\nКірісті дайындау және шектер\n\nӨндірушінің қазіргі схемасы JPG, JPEG, PNG, WebP, HEIC не HEIF суреттерін, әрқайсысы 30 MB-қа дейін, жақтары 256–5,760 пиксель және арақатынасы 0.4–2.5 аралығында қабылдайды. Алғашқы және соңғы рөлдің әрқайсысына бір сурет, референс режиміне тоғызға дейін сурет беріледі. Нысан мен танылуы қажет бөлшектердің анық көрінісін сақтаңыз.\n\nРеференс бейнеге үшке дейін MP4 не MOV ролик рұқсат: әрқайсысы 2–15 секунд, барлығы ең көбі 15 секунд, бір файлға 50 MB шек. H.264 не H.265 бейне, AAC не MP3 дыбыс, 256–5,760 пиксель жақтар, 0.4–2.5 арақатынас және 23.976–60 кадр жиілігі құжатталған. Референс дыбыс үшке дейін WAV не MP3 клипке рұқсат етеді: әрқайсысы 15 MB-қа дейін және 2–15 секунд, жалпы ең көбі 15 секунд. Сұрау денесінің бөлек шегі — 64 MB.\n\nПланға үлес қосатын референстерді ғана пайдаланып, әр үлесін мәтінде атаңыз. Қысқа, қажетті қозғалыс ролигін нұсқау ретінде пайдалану қатысы жоқ оқиғалардың ұзақ жиынынан жеңіл. Нәтижені сол тапсырмамен салыстыру үшін қажетті ұзақтық пен шығыс ажыратымдылығын нақты ұстаңыз.\n\nДайын нәтиже\n\nӨндірушінің асинхронды ағыны дайын бейне қолжетімді болғанша тапсырма идентификаторын қайтарады. Тапсырма сұрау интерфейсі алдыңғы жеті күндегі тапсырмаларды алады. Монтаж не кейінгі тексеруге нақты қайтарылған роликті және сипаттамасын сақтаңыз; тапсырма идентификаторы аудиовизуалдық артефакт емес. Жүктеу мекенжайлары уақытпен шектеледі, сондықтан таңдалған нәтижені сақтау үшін файлдың өзін қалдырыңыз.\n\nНысан сабақтастығын, қозғалысты, көрінетін мәтінді, диалогты және дыбыс уақытын ролик қолданылатын өлшемде тексеріңіз. Келесі шығармашылық тапсырмаға нақты кері байланыс беріңіз: өзгерген ым, түсіп қалған сөйлем немесе түзетілетін кадрлау. Пайдалы нәтиже — берілген мазмұнмен және анық референс байланыстарымен сабақтас қысқа аудиовизуалдық план.", "alias_of": null, "aliases": [], "author": "MiniMax", "available": null, "canonical_model": "minimax/hailuo-3-max", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "Конфигурация бағалары туралы толық ақпарат — егжей-тегжейлі мәліметтерде." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "c3ee132fc5b4cd02f24f5c4d", "label": "Бейне конфигурацияларының баға сілтемелері", "profiles": [ { "basis": "Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады.", "dimensions": { "conditions": "Бұл баға кілтінде қосымша шарт көрсетілмеген." }, "label": "Бейне бағасы", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] }, { "basis": "Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады.", "dimensions": { "conditions": "resolution: 480p" }, "label": "Бейне бағасы", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] }, { "basis": "Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады.", "dimensions": { "conditions": "resolution: 768p" }, "label": "Бейне бағасы", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "minimax/hailuo-3-max", "input": [ "text", "image" ], "kind": "video", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Иелігіңіздегі әрбір нақты шығыс нәтижесін және онымен қайтарылған өлшенген метадеректерді сақтаңыз.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "Бейнеге қол жеткізу мүмкін емес немесе бұл бейне ID мәні табылмады.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Бейнеге қолжетімділікті тексеріңіз. Бар бейне үшін оның бастапқы ашық ID мәнін және сол API кілтін пайдаланыңыз.", "type": "not_found_error" }, { "condition": "API кілті аутентификациядан өткен есептік жазбаға сәйкес келмейді.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Жібермес бұрын API кілтіңізді және есептік жазбаға қолжетімділікті тексеріңіз.", "type": "authentication_error" }, { "condition": "Сұрауды оқу мүмкін болмады немесе жүктеп алу индексі жарамсыз.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Сұрау денесін түзетіңіз. Жүктеп алу үшін бастапқы тапсырма қайтарған шығыс индексін таңдаңыз.", "type": "invalid_request_error" }, { "condition": "Таңдалған бейне конфигурациясының бағасын есептеу мүмкін емес.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Қолдау көрсетілетін бейне конфигурациясын таңдап, түзетілген сұрауды жібермес бұрын оның міндетті параметрлерін толтырыңыз.", "type": "price_unavailable" }, { "condition": "Кіріс бейне немесе бастапқы жалғастыру тапсырмасы жарамсыз.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Жарамды HTTPS кірістерін пайдаланыңыз. Жалғастыру үшін аяқталған бастапқы бейнеңіздің ашық ID мәнін сол API кілтімен қолданыңыз.", "type": "invalid_request_error" }, { "condition": "Қолда бар баланс немесе лимиттер қаражатты резервтеуге мүмкіндік бермейді.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Жаңа сұрауды жібермес бұрын қолда бар балансты және лимиттерді тексеріңіз.", "type": "billing_error" }, { "condition": "Бейнені тексеру, сақтау немесе қызметке қол жеткізу уақытша қолжетімсіз.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Қызметтің қолжетімді болуын күтіңіз. Егер сізде бейне ID мәні бар болса, басқа генерация жасаудың орнына сол бастапқы тапсырманы тексеріңіз.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Бастапқы бейне нәтижесі мен есептелген төлемді тексеру қажет.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Қайтарылған бейне ID мәнін сақтап, сол тапсырманы тексеріңіз. Тексеру жүріп жатқанда оның орнына жаңа генерация сұрауын жібермеңіз.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Бар бейнені жүктеп алу уақытша қолжетімсіз.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Сол бейне тапсырмасын кейінірек тексеріп, оның бар шығыс нәтижесін жүктеп алыңыз. Жаңа генерация бөлек операция жасайды.", "type": "server_error" }, { "condition": "Бейне мазмұны жарияланбаған.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Бастапқы тапсырманың күйін тексеріңіз. completed күйін хабарлағаннан кейін жүктеп алыңыз; failed күйін хабарласа, оның төлемді тексеру туралы ескертуін орындаңыз.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + бастапқы id + X-Should-Retry:false; бастапқы сұрауды ешқашан қайталамаңыз" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Промптты мәтін түрінде, ал ұзақтықты бүтін секундпен беріңіз. Қолдау көрсетілетін ажыратымдылықты және қажет болса, жақтар арақатынасын таңдаңыз.", "required": [ "model", "prompt", "duration" ], "required_material": "Жазбаша промпт." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images — массив. Әр кадр объектісінде type, image_url және frame_type өрістері бар; image_url ішінде url болады. type өрісіне image_url мәнін орнатыңыз. first_frame мәнін қолданыңыз, last_frame міндетті емес. Әр кадр рөлі ең көбі бір рет кездеседі. Әр кадр үшін жалпыға қолжетімді HTTPS сурет URL мекенжайын беріңіз. Қолдау көрсетілетін ажыратымдылықты және қажет болса, жақтар арақатынасын таңдаңыз.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Жазбаша промпт және алғашқы кадр суреті." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Осы бейненің шығыс тізіміндегі нөлден басталатын орны.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Осы аяқталған бейнені жүктеп алуға арналған қолтаңбасы бар HTTPS URL мекенжайы.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "Бастапқы бейне байттарының SHA-256 хэші; қолжетімсіз болса, null.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Бастапқы бейне файлының байтпен өлшенетін көлемі; қолжетімсіз болса, null.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Бейненің миллисекундпен өлшенген ұзақтығы; қолжетімсіз болса, null.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Бейненің пиксельмен өлшенетін ені; қолжетімсіз болса, null.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Бейненің пиксельмен өлшенетін биіктігі; қолжетімсіз болса, null.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Бейне кодегінің идентификаторы; тіркелмесе, null.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Бейнеде аудиожол бар-жоғы; өлшенбесе, null.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Аудио кодегінің идентификаторы; идентификатор тіркелмесе, null.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "иелігіңіздегі мазмұнның қолтаңбасы бар URL мекенжайлары", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "minimax/hailuo-3-max" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "minimax/hailuo-3-max" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "768p", "480p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "768p", "480p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Бұл кілттер әр кадр объектісін сипаттайды; image_url ішінде тек url болады. Тек мәтіндік сұрауда frame_images өрісін қоспаңыз.", "content": "Кадр объектілерінің массиві. Әр объектіде type=image_url, ішінде url бар image_url және frame_type өрістері болады. HTTPS сурет URL мекенжайын пайдаланып, frame_type өрісіне first_frame немесе last_frame мәнін орнатыңыз. Әр кадр рөлі ең көбі бір рет кездеседі.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxItems": 0, "name": "input_references", "required": false, "schema": { "items": false, "maxItems": 0, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": false, "maxItems": 0, "type": "array" }, "model": { "const": "minimax/hailuo-3-max" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "768p", "480p" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": false, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist." ] }, "unsupported": [ "size", "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_component_role": "reference_output_rate", "billing_input": false, "estimate_only": true, "fallback_reference": true, "quoted_unit": "per output second", "selectable_request_branch": false, "selector_reference_only": true }, "label": "Бейне шығысы · Анықтамалық тариф", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" } ] }, { "dimensions": { "conditions": "resolution: 480p", "quoted_unit": "per video second" }, "label": "Бейне бағасы", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 768p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Генерацияның болжамды құны", "units": [ { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"minimax/hailuo-3-max\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"480p\"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\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,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);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 returned Ailoot owned content URL')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "billing_component_role": "reference_output_rate", "billing_input": false, "estimate_only": true, "fallback_reference": true, "quoted_unit": "per output second", "selectable_request_branch": false, "selector_reference_only": true }, "label": "Video output · reference rate", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" } ] }, { "dimensions": { "conditions": "resolution: 480p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "conditions": "resolution: 768p", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "minimax/hailuo-3-max", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Output video second reference rate", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per output second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_second" }, { "amount": "0.1", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_480p", "label": "Video price", "native_amount_usd_per_unit": "0.1", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.16", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_768p", "label": "Video price", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.5", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.5", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "minimax/hailuo-3-max", "request_model_id": "minimax/hailuo-3-max", "route_label": "Ultra" } ], "name": "MiniMax: H3 Max", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 0.5, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 0.5, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "input_materials_additive": true, "resolution": "480P" }, "label": "Ultra", "units": [ { "amount": "0.10", "amount_unit": "usd_per_output_video_second", "conditions": { "input_materials_additive": true, "resolution": "480P" }, "key": "base", "label": "base", "profile_index": 0, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "input_materials_additive": true, "resolution": "768P" }, "label": "Ultra", "units": [ { "amount": "0.16", "amount_unit": "usd_per_output_video_second", "conditions": { "input_materials_additive": true, "resolution": "768P" }, "key": "base", "label": "base", "profile_index": 1, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "output_resolution": "480P" }, "label": "Ultra", "units": [ { "amount": "0.1106", "amount_unit": "usd_per_input_video_second", "conditions": { "adds_to_output": true, "output_resolution": "480P" }, "key": "input_video", "label": "input video", "profile_index": 2, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "output_resolution": "768P" }, "label": "Ultra", "units": [ { "amount": "0.286", "amount_unit": "usd_per_input_video_second", "conditions": { "adds_to_output": true, "output_resolution": "768P" }, "key": "input_video", "label": "input video", "profile_index": 3, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "first_free_reference_images": 2, "only_additional_images_charged": true, "reference_audio_free": true }, "label": "Ultra", "units": [ { "amount": "0.148", "amount_unit": "usd_per_input_image", "conditions": { "adds_to_output": true, "first_free_reference_images": 2, "only_additional_images_charged": true, "reference_audio_free": true }, "key": "input_image", "label": "input image", "profile_index": 4, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_image" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "basis": "output second Source-only tariff component.", "billing_original_currency": "USD", "billing_original_rate": "0.16", "key": "duration_seconds", "label": "output second", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "0.10", "amount_unit": "usd_per_exact_physical_unit", "basis": "resolution=480p", "billing_original_currency": "USD", "billing_original_rate": "0.10", "key": "duration_seconds_480p", "label": "output second", "native_amount_usd_per_unit": "0.10", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "0.16", "amount_unit": "usd_per_exact_physical_unit", "basis": "resolution=768p", "billing_original_currency": "USD", "billing_original_rate": "0.16", "key": "duration_seconds_768p", "label": "output second", "native_amount_usd_per_unit": "0.16", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" } ] } ], "public_id": "minimax/hailuo-3-max", "short": "MiniMax H3 Max — үйлескен дыбысы бар қысқа бейнеге арналған, кейінгі оқытудан өткен жылдам H3 нұсқасы. MiniMax құжатталған ағыны мәтінді, кадр суреттерін және мультимодальды референстерді қолдайды; 480P не 768P нәтиже, 5–15 секунд ұзақтық және өзіндік промпт кеңейту таңдаулары бар." }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "MiniMax H3 Max — үйлескен дыбысы бар қысқа бейнеге арналған, кейінгі оқытудан өткен жылдам H3 нұсқасы. MiniMax құжатталған ағыны мәтінді, кадр суреттерін және мультимодальды референстерді қолдайды; 480P не 768P нәтиже, 5–15 секунд ұзақтық және өзіндік промпт кеңейту таңдаулары бар.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "7b1a0c8599a4905fffa3d25d7028c205d66c604c0f7fa5fcae45ba7cb6947a5e", "renderer_sha256": "def3bb6e69c8ddb72f88ec6540bbe55d0e503790f964d84073ecda781b13bedf" }, "sourceRevision": "9e8a950a1fbc4d67f6bbc860fa59695376f1c17302f4c6956907ec2db386820d" }