MiniMax: Hailuo 02
Hailuo 02 мәтіннен немесе алғашқы кадр суретінен видео жасайды және құжатталған алғашқы әрі соңғы кадр процесін қолдайды. Камера командалары, нұсқауды оңтайландыру және режимге тән ұзақтық пен ажыратымдылық таңдаулары көзделген кадрды құруға көмектеседі.
Модель туралы
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
Hailuo 02 — MiniMax компаниясының мәтіндік көріністерге, суретке қозғалыс беруге және алғашқы әрі соңғы кадр процесіне арналған видеомоделі. Жазбаша тапсырма нысанды, әрекетті және камераны сипаттайды, ал берілген кадр суреттері көрнекі бастапқы күйді немесе ауысудың соңғы күйін белгілей алады. Генерация режимін қолда бар материалға және кадрдың басқарғыңыз келетін бөлігіне қарай таңдаңыз.
Мәтіннен видео үшін түсінікті ортасы мен қарау нүктесі бар біртұтас әрекетті сипаттаңыз. Мысалы, шағын желкенді қайық айлақ жанынан өтіп, камера оны жағадан қадағалай алады. Не қозғалатынын, қай бөлшектер көрінетін болып қалуы тиіс екенін және кадрдың қалай аяқталатынын көрсетіңіз. Тапсырманы байланыссыз көрнекі қасиеттер тізіміне емес, байқалатын оқиғаларға бағыттаңыз.
Суреттен видео үшін қажетті нысаны мен кадрлауы белгіленген алғашқы кадр дайындаңыз. Өндіруші 20 MB-тан аз, қысқа жағы 300 пиксельден үлкен және арақатынасы 2:5 пен 5:2 арасында болатын JPG, JPEG, PNG және WebP суреттерін қабылдайды. Маңызды пішіндері мен белгілері көрінетін суретті қолданып, содан дамуы тиіс қозғалысты сипаттаңыз.
Hailuo 02 моделінде құжатталған алғашқы және соңғы кадр режимі де бар. Екі суретті бір тізбектің көзделген бастапқы және соңғы күйлері ретінде дайындап, көріністің олардың арасында қалай қозғалатынын сипаттаңыз. Алғашқы кадр кадрлауды анықтайды; өндіруші өлшемі басқа соңғы кадр соған сәйкестендіріліп қиылатынын айтады. Нысан ауысу бойы көрінуі керек болса, суреттер композициясын алдын ала сәйкестендіріңіз.
Нұсқау 2 000 таңбаға дейін қамти алады. Hailuo 02 жақша ішіндегі push, pull, truck, pan, pedestal, tilt, zoom, tracking және статикалық кадр сияқты камера командаларын қолдайды. Бір жақшаға бірге қойылған командалар бір мезгілдегі қозғалысты, ал сипаттаманың әр жеріндегі командалар қозғалыс тізбегін сұрайды. Өндіруші үштен артық қозғалысты біріктірмеуді ұсынады, сондықтан нысанды анық көруге көмектесетін камера әрекетін таңдаңыз.
Ұзақтық пен ажыратымдылық режимге байланысты. Мәтіннен видео үшін 768P өлшемінде алты немесе он секунд және 1080P өлшемінде алты секунд құжатталған. Суреттен видео үшін 512P өлшемінде алты немесе он секунд та құжатталған. Алғашқы және соңғы кадр процесі 768P өлшемінде алты немесе он секундты және 1080P өлшемінде алты секундты құжаттайды. Бір режимнің ажыратымдылық таңдауын барлық басқа режимге көшірмей, кадрға қолдау көрсетілетін үйлесімді таңдаңыз.
Нұсқауды автоматты оңтайландыру — өндіруші процесінде әдепкі қосылған құжатталған басқару параметрі. Нұсқаларды салыстырғанда оның баптауын сақтаңыз, себебі қайта жазылған тапсырма модель алатын мазмұнды өзгертеді. Түзету жақсартуды қажет ететін әрекетке немесе кадрлауға бағытталуы үшін нақты мәтінді, референс кадрларды және таңдалған шығыс баптауларын жасалған клиппен бірге сақтаңыз.
Бүкіл дайын тізбекті тексеріңіз: бастапқы композицияны, нысан сабақтастығын, әрекет уақытын және соңғы кадрды. Ауысуда алғашқы және соңғы кадрларды да, олардың арасындағы қозғалысты да тексеріңіз. Монтаж үшін нақты видеоны нұсқаумен және референстермен бірге сақтаңыз; келесі түзетуді көрінбей қалған бөлшек, күрт камера қозғалысы немесе тым ерте келетін аяқталу сияқты нақты көрнекі мәселеге бағыттаңыз.
Ailoot Ultra · Бейне POST /v1/videos minimaxi-hailuo-02
minimaxi-hailuo-02Бастау
Hailuo 02 мәтіннен немесе алғашқы кадр суретінен видео жасайды және құжатталған алғашқы әрі соңғы кадр процесін қолдайды. Камера командалары, нұсқауды оңтайландыру және режимге тән ұзақтық пен ажыратымдылық таңдаулары көзделген кадрды құруға көмектеседі.
- Қабылданатын кіріс деректері
- Мәтін · Суреттер
- Нәтижелер
- Бейне
Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер
Ailoot Ultra · Бейне POST /v1/videos
- Кіріс
text,image- Шығыс
video
| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер minimaxi-hailuo-02 Шарттар: Ailoot моделін таңдаудың дәл мәнін пайдаланыңыз. | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті | Мәндер мен шектеулер Шарттар: Көріністі және қозғалысты сипаттаңыз. | Әдепкі— |
Өрісduration | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер 6, 10 Шарттар: Тізімдегі ұзақтық мәндерінің бірін жіберіңіз; әдепкі мән белгіленбеген. | Әдепкі— |
Өрісend_image | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Шарттар: Соңғы кадр қолдау көрсетілетін сурет кірісі режимінде ғана қолданылады. | Әдепкі— |
Өрісimage | Түріstring or array<string> | ТалапМіндетті емес | Мәндер мен шектеулер Шарттар: Нақты жалпыға қолжетімді сурет URL мекенжайын немесе base64 сурет жолын пайдаланыңыз; мұнда суреттердің ең көп саны белгіленбейді. | Әдепкі— |
Өрісresolution | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 512P, 768P, 1080P Шарттар: Тізімдегі ажыратымдылық мәндерінің бірін жіберіңіз; әдепкі мән белгіленбеген. | Әдепкі— |
Әдіс параметрлері мен өмірлік циклі
| Параметр | Параметр талаптары |
|---|---|
Параметрcontent_type | Параметр талаптарыapplication/json |
Параметрrequired | Параметр талаптарыmodel, prompt |
Параметрoptional | Параметр талаптарыduration, end_image, image, resolution |
Параметрmaterial_types | Параметр талаптарыtext, image |
Параметрconditions | Параметр талаптарыAiloot моделін таңдаудың дәл мәнін пайдаланыңыз., Көріністі және қозғалысты сипаттаңыз., Тізімдегі ұзақтық мәндерінің бірін жіберіңіз; әдепкі мән белгіленбеген., Соңғы кадр қолдау көрсетілетін сурет кірісі режимінде ғана қолданылады., Нақты жалпыға қолжетімді сурет URL мекенжайын немесе base64 сурет жолын пайдаланыңыз; мұнда суреттердің ең көп саны белгіленбейді., Тізімдегі ажыратымдылық мәндерінің бірін жіберіңіз; әдепкі мән белгіленбеген. |
Әдістің балама атаулары: /v1/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/media/assets
GET /v1/media/assets/{asset_id}
Тарифтер
Қорытынды төлем қалай есептеледі
Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.
Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.
- Жылдам режим
- Көрсетілмеген Жылдам режим таңдалғанда
- Икемді режим
- Көрсетілмеген flex режимі таңдалғанда
- Ой қорытудың ең жоғары деңгейі
- Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда
Салыстыруға арналған болжамды мөлшерлемелер
Баптаулар бойынша бағалар
Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.
| Баптау | Мөлшерлемелер кестесі | Болжамды мөлшер | Төлем |
|---|---|---|---|
| БаптауТокендердің базалық тарифтері | Мөлшерлемелер кестесіНегізгі мөлшерлеме | Болжамды мөлшер— | Төлем Кіріс · Кіріс токендері · Тек салыстыруға арналған бағалау — / 1K токен Шығыс · Шығыс токендері · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшті оқу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу, 1 сағ · Тек салыстыруға арналған бағалау — / 1K токен |
| БаптауГенерацияның болжамды құны | Мөлшерлемелер кестесі— | Болжамды мөлшербір генерацияға арналған болжам | Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.2 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес. |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
Сұрау мысалдары
Ailoot Ultra · Бейне
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "minimaxi-hailuo-02",
"prompt": "A cat is walking on grass."
}
JSON
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
# Create once; retain id, polling_url, original task identifiers and every header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
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())
roles={}
def visit(v,path=""):
if isinstance(v,dict):
for k,x in v.items(): visit(x,path+"/"+k)
elif isinstance(v,list):
for i,x in enumerate(v): visit(x,path+"/"+str(i))
elif isinstance(v,str):
u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
target=Path(f"asset-{i}.bin")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
raw=target.read_bytes()
if not raw: raise SystemExit("Empty asset; retain original status and metadata")
ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
name=f"asset-{i}.{ext}"
if target.name!=name: target.rename(name)
manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS
Нәтижелерді алу және сақтау
Ailoot Ultra · Бейне
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Барлық дайын нәтижені сақтау
Әр дайын бейнені немесе қайтарылған файлды сақтаңыз; нақты қайтарылған әр материал URL арқылы мазмұнды алыңыз.
Толық жауап пен тақырыптарды, бастапқы идентификаторларды, әрбір нақты шығыс нәтижесін және пайдалану мен есепке алудың барлық өрістерін сақтаңыз. Иелігіңіздегі әрбір бірегей ресурсты сақтап, оған сілтейтін барлық рөлді сақтаңыз.
Бастапқы жауапты тексеру қажет болса
Қайтарылған ашық тапсырма не операция id мәнін және барлық тақырыптарды сақтаңыз. Тек бастапқы тапсырманы оқыңыз; unknown немесе result_pending_check күйі қайта жасауға рұқсат бермейді.
Жауап өрістері
| Өріс | Түрі |
|---|---|
Өрісid | Түріstring |
Өрісpolling_url | Түріstring |
Өрісprovider_task_id | Түріstring |
Өрісtask_id | Түріstring |
Өрісstatus | Түріstring |
Өрісvideo_url | Түріstring |
Балама атаулар
Модельдердің балама атаулары
Ailoot Ultra minimaxi-hailuo-02
Әдіс жолдарының балама атаулары
/v1/videos/generations
Шақыруға арналған байланысты ID
FAQ · MiniMax: Hailuo 02
- Қандай кіріс деректері мен нәтижелер қолжетімді?
POST /v1/videos·minimaxi-hailuo-02:text,image→video- Сұрау қандай өрістерді пайдаланады?
POST /v1/videos·minimaxi-hailuo-02:model,prompt,duration,end_image,image,resolution