Hailuo 2.3 Fast
MiniMax Hailuo 2.3 Fast animuoja pirmojo kadro vaizdą pagal trumpą judesio užklausą. Šį kūrimo iš vaizdo profilį rinkitės produkto planui, personažo pozai arba kadruotės nuotraukai.
Apie modelį
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
MiniMax Hailuo 2.3 Fast yra įvardytas Fast profilis vaizdo įrašams generuoti iš vaizdo. Pradėkite nuo sukomponuoto pirmojo kadro vaizdo ir aprašykite, kaip turi judėti objektas arba kamera. Produkto nuotrauka, personažo poza arba kadruotės kadras suteikia planui konkretų vaizdinį pradžios tašką.
Paruoškite vaizdą ir judesio užduotį
Per HTTPS URL pateikite kvadratinį PNG arba JPEG vaizdą, kurio kiekviena kraštinė yra nuo 300 iki 4 096 pikselių. Atsisiųstas vaizdo failas turi būti ne didesnis nei 20 000 000 baitų. Užklausa turi būti nuo 1 iki 199 simbolių, sutelkta į vieną matomą veiksmą ir planui svarbų judesį.
Sekite klipą iki užbaigimo
Šis profilis sukonfigūruotas vienam 768 × 768 MP4 klipui su nominalia šešių sekundžių trukme. Užklausą pateikite vieną kartą, išsaugokite grąžintą ID ir sekite tą pradinę užklausą iki jos užbaigimo. Atsisiųskite grąžintą vaizdo įrašą ir kartu su rezultatu išsaugokite nurodytus matmenis bei išmatuotą trukmę. Jei sukūrimo rezultatas neaiškus, toliau tikrinkite pradinę užklausą, užuot kūrę ją iš naujo.
Ailoot Ultra · Vaizdo įrašai POST /v1/videos MiniMax-Hailuo-2.3-Fast
MiniMax-Hailuo-2.3-FastPradžia
MiniMax Hailuo 2.3 Fast animuoja pirmojo kadro vaizdą pagal trumpą judesio užklausą. Šį kūrimo iš vaizdo profilį rinkitės produkto planui, personažo pozai arba kadruotės nuotraukai.
- 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- Išvesties formatas
- mp4
- Išvesčių skaičius
- Iki 1 išvestis
| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos MiniMax-Hailuo-2.3-Fast | Numatyta— |
Laukasprompt | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos Mažiausias ilgis: 1 Didžiausias ilgis: 199 Vienetas: Unicode simboliai | Numatyta— |
Laukasduration | Tipasinteger | ReikalavimasPrivaloma | Reikšmės ir ribos 6 Vienetas: sekundės | Numatyta— |
Laukasresolution | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos 768P | Numatyta— |
Laukasfirst_frame_image | Tipashttps_url | ReikalavimasPrivaloma | Reikšmės ir ribos Didžiausias failo dydis baitais: 20 000 000 MIME tipai: image/png, image/jpeg Mažiausias matmuo: 300 Didžiausias matmuo: 4 096 Tik kvadratinis: Taip | Numatyta— |
Įvesties medžiagos deriniai
Iš vaizdo į vaizdo įrašą · Privaloma: prompt, first_frame_image
Metodo parametrai ir gyvavimo ciklas
| Parametras | Specifikacija |
|---|---|
Parametrascontent_type | Specifikacijaapplication/json |
Parametrasrequired | Specifikacijamodel, prompt, duration, resolution, first_frame_image |
Parametrasother_options | Specifikacijafalse |
Parametrasduration | Specifikacija6 |
Parametrasresolution | Specifikacija768P |
Parametrasprompt_max_characters | Specifikacija199 |
Parametrasfirst_frame_image | Specifikacija{"type":"https_url","format":["png","jpeg"],"dimensions":"kvadratas, 300..4096 pikselių","full_image_validation_before_send":true,"maximum_file_bytes":20000000} |
Parametrasmaterial_types | Specifikacijatext, image |
Parametrasadditional_properties | Specifikacijafalse |
Metodo pseudonimai: /v1/videos/generations, /videos, /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/videos/generations/{request_id}/content
Sukurkite vieną kartą ir išsaugokite grąžintą ID.
Periodiškai tikrinkite pradinę būseną; išsaugokite kiekvieną užbaigtą išteklių ir jo trukmę.
Planai
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)
Ailoot įkainiai
Kainos pagal konfigūraciją
Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.
| Konfigūracija | Įkainių lentelė | Nominali klipo trukmė, sekundės | Raiška | Apskaitos vienetas | Mokestis |
|---|---|---|---|---|---|
| KonfigūracijaBaziniai žetonų įkainiai | Įkainių lentelėBazinis įkainis | Nominali klipo trukmė, sekundės— | Raiška— | Apskaitos vienetas— | Mokestis Įvestis · Įvesties tokenai — / 1K tokenų Išvestis · Išvesties tokenai — / 1K tokenų Įvestis · Talpyklos skaitymas — / 1K tokenų Įvestis · Rašymas į talpyklą — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val — / 1K tokenų |
| KonfigūracijaUltra | Įkainių lentelė— | Nominali klipo trukmė, sekundės6 | Raiška768P | Apskaitos vienetasuž išvesties klipą, kurio nominali trukmė 6s | Mokestis Išvestis · nominalios 6s trukmės išvesties klipas $0.4 už išvesties klipą, kurio nominali trukmė 6s |
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 →
Informacinio tarifo duomenys
Modelio informacinės lentelės nekeičia metodo pasirinkimo, kainos įverčių ar mokesčių. Galiojantys mokesčiai nustatomi pagal pasirinkto Ailoot metodo įkainius.
MiniMax-Hailuo-2.3-Fast
Kainos pagal konfigūraciją
| Konfigūracija | Apmokestinimo sąlygos | Mokestis |
|---|---|---|
| KonfigūracijaMiniMax-Hailuo-2.3-Fast · Numatytoji konfigūracija | Apmokestinimo sąlygosNumatytoji konfigūracija | Mokestis Įvestis · Įvestis 0,00 USD už iškvietimą Išvestis · Išvestis 0,40 USD už iškvietimą |
MiniMax-Hailuo-2.3-Fast
Kainos pagal konfigūraciją
| Konfigūracija | Apmokestinimo sąlygos | Mokestis |
|---|---|---|
| KonfigūracijaMiniMax-Hailuo-2.3-Fast · Numatytoji konfigūracija | Apmokestinimo sąlygosNumatytoji konfigūracija | Mokestis Įvestis · Įvestis 0,00 USD už iškvietimą Išvestis · Išvestis 0,80 USD už iškvietimą |
MiniMax-Hailuo-2.3-Fast
Kainos pagal konfigūraciją
| Konfigūracija | Apmokestinimo sąlygos | Mokestis |
|---|---|---|
| KonfigūracijaMiniMax-Hailuo-2.3-Fast · Numatytoji konfigūracija | Apmokestinimo sąlygosNumatytoji konfigūracija | Mokestis Įvestis · Įvestis 0,00 USD už iškvietimą Išvestis · Išvestis 0,80 USD už iškvietimą |
Užklausų pavyzdžiai
Ailoot Ultra · Vaizdo įrašai
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
Gauti ir išsaugoti rezultatus
Ailoot Ultra · Vaizdo įrašai
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Tikrinti užduoties būseną
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
Kito turinio skaitymas
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
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.
Užbaigtame data[] yra visi jums priklausantys pasirašyti turinio URL. Gaukite kiekvieną grąžintą URL arba naudokite turinio galinį tašką, nustatę index į tikrą išvesties indeksą. Nepavykusi pradinė užduotis gali grąžinti charge_pending_check; tikrinkite tą pradinę užduotį, užuot kūrę ją dar kartą.
Jei reikia patikrinti pradinį atsakymą
Skaitykite esamos pradinės užduoties duomenis; niekada nekartokite siuntimo, kurio baigtis nežinoma.
Didžiausias išvesčių skaičius: 1.
Atsakymo laukai
| Laukas | Tipas | Reikšmė |
|---|---|---|
Laukasid | Tipasstring | Reikšmė— |
Laukasobject | Tipasstring | Reikšmė— |
Laukasmodel | Tipasstring | Reikšmė— |
Laukasstatus | Tipasstring | Reikšmė— |
Laukasdata[] | Tipassigned content URL | Reikšmė— |
Laukascharge_pending_check | Tipasboolean | Reikšmė— |
Laukaserror.code | Tipasstring | Reikšmė— |
Laukaserror.message | Tipasstring | Reikšmė— |
Laukasrequested_nominal_duration_seconds | Tipasinteger | Reikšmė— |
Laukasmeasured_duration_seconds | Tipasnumber | Reikšmė— |
Laukaswidth | Tipasinteger | Reikšmė— |
Laukasheight | Tipasinteger | Reikšmė— |
Laukasoperation_id | Tipasstring | ReikšmėGrąžinamas, kai status=unknown; tikras pradinis viešas vaizdo įrašo operacijos ID |
Laukasrequest_id | Tipasstring | ReikšmėNeprivalomas, kai status=unknown; grąžinamas tik tada, jei pradinė užduotis turi užklausos ID |
Klaidos ir tolesni veiksmai
| Atsakymas | Sąlyga | Kitas žingsnis |
|---|---|---|
Atsakymas400 · invalid_request_error | SąlygaNepavyksta nuskaityti neapdoroto užklausos turinio prieš analizuojant vaizdo įrašo profilį | Kitas žingsnisIšsaugokite grąžintą atsakymą ir pataisykite nenuskaitomą užklausos turinį. |
Atsakymas422 · price_unavailable | SąlygaNepavyksta išanalizuoti tikslaus vaizdo įrašo profilio arba visam išanalizuotam profiliui nėra parengtos tikslios kainos kortelės | Kitas žingsnisIšsaugokite atsakymą; naudokite visą tikslų leistiną profilį ir jo paskelbtą kortelę. Ši šaka vykdoma prieš siunčiant teikėjui. |
Atsakymas409 · video_not_ready | SąlygaPradinio rezultato turinys dar nepasiekiamas | Kitas žingsnisPeriodiškai tikrinkite pradinį grąžintą ID ir laikykitės Retry-After. |
Atsakymasserver_error | SąlygaGrąžintame atsakyme nurodoma, kad operaciją arba rezultatą reikia patikrinti | Kitas žingsnisIšsaugokite pradinį grąžintą operacijos ar užduoties ID, užklausos antraštes ir atsakymą; toliau tikrinkite tos pačios pradinės operacijos duomenis palaikomais būdais. Kūrimo užklausos pakartotinai neteikite. |
Atsakymas200 · video_result_unverified | SąlygaPradinės Fast užduoties būsena nežinoma; status=unknown ir charge_pending_check=true | Kitas žingsnisIšsaugokite tikrus grąžintus id/operation_id ir neprivalomą request_id; skaitykite tik pradinės užduoties duomenis. Niekada neteikite pakartotinai. |
Pseudonimai
Modelių pseudonimai
Ailoot Ultra MiniMax-Hailuo-2.3-Fast
Metodų kelių pseudonimai
/v1/videos/generations, /videos, /videos/generations
Susiję ID iškvietimui
FAQ · Hailuo 2.3 Fast
- Kokios įvestys ir rezultatai prieinami?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:text,image→video- Kokius laukus naudoja užklausa?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:model,prompt,duration,resolution,first_frame_image- Kokie apribojimai taikomi?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:prompt.maximum_length:199