Hailuo 2.3 Fast
MiniMax Hailuo 2.3 Fast қысқа қозғалыс промпты арқылы алғашқы кадр суретін анимациялайды. Өнім планы, кейіпкер қалпы немесе сториборд суреті үшін осы суреттен бейне профилін таңдаңыз.
Модель туралы
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
MiniMax Hailuo 2.3 Fast — суреттен бейне жасауға арналған Fast профилі. Алдын ала құрастырылған алғашқы кадр суретінен бастап, нысанның не камераның қалай қозғалуы керегін сипаттаңыз. Өнім фотосы, кейіпкер қалпы немесе сториборд кадры планға нақты көрнекі бастапқы нүкте береді.
Сурет пен қозғалыс тапсырмасын дайындаңыз
HTTPS URL арқылы шаршы PNG не JPEG суретін беріңіз; әр жағы 300–4,096 пиксель арасында болсын. Жүктелетін сурет файлы 20,000,000 байттан аспауы керек. Промптты 1–199 таңба аралығында ұстап, бір көрінетін әрекетке және план үшін маңызды қозғалысқа шоғырландырыңыз.
Роликті аяқталғанша қадағалаңыз
Бұл профиль номиналды ұзақтығы алты секунд болатын бір 768 × 768 MP4 роликке бапталған. Сұрауды бір рет жіберіп, қайтарылған ID-ді сақтаңыз және сол бастапқы сұрауды аяқталғанша қадағалаңыз. Қайтарылған бейнені жүктеп, хабарланған өлшемдерін және өлшенген ұзақтығын нәтижемен бірге сақтаңыз. Жасау нәтижесі белгісіз болса, қайта жасамай, бастапқы сұрауды тексеруді жалғастырыңыз.
Ailoot Ultra · Бейне POST /v1/videos MiniMax-Hailuo-2.3-Fast
MiniMax-Hailuo-2.3-FastБастау
MiniMax Hailuo 2.3 Fast қысқа қозғалыс промпты арқылы алғашқы кадр суретін анимациялайды. Өнім планы, кейіпкер қалпы немесе сториборд суреті үшін осы суреттен бейне профилін таңдаңыз.
- Қабылданатын кіріс деректері
- Мәтін · Суреттер
- Нәтижелер
- Бейне
Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер
Ailoot Ultra · Бейне POST /v1/videos
- Кіріс
text,image- Шығыс
video- Шығыс пішімі
- mp4
- Нәтижелер саны
- Ең көбі 1 шығыс
| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер MiniMax-Hailuo-2.3-Fast | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті | Мәндер мен шектеулер Ең аз ұзындық: 1 Ең үлкен ұзындық: 199 Бірлік: Unicode таңбалары | Әдепкі— |
Өрісduration | Түріinteger | ТалапМіндетті | Мәндер мен шектеулер 6 Бірлік: секунд | Әдепкі— |
Өрісresolution | Түріstring | ТалапМіндетті | Мәндер мен шектеулер 768P | Әдепкі— |
Өрісfirst_frame_image | Түріhttps_url | ТалапМіндетті | Мәндер мен шектеулер Файлдың ең үлкен өлшемі, байт: 20 000 000 MIME түрлері: image/png, image/jpeg Ең кіші өлшем: 300 Ең үлкен өлшем: 4 096 Тек шаршы: Иә | Әдепкі— |
Кіріс материалдарының үйлесімдері
Суреттен бейне жасау · Міндетті: prompt, first_frame_image
Әдіс параметрлері мен өмірлік циклі
| Параметр | Параметр талаптары |
|---|---|
Параметрcontent_type | Параметр талаптарыapplication/json |
Параметрrequired | Параметр талаптарыmodel, prompt, duration, resolution, first_frame_image |
Параметрother_options | Параметр талаптарыfalse |
Параметрduration | Параметр талаптары6 |
Параметрresolution | Параметр талаптары768P |
Параметрprompt_max_characters | Параметр талаптары199 |
Параметрfirst_frame_image | Параметр талаптары{"type":"https_url","format":["png","jpeg"],"dimensions":"шаршы, 300..4096 пиксель","full_image_validation_before_send":true,"maximum_file_bytes":20000000} |
Параметрmaterial_types | Параметр талаптарыtext, image |
Параметрadditional_properties | Параметр талаптарыfalse |
Әдістің балама атаулары: /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 | Ажыратымдылық768P | Есептеу бірлігіноминалды ұзақтығы 6s шығыс клипі үшін | Төлем Шығыс · номиналды 6s шығыс клипі $0.4 номиналды ұзақтығы 6s шығыс клипі үшін |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
Анықтамалық тариф мәліметтері
Модельдің анықтамалық кестелері әдіс таңдауын, баға есебін не төлемді өзгертпейді. Қолданыстағы төлемдер таңдалған Ailoot әдісінің мөлшерлемелерімен есептеледі.
MiniMax-Hailuo-2.3-Fast
Баптаулар бойынша бағалар
| Баптау | Төлемді есептеу шарттары | Төлем |
|---|---|---|
| БаптауMiniMax-Hailuo-2.3-Fast · Әдепкі конфигурация | Төлемді есептеу шарттарыӘдепкі баптау | Төлем Кіріс · Кіріс 0,00 $ әр шақыру үшін Шығыс · Шығыс 0,40 $ әр шақыру үшін |
MiniMax-Hailuo-2.3-Fast
Баптаулар бойынша бағалар
| Баптау | Төлемді есептеу шарттары | Төлем |
|---|---|---|
| БаптауMiniMax-Hailuo-2.3-Fast · Әдепкі конфигурация | Төлемді есептеу шарттарыӘдепкі баптау | Төлем Кіріс · Кіріс 0,00 $ әр шақыру үшін Шығыс · Шығыс 0,80 $ әр шақыру үшін |
MiniMax-Hailuo-2.3-Fast
Баптаулар бойынша бағалар
| Баптау | Төлемді есептеу шарттары | Төлем |
|---|---|---|
| БаптауMiniMax-Hailuo-2.3-Fast · Әдепкі баптау | Төлемді есептеу шарттарыӘдепкі баптау | Төлем Кіріс · Кіріс 0,00 $ әр шақыру үшін Шығыс · Шығыс 0,80 $ әр шақыру үшін |
Сұрау мысалдары
Ailoot Ultra · Бейне
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_IMAGE_URL:?Set the actual HTTPS first-frame image URL}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "MiniMax-Hailuo-2.3-Fast", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "768P"}')
from urllib.parse import urlsplit
u=os.environ["AILOOT_IMAGE_URL"]
z=urlsplit(u)
if z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Choose the actual HTTPS first-frame image URL")
p["first_frame_image"]=u
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}"
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 арқылы мазмұнды алыңыз.
Аяқталған 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 | Мағынасы— |
Өрісoperation_id | Түріstring | Мағынасыstatus=unknown кезінде қайтарылады; бастапқы ашық бейне операциясының нақты ID мәні |
Өрісrequest_id | Түріstring | Мағынасыstatus=unknown кезінде міндетті емес; бастапқы тапсырмада сұрау ID мәні болса ғана қайтарылады |
Қателер және келесі қадамдар
| Жауап | Шарт | Келесі қадам |
|---|---|---|
Жауап400 · invalid_request_error | ШартБейне профилін талдауға дейін сұраудың өңделмеген денесін оқу сәтсіз аяқталады | Келесі қадамҚайтарылған жауапты сақтап, оқылмайтын сұрау денесін түзетіңіз. |
Жауап422 · price_unavailable | ШартДәл бейне профилін талдау сәтсіз аяқталады немесе толық талданған профиль үшін дайын нақты баға картасы жоқ | Келесі қадамЖауапты сақтаңыз; пайдалануға рұқсат етілген толық әрі дәл профильді және оның жарияланған баға картасын қолданыңыз. Бұл тармақ жеткізушіге жіберуден бұрын орындалады. |
Жауап409 · video_not_ready | ШартБастапқы нәтиженің мазмұны әзірге қолжетімді емес | Келесі қадамБастапқы қайтарылған ID бойынша күйді мезгіл-мезгіл сұрап, Retry-After талабын сақтаңыз. |
Жауапserver_error | ШартҚайтарылған жауапта операцияны немесе нәтижені тексеру қажет екені көрсетілген | Келесі қадамБастапқыда қайтарылған операцияның/тапсырманың ID мәнін, сұрау тақырыптарын және жауабын сақтаңыз; сол бастапқы операцияны қолдау көрсетілетін тәсілдермен оқуды жалғастырыңыз. Жасау сұрауын қайта жібермеңіз. |
Жауап200 · video_result_unverified | ШартБастапқы Fast тапсырмасының күйі белгісіз; status=unknown және charge_pending_check=true | Келесі қадамНақты қайтарылған id/operation_id мәндерін және міндетті емес request_id мәнін сақтаңыз; тек бастапқы тапсырманы оқыңыз. Ешқашан қайта жібермеңіз. |
Балама атаулар
Модельдердің балама атаулары
Ailoot Ultra MiniMax-Hailuo-2.3-Fast
Әдіс жолдарының балама атаулары
/v1/videos/generations, /videos, /videos/generations
Шақыруға арналған байланысты ID
FAQ · Hailuo 2.3 Fast
- Қандай кіріс деректері мен нәтижелер қолжетімді?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:text,image→video- Сұрау қандай өрістерді пайдаланады?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:model,prompt,duration,resolution,first_frame_image- Қандай шектеулер қолданылады?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:prompt.maximum_length:199