Hailuo 2.3 Fast
MiniMax Hailuo 2.3 Fast animuje obrázok prvej snímky podľa krátkeho pohybového zadania. Tento profil image-to-video zvoľte pre produktový záber, pózu postavy alebo statickú snímku storyboardu.
O modeli
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
MiniMax Hailuo 2.3 Fast je pomenovaný profil Fast na generovanie image-to-video. Začnite skomponovaným obrázkom prvej snímky a opíšte, ako sa má pohybovať subjekt alebo kamera. Statický produktový obrázok, póza postavy alebo snímka storyboardu dávajú záberu konkrétny vizuálny východiskový bod.
Pripravte obrázok a pohybové zadanie
Dodajte štvorcový obrázok PNG alebo JPEG prostredníctvom HTTPS URL, s každou stranou od 300 do 4 096 pixelov. Stiahnutý obrázkový súbor nesmie byť väčší než 20 000 000 bajtov. Zadanie udržte v rozsahu 1 až 199 znakov a sústreďte ho na jednu viditeľnú akciu a pohyb dôležitý pre záber.
Sledujte klip až do dokončenia
Tento profil je nastavený na jeden klip MP4 s rozmermi 768 × 768 a nominálnou dĺžkou šesť sekúnd. Požiadavku odošlite raz, uložte vrátené ID a sledujte pôvodnú požiadavku až do dokončenia. Stiahnite výsledné video a spolu s výsledkom uchovajte jeho hlásené rozmery a nameranú dĺžku. Ak je výsledok vytvorenia neistý, pokračujte v kontrole pôvodnej požiadavky namiesto jej opätovného vytvorenia.
Ailoot Ultra · Video POST /v1/videos MiniMax-Hailuo-2.3-Fast
MiniMax-Hailuo-2.3-FastÚvod
MiniMax Hailuo 2.3 Fast animuje obrázok prvej snímky podľa krátkeho pohybového zadania. Tento profil image-to-video zvoľte pre produktový záber, pózu postavy alebo statickú snímku storyboardu.
- Povolené vstupy
- Text · Obrázky
- Výsledky
- Video
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · Video POST /v1/videos
- Vstup
text,image- Výstup
video- Výstupný formát
- mp4
- Počet výstupov
- Do 1 výstup
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity MiniMax-Hailuo-2.3-Fast | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity Minimálna dĺžka: 1 Maximálna dĺžka: 199 Jednotka: znaky Unicode | Predvolené— |
Poleduration | Typinteger | PožiadavkaPovinné | Hodnoty a limity 6 Jednotka: sekundy | Predvolené— |
Poleresolution | Typstring | PožiadavkaPovinné | Hodnoty a limity 768P | Predvolené— |
Polefirst_frame_image | Typhttps_url | PožiadavkaPovinné | Hodnoty a limity Maximálna veľkosť súboru v bajtoch: 20 000 000 Typy MIME: image/png, image/jpeg Minimálny rozmer: 300 Maximálny rozmer: 4 096 Iba štvorcové: Áno | Predvolené— |
Kombinácie vstupných podkladov
Z obrázka na video · Povinné: prompt, first_frame_image
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, prompt, duration, resolution, first_frame_image |
Parameterother_options | Špecifikáciafalse |
Parameterduration | Špecifikácia6 |
Parameterresolution | Špecifikácia768P |
Parameterprompt_max_characters | Špecifikácia199 |
Parameterfirst_frame_image | Špecifikácia{"type":"https_url","format":["png","jpeg"],"dimensions":"štvorec s rozmermi 300..4096 pixelov","full_image_validation_before_send":true,"maximum_file_bytes":20000000} |
Parametermaterial_types | Špecifikáciatext, image |
Parameteradditional_properties | Špecifikáciafalse |
Aliasy metódy: /v1/videos/generations, /videos, /videos/generations
Životný cyklus: 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
Vytvorte iba raz a uložte vrátené ID.
Priebežne zisťujte pôvodný stav; zachovajte každý dokončený súbor a jeho dĺžku.
Cenník
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
- Rýchly režim
- Neuvedené Keď je zvolený rýchly režim
- Režim Flex
- Neuvedené Keď je zvolený režim flex
- Maximálna úroveň uvažovania
- Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Sadzby Ailoot
Ceny podľa konfigurácie
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Nominálne trvanie klipu, sekundy | Rozlíšenie | Účtovacia jednotka | Poplatok |
|---|---|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Nominálne trvanie klipu, sekundy— | Rozlíšenie— | Účtovacia jednotka— | Poplatok Vstup · Vstupné tokeny — / 1K tokenov Výstup · Výstupné tokeny — / 1K tokenov Vstup · Čítanie cache — / 1K tokenov Vstup · Zápis do cache — / 1K tokenov Vstup · Zápis do cache, 1 hod — / 1K tokenov |
| KonfiguráciaUltra | Sadzobník— | Nominálne trvanie klipu, sekundy6 | Rozlíšenie768P | Účtovacia jednotkaza výstupný klip s nominálnym trvaním 6s | Poplatok Výstup · výstupný klip s nominálnou dĺžkou 6s $0.4 za výstupný klip s nominálnym trvaním 6s |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Podrobnosti referenčnej tarify
Referenčné sadzobníky modelu nemenia výber metódy, cenové odhady ani poplatky. Aktívne poplatky používajú sadzby vybranej metódy Ailoot.
MiniMax-Hailuo-2.3-Fast
Ceny podľa konfigurácie
| Konfigurácia | Podmienky účtovania | Poplatok |
|---|---|---|
| KonfiguráciaMiniMax-Hailuo-2.3-Fast · Predvolená konfigurácia | Podmienky účtovaniaPredvolená konfigurácia | Poplatok Vstup · Vstup 0,00 USD za volanie Výstup · Výstup 0,40 USD za volanie |
MiniMax-Hailuo-2.3-Fast
Ceny podľa konfigurácie
| Konfigurácia | Podmienky účtovania | Poplatok |
|---|---|---|
| KonfiguráciaMiniMax-Hailuo-2.3-Fast · Predvolená konfigurácia | Podmienky účtovaniaPredvolená konfigurácia | Poplatok Vstup · Vstup 0,00 USD za volanie Výstup · Výstup 0,80 USD za volanie |
MiniMax-Hailuo-2.3-Fast
Ceny podľa konfigurácie
| Konfigurácia | Podmienky účtovania | Poplatok |
|---|---|---|
| KonfiguráciaMiniMax-Hailuo-2.3-Fast · Predvolená konfigurácia | Podmienky účtovaniaPredvolená konfigurácia | Poplatok Vstup · Vstup 0,00 USD za volanie Výstup · Výstup 0,80 USD za volanie |
Príklady požiadaviek
Ailoot Ultra · Video
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
Prijať a uložiť výsledky
Ailoot Ultra · Video
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Skontrolovať stav úlohy
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
Čítanie ďalšieho obsahu
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
Uchovať všetky dokončené výsledky
Uložte každé dokončené video alebo vrátený súbor; načítajte obsah každej skutočne vrátenej URL podkladu.
Dokončené data[] obsahuje všetky podpísané URL obsahu vo vašom vlastníctve. Načítajte každú vrátenú URL alebo použite koncový bod obsahu s index nastaveným na skutočný index výstupu. Neúspešná pôvodná úloha môže vrátiť charge_pending_check; skontrolujte pôvodnú úlohu namiesto jej opätovného vytvorenia.
Ak treba overiť pôvodnú odpoveď
Načítajte existujúcu pôvodnú úlohu; odoslanie s neznámym výsledkom nikdy neopakujte.
Maximálny počet výstupov: 1.
Polia odpovede
| Pole | Typ | Význam |
|---|---|---|
Poleid | Typstring | Význam— |
Poleobject | Typstring | Význam— |
Polemodel | Typstring | Význam— |
Polestatus | Typstring | Význam— |
Poledata[] | Typsigned content URL | Význam— |
Polecharge_pending_check | Typboolean | Význam— |
Poleerror.code | Typstring | Význam— |
Poleerror.message | Typstring | Význam— |
Polerequested_nominal_duration_seconds | Typinteger | Význam— |
Polemeasured_duration_seconds | Typnumber | Význam— |
Polewidth | Typinteger | Význam— |
Poleheight | Typinteger | Význam— |
Poleoperation_id | Typstring | VýznamVráti sa pri status=unknown; skutočné pôvodné verejné ID operácie videa |
Polerequest_id | Typstring | VýznamVoliteľné pri status=unknown; vráti sa iba vtedy, ak má pôvodná úloha ID požiadavky |
Chyby a ďalšie kroky
| Odpoveď | Podmienka | Ďalší krok |
|---|---|---|
Odpoveď400 · invalid_request_error | PodmienkaNačítanie nespracovaného tela požiadavky zlyhá pred parsovaním profilu videa | Ďalší krokZachovajte vrátenú odpoveď a opravte nečitateľné telo požiadavky. |
Odpoveď422 · price_unavailable | PodmienkaParsovanie presného profilu videa zlyhá alebo úplný parsovaný profil nemá pripravenú presnú cenovú kartu | Ďalší krokZachovajte odpoveď; použite úplný presný povolený profil a jeho zverejnenú kartu. Táto vetva sa vykonáva pred odoslaním poskytovateľovi. |
Odpoveď409 · video_not_ready | PodmienkaPôvodný obsah výsledku zatiaľ nie je dostupný | Ďalší krokPriebežne zisťujte stav pomocou pôvodne vráteného ID a rešpektujte Retry-After. |
Odpoveďserver_error | PodmienkaVrátená odpoveď uvádza, že operáciu alebo výsledok je potrebné skontrolovať | Ďalší krokUchovajte pôvodné vrátené ID operácie/úlohy, hlavičky požiadavky a odpoveď; naďalej čítajte údaje o tejto pôvodnej operácii podporovaným spôsobom. Požiadavku na vytvorenie znova neodosielajte. |
Odpoveď200 · video_result_unverified | PodmienkaStav pôvodnej úlohy Fast je neznámy; status=unknown a charge_pending_check=true | Ďalší krokZachovajte skutočne vrátené id/operation_id a voliteľné request_id; načítavajte iba pôvodnú úlohu. Nikdy ju znova neodosielajte. |
Aliasy
Aliasy modelov
Ailoot Ultra MiniMax-Hailuo-2.3-Fast
Aliasy ciest metód
/v1/videos/generations, /videos, /videos/generations
Súvisiace ID na volanie
FAQ · Hailuo 2.3 Fast
- Aké vstupy a výsledky sú dostupné?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:text,image→video- Aké polia používa požiadavka?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:model,prompt,duration,resolution,first_frame_image- Aké limity platia?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:prompt.maximum_length:199