MiniMax-Hailuo-2.3
MiniMax Hailuo 2.3 мәтіннен немесе бастапқы суреттен қозғалыс пен камера бағытын басқару арқылы бейне жасайды. Тексеруге және өңдеуге болатын кейіпкер орындауы, стильденген көрініс пен өнім планы үшін 768P не 1080P-де алты секундты немесе 768P-де он секундты таңдаңыз.
- Ailoot · Бейне
POST /v1/videos/generationsMiniMax-Hailuo-2.3 - Ailoot Ultra · Бейне
POST /v1/videosMiniMax-Hailuo-2.3
Модель туралы
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
MiniMax Hailuo 2.3 — мәтіннен және суреттен бейне режимдері бар генерация моделі. Ол Hailuo 02 негізінде жасалып, физикалық әрекетке, көрнекі стильге, кейіпкер микроэмоцияларына және қозғалыс нұсқауына жауап беруге шоғырланады. Планды нөлден жасауға жазбаша көрініс беріңіз немесе алғашқы көріністі бекіту үшін бастапқы сурет қолданып, одан кейінгі қозғалысты сипаттаңыз.
Физикалық орындау — осы нұсқаның негізгі жақсару бағыттарының бірі. Hailuo 2.3 дене қозғалысын, соның ішінде камера қозғалатын көріністерде, жатық әрі басқарылатын етуге ұмтылады. Әшекей бөлшектерді қоспас бұрын маңызды әрекетті жоспарлаңыз. Кейіпкердің зат көтеруі, басқа адамға бұрылуы немесе бөлмеде жүруі планға бағаланатын көрінетін оқиға береді. Оқиғаны жеткізетін қозғалысты анықтап, айнала нұсқауларды сонымен үйлесімді ұстаңыз.
Стильдендіру — тағы бір бағыт. Модель аниме мен иллюстрацияны, сондай-ақ тушь кескіндемесі және ойын CG сияқты стильдерді қолдайды. Қажетті көрнекі өңдеуді сипаттап, келбетті көрініспен үйлестіріңіз. Бастапқы сурет сурет салу стилін белгілесе, кейіпкер дизайнына қайшы сипаттама енгізбей, мәтінді анимацияға бағыттаңыз. Қозғалыс кезінде осы өңдеу түсінікті қалатынын бүкіл ролик бойымен тексеріңіз.
Модель бет орындауына және нәзік эмоция өзгерістеріне де шоғырланады. Кейіпкер планын маңызды реакцияға құрыңыз: затты байқау, қызығу немесе аздап жымиып жауап беру. Жақын көрініс өзгерісті бағалауды жеңілдетуі мүмкін, ал үлкен ым тізбегі одан алаңдатуы ықтимал. Бір өкілдік суретпен шектелмей, бетті реакцияға дейін, кезінде және кейін тексеріңіз.
Зат қозғалысы өнімге бағытталған көріністерге пайдалы. Авторлық тапсырма жылы жанама жарықта айналатын шағын керамика вазасын және оған біртіндеп жақындайтын камераны көрсете алады. Сұлба, жиегі және бет өңдеуі сияқты танылатын күйде қалуы тиіс қасиеттерді атаңыз. Осы бөлшектерді қозғалыс бойымен тексеріңіз, өйткені сенімді атмосфераның өзі өнім көрінісінің дәлдігін растамайды.
Мәтіннен бейне үшін міндетті сипаттама 2,000 таңбаға дейін болады. Нысанды, әрекетті, ортаны және көрнекі стильді қисынды ретпен беріңіз. Суреттен бейне үшін алғашқы кадр суреті міндетті, ал 2,000 таңбаға дейін сипаттама қосымша. Сурет алғашқы композицияны бекітеді, сондықтан қозғалыс сұрамас бұрын нысан мен кадрлауды дайындаңыз. Қол, зат немесе кейіпкер қозғалатын жерде көрінетін кеңістік қалдырыңыз.
Бастапқы сурет JPG, JPEG, PNG немесе WebP қабылдайды, көлемі 20 MB-тан кіші, қысқа шеті 300 пиксельден үлкен және арақатынасы 2:5 пен 5:2 арасында болуы керек. Оны жалпыға қолжетімді сурет URL-і немесе Base64 data URL арқылы беруге болады. Жасырын бетті немесе алдын ала қиылған әрекетті анимация жөндейді деп сенбей, анық алғашқы сурет таңдаңыз.
Hailuo 2.3 секундына 24 кадрмен жасайды. Алты секундтық план 768P не 1080P, он секундтық план 768P қолданады. Әдепкілері — алты секунд және 768P. Ұзақтықты көргіңіз келетін әрекетке сай таңдаңыз: қысқа реакция шағын планға сыяды, баяу қозғалысқа көбірек уақыт керек. Монтажға орналастырғанда дайын нәтиженің нақты ені мен биіктігін оқыңыз, өйткені ажыратымдылық атауы кадрлау шешімінің бәрін қамтымайды.
Камера бағыты жақша ішіндегі командаларды қолдана алады. Қолжетімді басқарулар жанама ілесуді, панорамалауды, жақындауды, камераны тік жылжытуды, еңкейтуді, масштабтауды, шайқауды, қадағалауды және статикалық планды қамтиды. [Push in] сияқты команда жақындауды бағыттайды; бір жақшада топталған командалар бірге әрекет етеді, ретімен қойылғандар тізбекті сипаттайды. MiniMax бір мезетте ең көбі үш команда ұсынады. Негізгі оқиғаға ілесу жеңіл болуы үшін камера қозғалысын нысан әрекетімен үйлестіріңіз.
Автоматты промпт оңтайлауы әдепкіде қосулы, берілген мәтінді дәлірек басқару үшін өшіруге болады. Қосымша жылдам алдын ала өңдеу оңтайлау қосулы кезде оның уақытын азайтады; бұл Hailuo 2.3 Fast моделін таңдаудан бөлек параметр. Стандартты Hailuo 2.3 екі жасау режимін де қолдайды, ал Fast — бөлек суреттен бейне нұсқасы. Нұсқаны жобаның тек мәтіннен немесе бар кадрдан басталуына қарап таңдаңыз.
Генерация ағыны асинхронды тапсырма идентификаторын қайтарады, кейін дайындық, кезек, өңдеу, сәттілік не сәтсіздік күйін хабарлайды. Сәтті аяқталғанда нәтиже файл идентификаторын және нақты бейне өлшемдерін береді, дайын бейне жүктеуге алынады. Жүктеу мекенжайы жарамды кезде роликті сақтаңыз. Өндірушінің қазіргі бейне жүктеу анықтамасы қайтарылған URL-ге бір сағат өмір береді. Монтаждалатын тізбек үшін әр планды промптымен және бастапқы суретімен сақтаңыз, сонда түзету кезінде таңдалған шығармашылық бағыт қадағаланады.
Сақталған роликте әрекетті, физикалық сабақтастықты, бет не өнім бөлшектерін, көрнекі стильді және камера мінезін тексеріңіз. Бүкіл планды көріп, басқа материалмен қосылатын басы мен соңын қараңыз. Сұрауда бәсекелес қозғалыс тым көп болса, негізгі әрекетті оңайлатыңыз; алғашқы дизайн анық болмаса, бастапқы суретті жақсартыңыз. Қажетті оқиғаны жеткізетін планды таңдап, кейін монтаж ағынында баяндау, титр және ауысулар қосыңыз.
Ailoot · Бейне POST /v1/videos/generations MiniMax-Hailuo-2.3
MiniMax-Hailuo-2.3Бастау
MiniMax Hailuo 2.3 мәтіннен немесе бастапқы суреттен қозғалыс пен камера бағытын басқару арқылы бейне жасайды. Тексеруге және өңдеуге болатын кейіпкер орындауы, стильденген көрініс пен өнім планы үшін 768P не 1080P-де алты секундты немесе 768P-де он секундты таңдаңыз.
- Қабылданатын кіріс деректері
- Мәтін · Суреттер
- Нәтижелер
- Бейне
Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер
Ailoot · Бейне POST /v1/videos/generations
- Кіріс
text,image- Шығыс
video- Шығыс пішімі
- mp4
| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер MiniMax-Hailuo-2.3 | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті | Мәндер мен шектеулер Ең аз ұзындық: 1 Ең үлкен ұзындық: 2 000 Бірлік: Unicode таңбалары | Әдепкі— |
Өрісduration | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер 6, 10 Шарттар: 10 секунд үшін 768P қажет Бірлік: секунд | Әдепкі6 |
Өрісresolution | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 768P, 1080P Шарттар: 1080P үшін 6 секунд қажет | Әдепкі768P |
Өрісfirst_frame_image | Түріhttps_url|data_image_url | ТалапМіндетті емес | Мәндер мен шектеулер Декодталған байттардың ең көп саны: 20 971 520 MIME түрлері: image/jpeg, image/png, image/webp Ең кіші өлшем (шегі кірмейді): 300 Кадр қатынастарының ауқымы: 2:5, 5:2 | Әдепкі— |
Өрісprompt_optimizer | Түріboolean | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— |
Өрісfast_pretreatment | Түріboolean | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— |
Кіріс материалдарының үйлесімдері
Суреттен бейне жасау · Міндетті: prompt, first_frame_image
Мәтіннен бейне жасау · Міндетті: prompt
Әдіс параметрлері мен өмірлік циклі
| Параметр | Параметр талаптары |
|---|---|
Параметрmaterial_types | Параметр талаптарыtext, image |
Параметрrequired | Параметр талаптарыnull |
Параметрoptional_controls | Параметр талаптарыnull |
Өмірлік цикл: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Әдіс құрылымдары мен ID мәндері дәл берілген; жеткізушінің мүмкіндігі сұрауды қабылдаудан бөлек қаралады.
Тарифтер
Ailoot әдістерінің мөлшерлемелері
POST /v1/videos/generations- Шығыс
- 0,28 $ 768p ажыратымдылығындағы 6 s бейне үшін
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
Анықтамалық тариф мәліметтері
Модельдің анықтамалық кестелері әдіс таңдауын, баға есебін не төлемді өзгертпейді. Қолданыстағы төлемдер таңдалған Ailoot әдісінің мөлшерлемелерімен есептеледі.
MiniMax-Hailuo-2.3
Баптаулар бойынша бағалар
| Баптау | Төлемді есептеу шарттары | Төлем |
|---|---|---|
| БаптауMiniMax-Hailuo-2.3 · Әдепкі конфигурация | Төлемді есептеу шарттарыӘдепкі баптау | Төлем Кіріс · Кіріс 0,00 $ әр шақыру үшін Шығыс · Шығыс 0,60 $ әр шақыру үшін |
MiniMax-Hailuo-2.3
Баптаулар бойынша бағалар
| Баптау | Төлемді есептеу шарттары | Төлем |
|---|---|---|
| БаптауMiniMax-Hailuo-2.3 · Әдепкі конфигурация | Төлемді есептеу шарттарыӘдепкі баптау | Төлем Кіріс · Кіріс 0,00 $ әр шақыру үшін Шығыс · Шығыс 1,20 $ әр шақыру үшін |
MiniMax-Hailuo-2.3
Баптаулар бойынша бағалар
| Баптау | Төлемді есептеу шарттары | Төлем |
|---|---|---|
| БаптауMiniMax-Hailuo-2.3 · Әдепкі баптау | Төлемді есептеу шарттарыӘдепкі баптау | Төлем Кіріс · Кіріс 0,00 $ әр шақыру үшін Шығыс · Шығыс 1,20 $ әр шақыру үшін |
Сұрау мысалдары
Ailoot · Бейне
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl https://api.ailoot.ai/v1/videos/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "MiniMax-Hailuo-2.3", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side.", "duration": 6, "resolution": "768P"}'Нәтижелерді алу және сақтау
Ailoot · Бейне
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Тапсырма күйін тексеру
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id" \
-H "Authorization: Bearer $AILOOT_API_KEY"Басқа мазмұнды оқу
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \
-H "Authorization: Bearer $AILOOT_API_KEY" \
--output video.mp4Барлық дайын нәтижені сақтау
Әр дайын бейнені немесе қайтарылған файлды сақтаңыз; нақты қайтарылған әр материал URL арқылы мазмұнды алыңыз.
Қайтарылған әрбір дерек элементін және шығыс индексін сақтаңыз. content_url тек бірінші нәтижеге арналған; әрбір нақты мазмұн жолы немесе ресурс бойынша файлды алыңыз. Индекссіз мазмұн GET сұрауы барлық шығыс нәтижесін бермейді.
Бастапқы жауапты тексеру қажет болса
Бар бастапқы тапсырманы оқыңыз; жіберу нәтижесі белгісіз сұрауды ешқашан қайталап жібермеңіз.
Жауап өрістері
| Өріс | Түрі |
|---|---|
Өрісid | Түріstring |
Өрісobject | Түріstring |
Өрісmodel | Түріstring |
Өрісstatus | Түріstring |
Өрісcontent_url | Түріsigned URL |
Өрісdata[] | Түріsigned URL |
Өрісusage | Түріobject |
Өрісresult_pending_check | Түріboolean |
Қателер және келесі қадамдар
| Жауап | Шарт | Келесі қадам |
|---|---|---|
Жауап400 · invalid_request_error | ШартМіндетті өрістер, материалды ұсыну тәсілі немесе параметр мәні қате | Келесі қадамЖаңадан жасау сұрауын жібермес бұрын көрсетілген өрістерді түзетіңіз. |
Жауап409 · video_not_ready | ШартБастапқы нәтиженің мазмұны әзірге қолжетімді емес | Келесі қадамБастапқы қайтарылған ID бойынша күйді мезгіл-мезгіл сұрап, Retry-After талабын сақтаңыз. |
Жауапserver_error | ШартҚайтарылған жауапта операцияны немесе нәтижені тексеру қажет екені көрсетілген | Келесі қадамБастапқыда қайтарылған операцияның/тапсырманың ID мәнін, сұрау тақырыптарын және жауабын сақтаңыз; сол бастапқы операцияны қолдау көрсетілетін тәсілдермен оқуды жалғастырыңыз. Жасау сұрауын қайта жібермеңіз. |
Балама атаулар
Модельдердің балама атаулары
Ailoot MiniMax-Hailuo-2.3
Ailoot Ultra MiniMax-Hailuo-2.3
Әдіс жолдарының балама атаулары
/v1/videos/generations, /videos, /videos/generations
Шақыруға арналған байланысты ID
Ailoot Ultra · Бейне POST /v1/videos MiniMax-Hailuo-2.3
MiniMax-Hailuo-2.3Бастау
MiniMax Hailuo 2.3 мәтіннен немесе бастапқы суреттен қозғалыс пен камера бағытын басқару арқылы бейне жасайды. Тексеруге және өңдеуге болатын кейіпкер орындауы, стильденген көрініс пен өнім планы үшін 768P не 1080P-де алты секундты немесе 768P-де он секундты таңдаңыз.
- Қабылданатын кіріс деректері
- Мәтін
- Нәтижелер
- Бейне
Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер
Ailoot Ultra · Бейне POST /v1/videos
- Кіріс
text- Шығыс
video- Шығыс пішімі
- mp4
- Нәтижелер саны
- Ең көбі 1 шығыс
| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер MiniMax-Hailuo-2.3 | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті | Мәндер мен шектеулер Ең аз ұзындық: 1 Ең үлкен ұзындық: 2 000 Шарттар: 768P үшін: ең көбі 2000 Unicode код нүктесі. 1080P үшін: 200-ден аз Unicode код нүктесі (ең көбі 199). Промптта бос орындардан өзге мәтін болуы керек. Бірлік: Unicode таңбалары | Әдепкі— |
Өрісduration | Түріinteger | ТалапМіндетті | Мәндер мен шектеулер 6 Бірлік: секунд | Әдепкі— |
Өрісresolution | Түріstring | ТалапМіндетті | Мәндер мен шектеулер 768P, 1080P | Әдепкі— |
Кіріс материалдарының үйлесімдері
Мәтіннен бейне жасау · Міндетті: prompt
Әдіс параметрлері мен өмірлік циклі
| Параметр | Параметр талаптары |
|---|---|
Параметрcontent_type | Параметр талаптарыapplication/json |
Параметрrequired | Параметр талаптарыmodel, prompt, duration, resolution |
Параметрother_options | Параметр талаптарыfalse |
Параметрduration | Параметр талаптары6 |
Параметрresolution | Параметр талаптары768P, 1080P |
Параметрprompt_max_characters | Параметр талаптары2000 |
Параметрmaterial_types | Параметр талаптарыtext |
Параметрprompt_max_characters_by_resolution | Параметр талаптары{"768P":2000,"1080P":199} |
Әдістің балама атаулары: /v1/videos/generations, /videos, /videos/generations
Өмірлік цикл: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Бір рет жасап, қайтарылған ID мәнін сақтаңыз.
Бастапқы күйді мезгіл-мезгіл сұраңыз; әрбір аяқталған ресурсты және оның ұзақтығын сақтаңыз.
Тарифтер
Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.
- Жылдам режим
- Көрсетілмеген Жылдам режим таңдалғанда
- Икемді режим
- Көрсетілмеген flex режимі таңдалғанда
- Ой қорытудың ең жоғары деңгейі
- Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда
Ailoot мөлшерлемелері
Баптаулар бойынша бағалар
Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.
| Баптау | Мөлшерлемелер кестесі | Клиптің номиналды ұзақтығы, секунд | Ажыратымдылық | Есептеу бірлігі | Төлем |
|---|---|---|---|---|---|
| БаптауТокендердің базалық тарифтері | Мөлшерлемелер кестесіНегізгі мөлшерлеме | Клиптің номиналды ұзақтығы, секунд— | Ажыратымдылық— | Есептеу бірлігі— | Төлем Кіріс · Кіріс токендері — / 1K токен Шығыс · Шығыс токендері — / 1K токен Кіріс · Кэшті оқу — / 1K токен Кіріс · Кэшке жазу — / 1K токен Кіріс · Кэшке жазу, 1 сағ — / 1K токен |
| БаптауUltra | Мөлшерлемелер кестесі— | Клиптің номиналды ұзақтығы, секунд6 | Ажыратымдылық1080P | Есептеу бірлігіноминалды ұзақтығы 6s шығыс клипі үшін | Төлем Шығыс · номиналды 6s шығыс клипі $1.2 номиналды ұзақтығы 6s шығыс клипі үшін |
| БаптауUltra | Мөлшерлемелер кестесі— | Клиптің номиналды ұзақтығы, секунд6 | Ажыратымдылық768P | Есептеу бірлігіноминалды ұзақтығы 6s шығыс клипі үшін | Төлем Шығыс · номиналды 6s шығыс клипі $0.6 номиналды ұзақтығы 6s шығыс клипі үшін |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
Анықтамалық тариф мәліметтері
Модельдің анықтамалық кестелері әдіс таңдауын, баға есебін не төлемді өзгертпейді. Қолданыстағы төлемдер таңдалған Ailoot әдісінің мөлшерлемелерімен есептеледі.
MiniMax-Hailuo-2.3
Баптаулар бойынша бағалар
| Баптау | Төлемді есептеу шарттары | Төлем |
|---|---|---|
| БаптауMiniMax-Hailuo-2.3 · Әдепкі конфигурация | Төлемді есептеу шарттарыӘдепкі баптау | Төлем Кіріс · Кіріс 0,00 $ әр шақыру үшін Шығыс · Шығыс 0,60 $ әр шақыру үшін |
MiniMax-Hailuo-2.3
Баптаулар бойынша бағалар
| Баптау | Төлемді есептеу шарттары | Төлем |
|---|---|---|
| БаптауMiniMax-Hailuo-2.3 · Әдепкі конфигурация | Төлемді есептеу шарттарыӘдепкі баптау | Төлем Кіріс · Кіріс 0,00 $ әр шақыру үшін Шығыс · Шығыс 1,20 $ әр шақыру үшін |
MiniMax-Hailuo-2.3
Баптаулар бойынша бағалар
| Баптау | Төлемді есептеу шарттары | Төлем |
|---|---|---|
| БаптауMiniMax-Hailuo-2.3 · Әдепкі баптау | Төлемді есептеу шарттарыӘдепкі баптау | Төлем Кіріс · Кіріс 0,00 $ әр шақыру үшін Шығыс · Шығыс 1,20 $ әр шақыру үшін |
Сұрау мысалдары
Ailoot Ultra · Бейне
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "MiniMax-Hailuo-2.3", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "768P"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
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
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "MiniMax-Hailuo-2.3", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "1080P"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
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
Нәтижелерді алу және сақтау
Ailoot Ultra · Бейне
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Тапсырма күйін тексеру
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o status.json
python3 - <<'PY_STATUS'
import json
from pathlib import Path
r=json.loads(Path("status.json").read_text())
print(json.dumps(r))
if r.get("status")=="completed":
for x in r.get("data",[]):print(x)
PY_STATUS
Барлық дайын материалды сақтау
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")
urls=[]
for x in r["data"]:
if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
u=urljoin("https://api.ailoot.ai",x)
z=urlsplit(u)
if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")
urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
index=$((index + 1))
done < asset-urls.txt
Басқа мазмұнды оқу
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id/content" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4
Барлық дайын нәтижені сақтау
Әр дайын бейнені немесе қайтарылған файлды сақтаңыз; нақты қайтарылған әр материал URL арқылы мазмұнды алыңыз.
Аяқталған data[] ішінде иелігіңіздегі мазмұнның қолтаңбасы бар барлық URL мекенжайы болады. Қайтарылған әрбір URL бойынша файлды алыңыз немесе index өрісіне нақты шығыс индексін қойып, мазмұн эндпоинтын пайдаланыңыз. Сәтсіз аяқталған бастапқы тапсырма charge_pending_check мәнін қайтаруы мүмкін; оны қайта жасаудың орнына сол бастапқы тапсырманы тексеріңіз.
Бастапқы жауапты тексеру қажет болса
Бар бастапқы тапсырманы оқыңыз; жіберу нәтижесі белгісіз сұрауды ешқашан қайталап жібермеңіз.
Нәтижелердің ең көп саны: 1.
Жауап өрістері
| Өріс | Түрі |
|---|---|
Өрісid | Түріstring |
Өрісobject | Түріstring |
Өрісmodel | Түріstring |
Өрісstatus | Түріstring |
Өрісdata[] | Түріsigned content URL |
Өрісcharge_pending_check | Түріboolean |
Өрісerror.code | Түріstring |
Өрісerror.message | Түріstring |
Өрісrequested_nominal_duration_seconds | Түріinteger |
Өрісmeasured_duration_seconds | Түріnumber |
Өрісwidth | Түріinteger |
Өрісheight | Түріinteger |
Қателер және келесі қадамдар
| Жауап | Шарт | Келесі қадам |
|---|---|---|
Жауап400 · invalid_request_error | ШартМіндетті өрістер, материалды ұсыну тәсілі немесе параметр мәні қате | Келесі қадамЖаңадан жасау сұрауын жібермес бұрын көрсетілген өрістерді түзетіңіз. |
Жауап409 · video_not_ready | ШартБастапқы нәтиженің мазмұны әзірге қолжетімді емес | Келесі қадамБастапқы қайтарылған ID бойынша күйді мезгіл-мезгіл сұрап, Retry-After талабын сақтаңыз. |
Жауапserver_error | ШартҚайтарылған жауапта операцияны немесе нәтижені тексеру қажет екені көрсетілген | Келесі қадамБастапқыда қайтарылған операцияның/тапсырманың ID мәнін, сұрау тақырыптарын және жауабын сақтаңыз; сол бастапқы операцияны қолдау көрсетілетін тәсілдермен оқуды жалғастырыңыз. Жасау сұрауын қайта жібермеңіз. |
Балама атаулар
Модельдердің балама атаулары
Ailoot MiniMax-Hailuo-2.3
Ailoot Ultra MiniMax-Hailuo-2.3
Әдіс жолдарының балама атаулары
/v1/videos/generations, /videos, /videos/generations
Шақыруға арналған байланысты ID
FAQ · MiniMax-Hailuo-2.3
- Қандай кіріс деректері мен нәтижелер қолжетімді?
POST /v1/videos/generations·MiniMax-Hailuo-2.3:text,image→videoPOST /v1/videos·MiniMax-Hailuo-2.3:text→video- Сұрау қандай өрістерді пайдаланады?
POST /v1/videos/generations·MiniMax-Hailuo-2.3:model,prompt,duration,resolution,first_frame_image,prompt_optimizer,fast_pretreatmentPOST /v1/videos·MiniMax-Hailuo-2.3:model,prompt,duration,resolution- Қандай шектеулер қолданылады?
POST /v1/videos/generations·MiniMax-Hailuo-2.3:prompt.maximum_length:2000POST /v1/videos·MiniMax-Hailuo-2.3:prompt.maximum_length:2000