MiniMax: S2V 01
S2V 01 жаңадан жасалатын видеодағы кейіпкерге бағыт беру үшін портрет референсін пайдаланады. Бір анық бет суретін беріп, көрініс пен әрекетті сипаттаңыз; өндірушінің нысан референсі процесі суретті кейіпкер референсі ретінде қарастырады.
Модель туралы
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
S2V 01 — MiniMax компаниясының нысан референсіне негізделген видеомоделі. Берілген сурет кейіпкердің сыртқы көрінісін бағыттайды, ал мәтін видео көрінісі мен әрекетін сипаттайды. Құжатталған референс түрі — адамның беті, сондықтан портретті жасалған тізбекке орналастырғыңыз келетін кейіпкердің сәйкестендіру бағдары ретінде дайындаңыз.
Көзделген бет анық әрі оңай ажыратылатын референсті таңдаңыз. Нәтижеге маңызды болса, айқындаушы белгілерді қолдың, үлкен керек-жарақтың артына немесе қатты қиылған кадрға жасырмаңыз. Кейіпкерді бағыттаған дереккөз белгілі болуы үшін байланысты кадрларда портретті бірізді сақтаңыз. Референс сыртқы көрініс туралы ақпарат береді; кейіпкер әрекет етуі тиіс көріністі нұсқаумен түсіндіріңіз.
Өндірушінің нысан референсі схемасы референс суреттер массивінде бір суретті қабылдайды. Қолдау көрсетілетін пішімдер — JPG, JPEG, PNG және WebP, файл өлшемі 20 MB-тан аз. Қысқа жағы 300 пиксельден үлкен және арақатынасы 2:5 пен 5:2 арасында болуы тиіс. Кейін салыстырғанда басқа портретпен алмастырмай, нақты сурет файлын генерация жазбасымен бірге сақтаңыз.
Референстегі адамның рөлі анық көріністі сипаттаңыз. Мысалы, кейіпкер тыныш шеберханаға кіріп, үстелдегі затқа қарап, қасына тоқтай алады. Дайын кадрға маңызды әрекетті, ортаны және қарау нүктесін атаңыз. Бет анық көрінуі керек болса, кадрлау мен қозғалысты сол талапқа сай жоспарлаңыз.
Мәтіндік сипаттама 2 000 таңбаға дейін қолдайды. Оны нақты нұсқауларға пайдаланыңыз: кейіпкер не істейді, айналасында не бар және соңғы көрініс нені көрсетуі тиіс. Оқиғаға маңызды киім немесе көрініс бөлшектерін сипаттап, жасалған видео оларды берілген сәйкестендіру референсімен қалай біріктіретінін тексеріңіз. Референс рөлін портреттің бүкіл фонын бастапқы кадр ретінде қайталау сұрауынан ажыратыңыз.
Нұсқауды автоматты оңтайландыру құжатталған және әдепкі қосылған. Жазбаша сипаттаманы дәлірек басқару қажет болса, оны өшіруге болады. Әртүрлі көріністерді салыстырғанда бұл таңдауды мәтінмен және портретпен бірге сақтаңыз. Ұқсастық мәселесін зерттеу үшін жақсартылған референсті салыстырғанда көрініс тапсырмасын өзгеріссіз ұстаңыз; әрекетті зерттеу үшін қозғалыс сипаттамасын түзеткенде референсті өзгеріссіз қалдырыңыз.
Өндіруші процесі видео аяқталғанға дейін тапсырма идентификаторын қайтарады. Күй және нәтиже қадамдарында бастапқы идентификаторды сақтап, дайын клипті тексеруге және монтажға қалдырыңыз. Кейінгі кадр алдыңғы нәтижені бағыттаған нақты материалмен салыстырылуы үшін портретті, нұсқауды және шыққан видеоны бір жазба ретінде сақтаңыз.
Кейіпкерді бүкіл тізбек бойы, соның ішінде бұрылыстарда, қимылдарда және кадрлау өзгергенде тексеріңіз. Бет бірізділігін, көзделген әрекеттің анық көрінуін және кейіпкердің көрініс заттарымен байланысын қараңыз. Кадр мақсатына ең сай клипті таңдап, кірісті түзетпей тұрып нақты сәйкессіздікті анықтаңыз. Қайталанатын кейіпкер процесіне бірнеше дайын кадрды бір портрет референсімен және әр көріністің анық сипаттама жазбасымен қатар қарау пайдалы.
Ailoot Ultra · Бейне POST /v1/videos minimaxi-s2v-01
minimaxi-s2v-01Бастау
S2V 01 жаңадан жасалатын видеодағы кейіпкерге бағыт беру үшін портрет референсін пайдаланады. Бір анық бет суретін беріп, көрініс пен әрекетті сипаттаңыз; өндірушінің нысан референсі процесі суретті кейіпкер референсі ретінде қарастырады.
- Қабылданатын кіріс деректері
- Мәтін · Суреттер
- Нәтижелер
- Бейне
Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер
Ailoot Ultra · Бейне POST /v1/videos
- Кіріс
text,image- Шығыс
video
| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер minimaxi-s2v-01 Шарттар: Ailoot моделін таңдаудың дәл мәнін пайдаланыңыз. | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті | Мәндер мен шектеулер Шарттар: Көріністі және қозғалысты сипаттаңыз. | Әдепкі— |
Өрісend_image | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Шарттар: Соңғы кадр қолдау көрсетілетін сурет кірісі режимінде ғана қолданылады. | Әдепкі— |
Өрісimage | Түріstring or array<string> | ТалапМіндетті емес | Мәндер мен шектеулер Шарттар: Нақты жалпыға қолжетімді сурет URL мекенжайын немесе base64 сурет жолын пайдаланыңыз; мұнда суреттердің ең көп саны белгіленбейді. | Әдепкі— |
Әдіс параметрлері мен өмірлік циклі
| Параметр | Параметр талаптары |
|---|---|
Параметрcontent_type | Параметр талаптарыapplication/json |
Параметрrequired | Параметр талаптарыmodel, prompt |
Параметрoptional | Параметр талаптарыend_image, image |
Параметр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 токен |
| БаптауӘр сұрауға | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Есептелетін мөлшербір сұрау | Төлем Кіріс · Тек салыстыруға арналған бағалау $1.4 әр сұрау үшін |
| БаптауГенерацияның болжамды құны | Мөлшерлемелер кестесі— | Болжамды мөлшербір генерацияға арналған болжам | Есептелетін мөлшер— | Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $1.4 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес. |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
Сұрау мысалдары
Ailoot Ultra · Бейне
# Replace YOUR_ACCESSIBLE_IMAGE_URL with your actual reachable reference image URL.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "minimaxi-s2v-01",
"prompt": "A cat is walking on grass.",
"image": "YOUR_ACCESSIBLE_IMAGE_URL"
}
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-s2v-01
Әдіс жолдарының балама атаулары
/v1/videos/generations
Шақыруға арналған байланысты ID
FAQ · MiniMax: S2V 01
- Қандай кіріс деректері мен нәтижелер қолжетімді?
POST /v1/videos·minimaxi-s2v-01:text,image→video- Сұрау қандай өрістерді пайдаланады?
POST /v1/videos·minimaxi-s2v-01:model,prompt,end_image,image