Hailuo 2.3 Fast
A MiniMax Hailuo 2.3 Fast rövid mozgásprompt alapján animál egy első képkockaként szolgáló képet. Ezt a kép-videó profilt termékfelvételhez, karakterpózhoz vagy storyboard-állóképhez válaszd.
A modellről
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
A MiniMax Hailuo 2.3 Fast a képből videót generáló, külön megnevezett Fast profil. Indulj megkomponált első képkockából, és írd le, hogyan mozogjon a téma vagy a kamera. Egy termékállókép, karakterpóz vagy storyboard-képkocka konkrét vizuális kiindulópontot ad a felvételnek.
A kép és a mozgásleírás előkészítése
Adj meg négyzetes PNG vagy JPEG képet HTTPS URL-en keresztül, mindkét oldalán 300–4 096 pixellel. A letöltött képfájl legfeljebb 20 000 000 bájtos lehet. A prompt legyen 1–199 karakter hosszú, egy látható cselekvésre és a felvétel szempontjából fontos mozgásra összpontosítva.
A klip követése a befejezésig
Ez a profil egy 768 × 768-as MP4 klipre van beállítva, névlegesen hatmásodperces időtartammal. A kérést egyszer küldd be, mentsd el a visszaadott azonosítót, és ezt az eredeti kérést kövesd a befejezéséig. Töltsd le a visszaadott videót, és az eredménnyel együtt őrizd meg jelentett méreteit és mért időtartamát. Ha a létrehozás kimenetele bizonytalan, az eredeti kérést ellenőrizd tovább az újbóli létrehozás helyett.
Ailoot Ultra · Videó POST /v1/videos MiniMax-Hailuo-2.3-Fast
MiniMax-Hailuo-2.3-FastKezdő lépések
A MiniMax Hailuo 2.3 Fast rövid mozgásprompt alapján animál egy első képkockaként szolgáló képet. Ezt a kép-videó profilt termékfelvételhez, karakterpózhoz vagy storyboard-állóképhez válaszd.
- Elfogadott bemenetek
- Szöveg · Képek
- Eredmények
- Videó
Elérhető az Ailootban · bemenetek és metódusok
Ailoot Ultra · Videó POST /v1/videos
- Bemenet
text,image- Kimenet
video- Kimeneti formátum
- mp4
- Kimenetek száma
- Legfeljebb 1 kimenet
| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok MiniMax-Hailuo-2.3-Fast | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok Minimális hossz: 1 Maximális hossz: 199 Egység: Unicode-karakterek | Alapértelmezett— |
Meződuration | Típusinteger | KövetelményKötelező | Értékek és korlátok 6 Egység: másodperc | Alapértelmezett— |
Mezőresolution | Típusstring | KövetelményKötelező | Értékek és korlátok 768P | Alapértelmezett— |
Mezőfirst_frame_image | Típushttps_url | KövetelményKötelező | Értékek és korlátok Fájl maximális bájtszáma: 20 000 000 MIME-típusok: image/png, image/jpeg Minimális méret: 300 Maximális méret: 4096 Csak négyzetes: Igen | Alapértelmezett— |
Bemeneti anyagok kombinációi
Képből videó · Kötelező: prompt, first_frame_image
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, prompt, duration, resolution, first_frame_image |
Paraméterother_options | Szerződésfalse |
Paraméterduration | Szerződés6 |
Paraméterresolution | Szerződés768P |
Paraméterprompt_max_characters | Szerződés199 |
Paraméterfirst_frame_image | Szerződés{"type":"https_url","format":["png","jpeg"],"dimensions":"négyzet alakú, 300..4096 pixel","full_image_validation_before_send":true,"maximum_file_bytes":20000000} |
Paramétermaterial_types | Szerződéstext, image |
Paraméteradditional_properties | Szerződésfalse |
Metódus álnevei: /v1/videos/generations, /videos, /videos/generations
Életciklus: 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
Hozza létre egyszer, és mentse el a visszaadott azonosítót.
Kérdezze le az eredeti állapotot; őrizzen meg minden elkészült médiaállományt és időtartamot.
Díjcsomagok
A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.
- Gyors mód
- Nincs megadva Ha a gyors mód van kiválasztva
- Flex mód
- Nincs megadva Ha a flex mód van kiválasztva
- Maximális gondolkodási ráfordítás
- Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik
Ailoot-díjak
Árak beállításonként
Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.
| Beállítás | Díjtáblázat | Klip névleges hossza, másodperc | Felbontás | Elszámolási egység | Díj |
|---|---|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Klip névleges hossza, másodperc— | Felbontás— | Elszámolási egység— | Díj Bemenet · Bemeneti tokenek — / 1K token Kimenet · Kimeneti tokenek — / 1K token Bemenet · Gyorsítótár olvasása — / 1K token Bemenet · Írás a gyorsítótárba — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra — / 1K token |
| BeállításUltra | Díjtáblázat— | Klip névleges hossza, másodperc6 | Felbontás768P | Elszámolási egységnévlegesen 6s hosszú kimeneti klipenként | Díj Kimenet · névlegesen 6s hosszú kimeneti klip $0.4 névlegesen 6s hosszú kimeneti klipenként |
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
A referencia-díjszabás részletei
A modellszintű referenciatáblázatok nem módosítják a metódusválasztást, az árajánlatokat vagy a díjakat. A tényleges díjak a kiválasztott Ailoot-metódus díjtételeit használják.
MiniMax-Hailuo-2.3-Fast
Árak beállításonként
| Beállítás | Elszámolási feltételek | Díj |
|---|---|---|
| BeállításMiniMax-Hailuo-2.3-Fast · Alapértelmezett beállítások | Elszámolási feltételekAlapértelmezett konfiguráció | Díj Bemenet · Bemenet 0,00 USD hívásonként Kimenet · Kimenet 0,40 USD hívásonként |
MiniMax-Hailuo-2.3-Fast
Árak beállításonként
| Beállítás | Elszámolási feltételek | Díj |
|---|---|---|
| BeállításMiniMax-Hailuo-2.3-Fast · Alapértelmezett beállítások | Elszámolási feltételekAlapértelmezett konfiguráció | Díj Bemenet · Bemenet 0,00 USD hívásonként Kimenet · Kimenet 0,80 USD hívásonként |
MiniMax-Hailuo-2.3-Fast
Árak beállításonként
| Beállítás | Elszámolási feltételek | Díj |
|---|---|---|
| BeállításMiniMax-Hailuo-2.3-Fast · Alapértelmezett konfiguráció | Elszámolási feltételekAlapértelmezett konfiguráció | Díj Bemenet · Bemenet 0,00 USD hívásonként Kimenet · Kimenet 0,80 USD hívásonként |
Példakérések
Ailoot Ultra · Videó
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
Eredmények fogadása és mentése
Ailoot Ultra · Videó
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Feladatállapot ellenőrzése
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
További tartalomlekérések
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
Őrizzen meg minden elkészült eredményt
Mentsen minden elkészült videót és visszaadott fájlt; töltse le az összes ténylegesen visszaadott médiafájl URL-jének tartalmát.
A befejezett data[] az összes saját aláírt tartalom-URL-címet tartalmazza. Kérje le mindegyik visszaadott URL-címet, vagy használja a tartalomvégpontot egy tényleges kimeneti indexre állított index értékkel. Egy sikertelen eredeti feladat charge_pending_check értéket adhat vissza; azt az eredeti feladatot ellenőrizze, ne hozza létre újra.
Ha az eredeti választ ellenőrizni kell
A meglévő eredeti feladatot kérdezze le; ismeretlen kimenetelű küldést soha ne küldjön be újra.
Maximális kimenetszám: 1.
Válaszmezők
| Mező | Típus | Jelentés |
|---|---|---|
Mezőid | Típusstring | Jelentés— |
Mezőobject | Típusstring | Jelentés— |
Mezőmodel | Típusstring | Jelentés— |
Mezőstatus | Típusstring | Jelentés— |
Meződata[] | Típussigned content URL | Jelentés— |
Mezőcharge_pending_check | Típusboolean | Jelentés— |
Mezőerror.code | Típusstring | Jelentés— |
Mezőerror.message | Típusstring | Jelentés— |
Mezőrequested_nominal_duration_seconds | Típusinteger | Jelentés— |
Mezőmeasured_duration_seconds | Típusnumber | Jelentés— |
Mezőwidth | Típusinteger | Jelentés— |
Mezőheight | Típusinteger | Jelentés— |
Mezőoperation_id | Típusstring | JelentésAkkor érkezik vissza, ha status=unknown; a tényleges eredeti nyilvános videóművelet azonosítója |
Mezőrequest_id | Típusstring | JelentésOpcionális, ha status=unknown; csak akkor érkezik vissza, ha az eredeti feladathoz tartozik kérésazonosító |
Hibák és következő lépések
| Válasz | Feltétel | Következő lépés |
|---|---|---|
Válasz400 · invalid_request_error | FeltételA nyers kéréstörzs beolvasása a videóprofil feldolgozása előtt sikertelen | Következő lépésŐrizze meg a visszaadott választ, és javítsa az olvashatatlan kéréstörzset. |
Válasz422 · price_unavailable | FeltételA pontos videóprofil feldolgozása sikertelen, vagy a teljes feldolgozott profilhoz nincs kész, pontos árkártya | Következő lépésŐrizze meg a választ; használja a teljes, pontosan engedélyezett profilt és annak közzétett árkártyáját. Ez az ág a szolgáltatónak történő küldés előtt fut le. |
Válasz409 · video_not_ready | FeltételAz eredeti eredmény tartalma még nem érhető el | Következő lépésKérdezze le az eredetileg visszaadott azonosítót, és tartsa be a Retry-After előírását. |
Válaszserver_error | FeltételA visszaadott válasz szerint a művelet vagy az eredmény ellenőrzést igényel | Következő lépésŐrizze meg az eredetileg visszaadott művelet- vagy feladatazonosítót, a kérés fejléceit és a választ; folytassa az eredeti művelet támogatott lekérdezéseit. Ne küldje be újra a létrehozási kérést. |
Válasz200 · video_result_unverified | FeltételAz eredeti Fast feladat állapota ismeretlen; status=unknown és charge_pending_check=true | Következő lépésŐrizze meg a ténylegesen visszaadott id/operation_id és opcionális request_id értékeket; csak az eredeti feladatot kérdezze le. Soha ne küldje be újra. |
Álnevek
Modell álnevei
Ailoot Ultra MiniMax-Hailuo-2.3-Fast
Metódusútvonalak álnevei
/v1/videos/generations, /videos, /videos/generations
Kapcsolódó modellazonosítók
FAQ · Hailuo 2.3 Fast
- Milyen bemenetek és eredmények érhetők el?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:text,image→video- Mely mezőket használja a kérés?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:model,prompt,duration,resolution,first_frame_image- Milyen korlátok érvényesek?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:prompt.maximum_length:199