MiniMax: Hailuo 02
Hailuo 02 kuria vaizdo įrašą pagal tekstą arba pirmo kadro paveikslėlį ir palaiko dokumentuotą pirmo bei paskutinio kadrų darbo eigą. Kameros komandos, prompto optimizavimas ir nuo režimo priklausantys trukmės bei raiškos pasirinkimai padeda suformuoti numatytą kadrą.
Apie modelį
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
Hailuo 02 yra MiniMax vaizdo įrašų modelis tekstu kuriamoms scenoms, paveikslėlių animavimui ir darbo eigai su pirmu bei paskutiniu kadrais. Rašytinė užduotis aprašo objektą, veiksmą ir kamerą, o pateikti kadrai gali nustatyti vaizdinį pradžios tašką arba perėjimo galutinę būseną. Generavimo režimą rinkitės pagal jau turimą medžiagą ir kadro dalį, kurią reikia valdyti.
Kurdami vaizdo įrašą pagal tekstą aprašykite nuoseklų veiksmą su aiškia aplinka ir žiūros tašku. Scenoje gali būti nedidelis burlaivis, plaukiantis pro prieplauką, o kamera jį seka nuo kranto. Nurodykite, kas juda, kurios detalės turi išlikti matomos ir kuo kadras baigiasi. Aprašymą sutelkite į stebimus įvykius, o ne į nesusijusių vaizdinių savybių sąrašą.
Kurdami pagal paveikslėlį paruoškite pirmą kadrą, kuriame jau nustatytas numatytas objektas ir kadravimas. Gamintojas priima mažesnius nei 20 MB JPG, JPEG, PNG ir WebP paveikslėlius, kurių trumpoji kraštinė didesnė nei 300 pikselių, o kraštinių santykis yra nuo 2:5 iki 5:2. Naudokite vaizdą, kuriame matomi svarbūs kontūrai ir savybės, tada aprašykite iš jo besivystantį judėjimą.
Hailuo 02 taip pat turi dokumentuotą pirmo ir paskutinio kadrų režimą. Du paveikslėlius paruoškite kaip numatytas vienos sekos pradžios bei pabaigos būsenas ir aprašykite judėjimą tarp jų. Pirmas kadras nustato kadravimą; gamintojas nurodo, kad kitokio dydžio paskutinis kadras apkerpamas pagal pirmąjį. Iš anksto suderinkite vaizdų kompoziciją, jei objektas per visą perėjimą turi išlikti matomas.
Prompte gali būti iki 2 000 simbolių. Hailuo 02 palaiko laužtiniuose skliaustuose pateikiamas kameros komandas, įskaitant push, pull, truck, pan, pedestal, tilt, zoom, tracking ir static shot. Kartu vienuose skliaustuose pateiktos komandos prašo vienalaikio judėjimo, o skirtingose aprašymo vietose — veiksmų sekos. Gamintojas rekomenduoja derinti ne daugiau kaip tris judesius, todėl rinkitės tokį kameros veiksmą, kuris padeda aiškiau parodyti objektą.
Trukmė ir raiška priklauso nuo režimo. Kūrimo pagal tekstą apraše nurodomos šešios arba dešimt sekundžių esant 768P raiškai ir šešios sekundės esant 1080P raiškai. Kūrimo pagal paveikslėlį apraše papildomai nurodoma 512P raiška šešioms arba dešimčiai sekundžių. Pirmo ir paskutinio kadrų darbo eiga dokumentuoja 768P raišką šešioms arba dešimčiai sekundžių ir 1080P raišką šešioms sekundėms. Kadrui parinkite palaikomą derinį, užuot vieno režimo raiškos pasirinkimus perkėlę visiems kitiems režimams.
Automatinis prompto optimizavimas yra dokumentuotas valdiklis ir gamintojo darbo eigoje pagal numatytuosius parametrus yra įjungtas. Lygindami versijas išsaugokite jo nustatymą, nes perrašyta užduotis pakeičia modeliui perduodamą turinį. Su sugeneruotu įrašu išsaugokite tikslų tekstą, pradinius kadrus ir pasirinktus išvesties parametrus, kad pataisa būtų nukreipta į taisytiną veiksmą arba kadravimą.
Peržiūrėkite visą užbaigtą seką: pradinę kompoziciją, objekto tęstinumą, veiksmo laiką ir paskutinį kadrą. Perėjimo atveju patikrinkite abu galinius vaizdus ir judėjimą tarp jų. Montažui išsaugokite tikrą vaizdo įrašą kartu su promptu bei nuorodomis; kitą pataisą skirkite konkrečiai vaizdinei problemai, pavyzdžiui, paslėptai detalei, staigiam kameros judesiui ar per anksti ateinančiai pabaigai.
Ailoot Ultra · Vaizdo įrašai POST /v1/videos minimaxi-hailuo-02
minimaxi-hailuo-02Pradžia
Hailuo 02 kuria vaizdo įrašą pagal tekstą arba pirmo kadro paveikslėlį ir palaiko dokumentuotą pirmo bei paskutinio kadrų darbo eigą. Kameros komandos, prompto optimizavimas ir nuo režimo priklausantys trukmės bei raiškos pasirinkimai padeda suformuoti numatytą kadrą.
- Leidžiamos įvestys
- Tekstas · Vaizdai
- Rezultatai
- Vaizdo įrašai
Prieinama Ailoot · įvestys ir metodai
Ailoot Ultra · Vaizdo įrašai POST /v1/videos
- Įvestis
text,image- Išvestis
video
| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos minimaxi-hailuo-02 Sąlygos: Naudokite tikslų Ailoot modelio parinkiklį. | Numatyta— |
Laukasprompt | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos Sąlygos: Aprašykite sceną ir judesį. | Numatyta— |
Laukasduration | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos 6, 10 Sąlygos: Siųskite vieną iš išvardytų trukmės reikšmių; numatytoji reikšmė nenurodoma. | Numatyta— |
Laukasend_image | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Sąlygos: Pabaigos kadras taikomas tik palaikomu įvesties paveikslėlių režimu. | Numatyta— |
Laukasimage | Tipasstring or array<string> | ReikalavimasNeprivaloma | Reikšmės ir ribos Sąlygos: Naudokite tikrą viešai pasiekiamo paveikslėlio URL arba base64 paveikslėlio eilutę; didžiausias paveikslėlių skaičius čia nenurodomas. | Numatyta— |
Laukasresolution | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 512P, 768P, 1080P Sąlygos: Siųskite vieną iš išvardytų skiriamosios gebos reikšmių; numatytoji reikšmė nenurodoma. | Numatyta— |
Metodo parametrai ir gyvavimo ciklas
| Parametras | Specifikacija |
|---|---|
Parametrascontent_type | Specifikacijaapplication/json |
Parametrasrequired | Specifikacijamodel, prompt |
Parametrasoptional | Specifikacijaduration, end_image, image, resolution |
Parametrasmaterial_types | Specifikacijatext, image |
Parametrasconditions | SpecifikacijaNaudokite tikslų Ailoot modelio parinkiklį., Aprašykite sceną ir judesį., Siųskite vieną iš išvardytų trukmės reikšmių; numatytoji reikšmė nenurodoma., Pabaigos kadras taikomas tik palaikomu įvesties paveikslėlių režimu., Naudokite tikrą viešai pasiekiamo paveikslėlio URL arba base64 paveikslėlio eilutę; didžiausias paveikslėlių skaičius čia nenurodomas., Siųskite vieną iš išvardytų skiriamosios gebos reikšmių; numatytoji reikšmė nenurodoma. |
Metodo pseudonimai: /v1/videos/generations
Gyvavimo ciklas: 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}
Planai
Kaip apskaičiuojamas galutinis mokestis
Rodomi įkainiai leidžia įvertinti kainą prieš generavimą. Galutinė suma apskaičiuojama pagal užfiksuotą pradinio generavimo kainą. Išmatuota rezultato trukmė ir prognozuoti kiekiai nėra galutinis apmokestinamas kiekis.
Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.
- Spartusis režimas
- Nenurodyta Pasirinkus spartųjį režimą
- Flex režimas
- Nenurodyta Pasirinkus flex režimą
- Didžiausios samprotavimo pastangos
- Nenurodyta Kai didžiausioms samprotavimo pastangoms taikomas numatytasis koregavimas (default)
Numatomi įkainiai palyginimui
Kainos pagal konfigūraciją
Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.
| Konfigūracija | Įkainių lentelė | Numatomas kiekis | Mokestis |
|---|---|---|---|
| KonfigūracijaBaziniai žetonų įkainiai | Įkainių lentelėBazinis įkainis | Numatomas kiekis— | Mokestis Įvestis · Įvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Išvestis · Išvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Įvestis · Talpyklos skaitymas · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val · Įvertis tik palyginimui — / 1K tokenų |
| KonfigūracijaNumatoma generavimo kaina | Įkainių lentelė— | Numatomas kiekisvieno generavimo įvertis | Mokestis Išvestis · Numatoma generavimo kaina · Įvertis tik palyginimui $0.2 įvertis prieš generavimą Šis įvertis nėra papildomas mokestis ar fiksuotas užbaigto generavimo įkainis. |
Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →
Užklausų pavyzdžiai
Ailoot Ultra · Vaizdo įrašai
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
Gauti ir išsaugoti rezultatus
Ailoot Ultra · Vaizdo įrašai
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}
Išsaugoti visus baigtus rezultatus
Išsaugokite kiekvieną baigtą vaizdo įrašą arba grąžintą failą; gaukite turinį iš kiekvieno faktiškai grąžinto medžiagos URL.
Išsaugokite visą atsakymą ir antraštes, pradinius identifikatorius, kiekvieną tikrą rezultatą ir visus naudojimo bei apskaitos laukus. Išsaugokite kiekvieną unikalų jums priklausantį išteklių ir visas į jį nukreiptas paskirtis.
Jei reikia patikrinti pradinį atsakymą
Išsaugokite grąžintą viešą užduoties ar operacijos id ir visas antraštes. Skaitykite tik pradinės užduoties duomenis; unknown arba result_pending_check nesuteikia leidimo kurti dar kartą.
Atsakymo laukai
| Laukas | Tipas |
|---|---|
Laukasid | Tipasstring |
Laukaspolling_url | Tipasstring |
Laukasprovider_task_id | Tipasstring |
Laukastask_id | Tipasstring |
Laukasstatus | Tipasstring |
Laukasvideo_url | Tipasstring |
Pseudonimai
Modelių pseudonimai
Ailoot Ultra minimaxi-hailuo-02
Metodų kelių pseudonimai
/v1/videos/generations
Susiję ID iškvietimui
FAQ · MiniMax: Hailuo 02
- Kokios įvestys ir rezultatai prieinami?
POST /v1/videos·minimaxi-hailuo-02:text,image→video- Kokius laukus naudoja užklausa?
POST /v1/videos·minimaxi-hailuo-02:model,prompt,duration,end_image,image,resolution