MiniMax: H3
MiniMax H3 мәтіннен, кадр суреттерінен немесе мультимодальды референстерден бейнемен бірге тікелей жасалатын стерео дыбысы бар қысқа бейне жасайды. Ол алғашқы/соңғы кадрмен жасауды, референспен басқарылатын өңдеуді және қозғалыс не дауыс байланыстарын қолдайды; нәтиже ұзақтығы 4–15 секунд, бөлек 2K қайта генерация ағыны бар.
Модель туралы
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
Мультимодальды тапсырмадан бір аудиовизуалдық нәтиже
MiniMax H3 — MiniMax әмбебап модальды бейне жүйесі. Ол мәтінді, суреттерді, бейне мен дыбысты бірге түсініп, бейнемен бірге тікелей жасалатын стерео дыбысы бар бейне жасайды. Өндіруші оны өнім көрінісі, жарнама, анимациялық постер және фильм титрі тұжырымдамасы сияқты қысқа шығармашылық жұмысқа ұсынады; мұнда референс ресурстар арасындағы байланыстар көрініс сипаттамасындай маңызды.
Құжатталған жүйе секундына 24 кадр және 32 kHz стерео дыбыспен 4–15 секунд бейне жасайды. H3-Base генерациясы 768p-де жүреді; толық 2K ағыны сол нәтижені бастапқы мультимодальды контекстпен қайта жасайды. Бұл кәдімгі өлшем үлкейтуден артық: екінші кезең ұсақ бөлшекті қалпына келтіру үшін модель мен бастапқы контексті қайта қолданады. H3 Max пен H3-Context-IR рөлдері мен шектері бөлек.
Мәтіндік және кадрмен бағытталған жасау
Тек мәтіндік кіріс толық аудиовизуалдық уақыт желісін сипаттайды. Бірінші сурет бастауды, соңғы сурет аяқталуды бекітеді, ал екі сурет екеуін де анықтай алады. Алғашқы кадр планы үшін суреттегі көрінетін композиция мен тұлғадан бастап, одан өрбитін әрекетті сипаттаңыз. Алғашқыдан соңғы кадрға ауысуда қатысы жоқ екі сурет сипаттамасын қайталамай, екі күйді жалғайтын көрінетін қозғалысты сипаттаңыз.
Практикалық өнім тапсырмасы алғашқы кадрдағы жабық қаптаманы, оны ашатын қолды, камераның жұмсақ қозғалысын және жететін соңғы күйді белгілей алады. Берілген кадрларда зат пішінін, жапсырма орнын және жарықты сақтаңыз. Кадрмен жасау және референспен жасау — бөлек кіріс режимдері; өндіруші интерфейсі бір сұрауда алғашқы/соңғы кадр рөлдерін референс медиа рөлдерімен араластырмайды.
Референспен басқарылатын генерация және өңдеу
Референс режимі мәтінді суреттермен, бейне және дыбыс клиптерімен қабылдайды. Әр көздің үлесін атаңыз: кейіпкер келбеті, орын, камера қозғалысы, бастапқы роликтің уақыт құрылымы немесе дауыс. Тек камера қозғалысына қолданылған бейне нақты өңделуі не жалғасуы қажет бейнеден бөлек. Бұл байланысты анық айтыңыз.
Өндірушінің референс нұсқаулығы нысан анықтамаларын, тапсырма түйінін, сақталатын бөліктер талдауын, егжей-тегжейлі план сипаттамасын, жалпы дыбыс ортасын және тек көрерменге арналған фон музыкасын бөледі. Ол көрінетін мазмұнды сақтауды атрибут көшіруден немесе кең стиль референсінен ажыратады. Дыбыста сигналды көшіру тембрге, ырғаққа немесе орындауға сүйенуден өзгеше. Осы рөлдерді бүкіл тапсырма бойымен тұрақты сақтаңыз.
Референске сүйенген көрініске кейіпкер суретін, қысқа камера қозғалысы референсін және дауыс дыбыс референсін беріп, әрқайсысының мақсатты планға қайда әсер ететінін сипаттаңыз. Қай киім, орта не зат бөлшектері танылатын күйде қалатынын айтыңыз. Дайын роликті осы талаптармен, соның ішінде қозғалыс сабақтастығымен және көрінетін сөйлеуші мен естілетін дауыс байланысымен салыстырыңыз.
Сөйлеу, дыбыс және план уақыты
H3 диалогты, физикалық дыбысты, орта үнін және музыканы бірге модельдейді. Модель карточкасы араб, қытай, ағылшын, француз, неміс, итальян, жапон, корей, португал, орыс және испан тілдеріндегі тұрақты диалог қолдауын құжаттайды; басқа тілдердің қолдауы әртүрлі деп сипатталған. Нақты айтылатын сөздер мен тілді беріп, сөйлеуші тұлғасын пландар арасында тұрақты ұстаңыз.
Өндірушінің промпт жазу нұсқаулықтары сипаттама бөлімдерінде ағылшын тілін қолданып, диалог пен көрінетін мәтінді бастапқы тілінде сақтайды. Сөйлеу мазмұны <d>[Language] ...</d> пішімін пайдаланады, сөйлеуші тұлғасы мен дауыс сипаттамасы блоктан тыс беріледі. Физикалық сөйлеуді кадр сыртындағы дауыстан ажыратып, сөйлем монтаждық ауысудан өтіп жалғасатынын не соңында үзіліп қалатынын атаңыз. Көрінетін мәтінді де дәл сақтаңыз. Сөйлеу мөлшерін таңдалған ұзақтыққа сыйдырып, рендерленген сөздер мен естілетін сөйлемді бірге тексеріңіз.
Камера қозғалысын әрекет ретінде, маңызды болса ауқымы мен жылдамдығын қоса сипаттаңыз. Пландарды ойнату ретімен нөмірлеп, ауысу уақыттарын бейне ұзақтығы ішінде ұстаңыз. Аяқ дыбысы немесе есік жабылуы сияқты көрініс дыбыстарын тек көрермен еститін фон музыкасынан ажыратыңыз. Бұл таңдаулар қысқа план жоспарын түсінуді және нәтижемен салыстырып тексеруді жеңілдетеді.
Кірісті дайындау және сандық шектер
Қазіргі генерация схемасы әр режимде бос емес мәтінді, әр мәтін элементіне 7,000 таңбаға дейін талап етеді. Суреттер 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 секундтан аспайды. Модель карточкасы аралас референс кірістерін 12 файлмен шектейді. Құжатталған сұрау денесінің шегі — 64 MB, ол жеке файл шектерінен бөлек.
Тапсырмаға үлес қосатын референстерді ғана таңдап, әр үлесті анық көрсетіңіз. Нысанның анық көрінісі түсіндірмесіз бірнеше қайшы көріністен пайдалырақ. Референс ретін сақтаңыз, көріністің қажет контекстін алмай, қатысы жоқ материалды қиыңыз және қысқа бастапқы роликте сұралған әрекет не дауыс сипаты барын тексеріңіз.
Шығыс пішімі және толық жүйе
Өндірушінің H3 интерфейсі 768P және 2K ұсынады. Тек мәтіндік генерация нақты арақатынасты талап етеді: 21:9, 16:9, 4:3, 1:1, 3:4 немесе 9:16. Алғашқы/соңғы кадрмен жасау арақатынасын кіріс суреттен алады; референспен жасау бейімделмелі не нақты арақатынасты қолдана алады. Бүтін секундпен берілетін шығыс ұзақтығы — 4–15 секунд.
Модель карточкасы тапсырманы түсініп, толықтыратын H3-Context-IR, аудиовизуалдық мазмұн жасайтын H3-Base және жоғары ажыратымдылықты нәтиже жасайтын H3-Regenerate-2K бөліктерін ажыратады. Жарияланған базалық checkpoint-тер кадрмен және әмбебап референспен бағытталған міндеттерді бөледі. Контекст пен қайта генерация компоненттері сол базалық салмақтардан бөлек, сондықтан ашық checkpoint атауының өзі бүкіл жүйе әрекетін дәлелдемейді.
Өндірушінің генерация ағыны асинхронды. Тапсырма сұрау интерфейсі алдыңғы жеті күндегі тапсырмаларды алады. Нақты бейне нәтижесі қайтқанша тапсырма идентификаторын сақтап, кейін уақытпен шектелген жүктеу мекенжайымен ғана шектелмей, роликті сақтаңыз. Жоспарланған көру өлшемінде көрнекі тұлғаны, ұсақ мәтінді, зат әрекеттесуін, айтылатын мазмұнды және дыбыс уақытын тексеріңіз. Өндіруші мультимодальды түсіну мен ұсақ көрнекі бөлшектерді әлі жетілдірілетін бағыттар деп атайды; егжей-тегжейлі тапсырма мен бастапқы материалды салыстыру пайдалы нәтиженің өзегі болып қалады.
Ailoot Ultra · Бейне POST /v1/videos minimax/hailuo-3
minimax/hailuo-3Бастау
MiniMax H3 мәтіннен, кадр суреттерінен немесе мультимодальды референстерден бейнемен бірге тікелей жасалатын стерео дыбысы бар қысқа бейне жасайды. Ол алғашқы/соңғы кадрмен жасауды, референспен басқарылатын өңдеуді және қозғалыс не дауыс байланыстарын қолдайды; нәтиже ұзақтығы 4–15 секунд, бөлек 2K қайта генерация ағыны бар.
- Қабылданатын кіріс деректері
- Мәтін · Суреттер · Аудио · Бейне
- Нәтижелер
- Бейне
Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер
Ailoot Ultra · Бейне POST /v1/videos
- Кіріс
text,image,audio,video- Шығыс
video- Шығыс пішімі
- бастапқы MP4 байттары; қалыпқа келтірусіз/қайта кодтаусыз
| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер minimax/hailuo-3 | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті | Мәндер мен шектеулер | Әдепкі— |
Өрісduration | Түріinteger | ТалапМіндетті | Мәндер мен шектеулер 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Ең азы: 1 Ең көбі: 600 | Әдепкі— |
Өрісresolution | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 2K | Әдепкі— |
Өрісaspect_ratio | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Әдепкі— |
Өрісgenerate_audio | Түріboolean | ТалапМіндетті емес | Мәндер мен шектеулер false, true | Әдепкі— |
Өріс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
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
prompt: Түрі: string · UTF-8 байттарының ең көп саны: 10 000 · Бос таңбаға жатпайтын кемінде бір таңба қажет: Иә
Reference to video · Жазбаша промпт және қолдау көрсетілетін сурет, бейне, аудио үлгі материалдары. · Міндетті: model, prompt, duration, input_references
input_references — объектілер массиві. type өрісіне image_url, video_url, audio_url мәндерінің бірін орнатып, ішінде url бар сәйкес өрісті пайдаланыңыз. Жалпыға қолжетімді HTTPS URL мекенжайларын қолданыңыз. Үлгі материалдар режимін таңдау үшін frame_images өрісін қоспаңыз. Болжамды есепке көрсетілген сурет басына алынатын құрамдас төлем алғашқы бесеуінен кейінгі үлгі суреттер үшін ғана кіреді. Түпкілікті төлем нақты шотталған конфигурацияға сәйкес есептеледі. Үлгі суреттерді кадр суреттерімен біріктірмеңіз. Қолдау көрсетілетін ажыратымдылықты және қажет болса, жақтар арақатынасын таңдаңыз.
model: Түрі: string · minimax/hailuo-3
prompt: Түрі: string · UTF-8 байттарының ең көп саны: 10 000 · Бос таңбаға жатпайтын кемінде бір таңба қажет: Иә
Әдіс параметрлері мен өмірлік циклі
| Параметр | Параметр талаптары |
|---|---|
Параметрcontent_type | Параметр талаптарыapplication/json |
Параметрrequired | Параметр талаптарыmodel, prompt, duration |
Параметрmaterial_types | Параметр талаптарыtext, image, audio, video |
Параметрadditional_properties | Параметр талаптарыfalse |
Параметрoptional_controls | Параметр талаптарыresolution, aspect_ratio, generate_audio, frame_images, input_references, 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 токен |
| БаптауБейне бағасы | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Есептеу бірлігібейне секунды үшін | Төлемді есептеу шарттарыБұл баға кілтінде қосымша шарт көрсетілмеген. | Төлем Шығыс · Видео бағасы · Тек салыстыруға арналған бағалау $0.26 бейне секунды үшін |
| Баптауреференс кескін | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Есептеу бірлігіүлгі сурет үшін | Төлемді есептеу шарттары— | Төлем Кіріс · референс кескін · Тек салыстыруға арналған бағалау $0.08 үлгі сурет үшін |
| БаптауГенерацияның болжамды құны | Мөлшерлемелер кестесі— | Болжамды мөлшербір генерацияға арналған болжам | Есептеу бірлігі— | Төлемді есептеу шарттары— | Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $1.3 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес. |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
Анықтамалық тариф мәліметтері
Модельдің анықтамалық кестелері әдіс таңдауын, баға есебін не төлемді өзгертпейді. Қолданыстағы төлемдер таңдалған Ailoot әдісінің мөлшерлемелерімен есептеледі.
Бейне конфигурацияларының баға сілтемелері
Баптаулар бойынша бағалар
Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.
| Баптау | Төлемді есептеу шарттары | Төлем |
|---|---|---|
| БаптауБейне бағасы | Төлемді есептеу шарттарыБұл баға кілтінде қосымша шарт көрсетілмеген. | Төлем Шығыс · Видео бағасы $0.26 бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
| БаптауАлғашқы бесеуінен кейінгі үлгі суреттер | Төлемді есептеу шарттарыБұл баға кілтінде қосымша шарт көрсетілмеген. | Төлем Кіріс · Алғашқы бес кескіннен кейінгі референс кескіндер $0.08 сурет үшін Алғашқы бес үлгі сурет тегін; көрсетілген сурет басына тариф алғашқы бесеуінен кейін қолданылады. Көрсетілген конфигурацияның жарияланған баға сілтемесі. Түпкілікті төлемдер нақты шотталған конфигурацияға сәйкес есептеледі. |
Сұрау мысалдары
Ailoot Ultra · Бейне
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"minimax/hailuo-3","prompt":"A serene mountain landscape at sunset","resolution":"2K"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Нәтижелерді алу және сақтау
Ailoot Ultra · Бейне
иелігіңіздегі мазмұнның қолтаңбасы бар URL мекенжайлары
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Тапсырма күйін тексеру
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Басқа мазмұнды оқу
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Барлық дайын нәтижені сақтау
Әр дайын бейнені немесе қайтарылған файлды сақтаңыз; нақты қайтарылған әр материал URL арқылы мазмұнды алыңыз.
Иелігіңіздегі әрбір нақты шығыс нәтижесін және онымен қайтарылған өлшенген метадеректерді сақтаңыз.
Бастапқы жауапты тексеру қажет болса
503 result_pending_check + бастапқы id + X-Should-Retry:false; бастапқы сұрауды ешқашан қайталамаңыз
Жауап өрістері
| Өріс | Түрі | Мағынасы |
|---|---|---|
Өрісindex | Түріinteger | МағынасыОсы бейненің шығыс тізіміндегі нөлден басталатын орны. |
Өрісcontent_url | Түріstring | МағынасыОсы аяқталған бейнені жүктеп алуға арналған қолтаңбасы бар HTTPS URL мекенжайы. |
Өрісsha256 | Түріstring | null | МағынасыБастапқы бейне байттарының SHA-256 хэші; қолжетімсіз болса, null. |
Өрісsize_bytes | Түріinteger | null | МағынасыБастапқы бейне файлының байтпен өлшенетін көлемі; қолжетімсіз болса, null. |
Өрісduration_ms | Түріinteger | null | МағынасыБейненің миллисекундпен өлшенген ұзақтығы; қолжетімсіз болса, null. |
Өрісwidth | Түріinteger | null | МағынасыБейненің пиксельмен өлшенетін ені; қолжетімсіз болса, null. |
Өрісheight | Түріinteger | null | МағынасыБейненің пиксельмен өлшенетін биіктігі; қолжетімсіз болса, null. |
Өрісvideo_codec | Түріstring | null | МағынасыБейне кодегінің идентификаторы; тіркелмесе, null. |
Өрісhas_audio | Түріboolean | null | МағынасыБейнеде аудиожол бар-жоғы; өлшенбесе, null. |
Өрісaudio_codec | Түріstring | null | МағынасыАудио кодегінің идентификаторы; идентификатор тіркелмесе, null. |
Қателер және келесі қадамдар
| Жауап | Шарт | Келесі қадам |
|---|---|---|
Жауап404 · not_found_error | ШартБейнеге қол жеткізу мүмкін емес немесе бұл бейне ID мәні табылмады. | Келесі қадамБейнеге қолжетімділікті тексеріңіз. Бар бейне үшін оның бастапқы ашық ID мәнін және сол API кілтін пайдаланыңыз. |
Жауап401 · authentication_error | ШартAPI кілті аутентификациядан өткен есептік жазбаға сәйкес келмейді. | Келесі қадамЖібермес бұрын API кілтіңізді және есептік жазбаға қолжетімділікті тексеріңіз. |
Жауап400 · invalid_request_error | ШартСұрауды оқу мүмкін болмады немесе жүктеп алу индексі жарамсыз. | Келесі қадамСұрау денесін түзетіңіз. Жүктеп алу үшін бастапқы тапсырма қайтарған шығыс индексін таңдаңыз. |
Жауап422 · price_unavailable | ШартТаңдалған бейне конфигурациясының бағасын есептеу мүмкін емес. | Келесі қадамҚолдау көрсетілетін бейне конфигурациясын таңдап, түзетілген сұрауды жібермес бұрын оның міндетті параметрлерін толтырыңыз. |
Жауап422 · invalid_request_error | ШартКіріс бейне немесе бастапқы жалғастыру тапсырмасы жарамсыз. | Келесі қадамЖарамды HTTPS кірістерін пайдаланыңыз. Жалғастыру үшін аяқталған бастапқы бейнеңіздің ашық ID мәнін сол API кілтімен қолданыңыз. |
Жауап402 · billing_error | ШартҚолда бар баланс немесе лимиттер қаражатты резервтеуге мүмкіндік бермейді. | Келесі қадамЖаңа сұрауды жібермес бұрын қолда бар балансты және лимиттерді тексеріңіз. |
Жауап503 · server_error | ШартБейнені тексеру, сақтау немесе қызметке қол жеткізу уақытша қолжетімсіз. | Келесі қадамҚызметтің қолжетімді болуын күтіңіз. Егер сізде бейне ID мәні бар болса, басқа генерация жасаудың орнына сол бастапқы тапсырманы тексеріңіз. |
Жауап503 · result_pending_check | ШартБастапқы бейне нәтижесі мен есептелген төлемді тексеру қажет. | Келесі қадамҚайтарылған бейне ID мәнін сақтап, сол тапсырманы тексеріңіз. Тексеру жүріп жатқанда оның орнына жаңа генерация сұрауын жібермеңіз. |
Жауап503 · owned_result_unavailable | ШартБар бейнені жүктеп алу уақытша қолжетімсіз. | Келесі қадамСол бейне тапсырмасын кейінірек тексеріп, оның бар шығыс нәтижесін жүктеп алыңыз. Жаңа генерация бөлек операция жасайды. |
Жауап409 · video_not_ready | ШартБейне мазмұны жарияланбаған. | Келесі қадамБастапқы тапсырманың күйін тексеріңіз. completed күйін хабарлағаннан кейін жүктеп алыңыз; failed күйін хабарласа, оның төлемді тексеру туралы ескертуін орындаңыз. |
Балама атаулар
Модельдердің балама атаулары
Ailoot Ultra minimax/hailuo-3
Әдіс жолдарының балама атаулары
Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.
Шақыруға арналған байланысты ID
FAQ · MiniMax: H3
- Қандай кіріс деректері мен нәтижелер қолжетімді?
POST /v1/videos·minimax/hailuo-3:text,image,audio,video→video- Сұрау қандай өрістерді пайдаланады?
POST /v1/videos·minimax/hailuo-3:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,callback_url,session_id,trace,user- Қандай шектеулер қолданылады?
POST /v1/videos·minimax/hailuo-3:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1