Hailuo 2.3 Fast
MiniMax Hailuo 2.3 Fast animuje obrázek prvního snímku podle krátkého promptu popisujícího pohyb. Tento profil tvorby videa z obrázku zvolte pro produktový záběr, pózu postavy nebo snímek storyboardu.
O modelu
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
MiniMax Hailuo 2.3 Fast je pojmenovaný profil Fast pro generování videa z obrázku. Začněte kompozičně připraveným obrázkem prvního snímku a popište, jak se má pohybovat objekt či kamera. Produktový obrázek, póza postavy nebo snímek storyboardu dávají záběru konkrétní vizuální výchozí bod.
Připravte obrázek a zadání pohybu
Dodejte čtvercový obrázek PNG nebo JPEG prostřednictvím HTTPS URL; každá strana musí mít 300 až 4 096 pixelů. Stažený obrazový soubor nesmí být větší než 20 000 000 bajtů. Prompt udržte v rozsahu 1 až 199 znaků a soustřeďte jej na jeden viditelný děj a pohyb důležitý pro záběr.
Sledujte klip až do dokončení
Tento profil je nastaven na jeden klip MP4 o velikosti 768 × 768 s nominální délkou šest sekund. Požadavek odešlete jednou, uložte vrácené ID a původní požadavek sledujte až do dokončení. Vrácené video stáhněte a spolu s výsledkem uchovejte jeho nahlášené rozměry a změřenou délku. Pokud je výsledek tvorby nejistý, pokračujte v kontrole původního požadavku místo jeho opětovného vytvoření.
Ailoot Ultra · Video POST /v1/videos MiniMax-Hailuo-2.3-Fast
MiniMax-Hailuo-2.3-FastÚvod
MiniMax Hailuo 2.3 Fast animuje obrázek prvního snímku podle krátkého promptu popisujícího pohyb. Tento profil tvorby videa z obrázku zvolte pro produktový záběr, pózu postavy nebo snímek storyboardu.
- Přijímané vstupy
- Text · Obrázky
- Výsledky
- Video
Dostupné v Ailoot · vstupy a metody
Ailoot Ultra · Video POST /v1/videos
- Vstup
text,image- Výstup
video- Výstupní formát
- mp4
- Počet výstupů
- Až 1 výstup
| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity MiniMax-Hailuo-2.3-Fast | Výchozí— |
Poleprompt | Typstring | PožadavekPovinné | Hodnoty a limity Minimální délka: 1 Maximální délka: 199 Jednotka: znaky Unicode | Výchozí— |
Poleduration | Typinteger | PožadavekPovinné | Hodnoty a limity 6 Jednotka: sekundy | Výchozí— |
Poleresolution | Typstring | PožadavekPovinné | Hodnoty a limity 768P | Výchozí— |
Polefirst_frame_image | Typhttps_url | PožadavekPovinné | Hodnoty a limity Maximální počet bajtů souboru: 20 000 000 Typy MIME: image/png, image/jpeg Minimální rozměr: 300 Maximální rozměr: 4 096 Pouze čtverec: Ano | Výchozí— |
Kombinace vstupních materiálů
Obrázek na video · Povinné: prompt, first_frame_image
Parametry a životní cyklus metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt, duration, resolution, first_frame_image |
Parametrother_options | Kontraktfalse |
Parametrduration | Kontrakt6 |
Parametrresolution | Kontrakt768P |
Parametrprompt_max_characters | Kontrakt199 |
Parametrfirst_frame_image | Kontrakt{"type":"https_url","format":["png","jpeg"],"dimensions":"čtverec o straně 300..4096 pixelů","full_image_validation_before_send":true,"maximum_file_bytes":20000000} |
Parametrmaterial_types | Kontrakttext, image |
Parametradditional_properties | Kontraktfalse |
Aliasy metody: /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
Vytvořte pouze jednou a uložte vrácené ID.
Dotazujte se na původní stav; uchovejte každý dokončený soubor i jeho délku.
Tarify
Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.
- Rychlý režim
- Neuvedeno Při výběru rychlého režimu
- Režim flex
- Neuvedeno Při výběru režimu flex
- Maximální intenzita uvažování
- Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)
Sazby Ailoot
Ceny podle konfigurace
Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.
| Konfigurace | Tabulka sazeb | Nominální délka klipu, sekundy | Rozlišení | Účtovací jednotka | Poplatek |
|---|---|---|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Nominální délka klipu, sekundy— | Rozlišení— | Účtovací jednotka— | Poplatek Vstup · Vstupní tokeny — / 1K tokenů Výstup · Výstupní tokeny — / 1K tokenů Vstup · Čtení z mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina — / 1K tokenů |
| KonfiguraceUltra | Tabulka sazeb— | Nominální délka klipu, sekundy6 | Rozlišení768P | Účtovací jednotkaza výstupní klip o nominální délce 6s | Poplatek Výstup · výstupní klip s nominální délkou 6s $0.4 za výstupní klip o nominální délce 6s |
Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →
Podrobnosti referenčního tarifu
Referenční tabulky modelu nemění výběr metody, cenové nabídky ani poplatky. Skutečné poplatky používají sazby vybrané metody Ailoot.
MiniMax-Hailuo-2.3-Fast
Ceny podle konfigurace
| Konfigurace | Podmínky účtování | Poplatek |
|---|---|---|
| KonfiguraceMiniMax-Hailuo-2.3-Fast · Výchozí konfigurace | Podmínky účtováníVýchozí konfigurace | Poplatek Vstup · Vstup 0,00 US$ za volání Výstup · Výstup 0,40 US$ za volání |
MiniMax-Hailuo-2.3-Fast
Ceny podle konfigurace
| Konfigurace | Podmínky účtování | Poplatek |
|---|---|---|
| KonfiguraceMiniMax-Hailuo-2.3-Fast · Výchozí konfigurace | Podmínky účtováníVýchozí konfigurace | Poplatek Vstup · Vstup 0,00 US$ za volání Výstup · Výstup 0,80 US$ za volání |
MiniMax-Hailuo-2.3-Fast
Ceny podle konfigurace
| Konfigurace | Podmínky účtování | Poplatek |
|---|---|---|
| KonfiguraceMiniMax-Hailuo-2.3-Fast · Výchozí konfigurace | Podmínky účtováníVýchozí konfigurace | Poplatek Vstup · Vstup 0,00 US$ za volání Výstup · Výstup 0,80 US$ za volání |
Příklady požadavků
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
Přijímání a ukládání výsledků
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
Ověřit 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
Další načtení 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
Uchovejte všechny dokončené výsledky
Uložte každé dokončené video či vrácený soubor; stáhněte obsah každé skutečně vrácené URL souboru.
Pole data[] po dokončení obsahuje všechny podepsané URL obsahu spravovaného službou. Načtěte každou vrácenou URL nebo použijte koncový bod obsahu s parametrem index nastaveným na skutečný index výstupu. Neúspěšná původní úloha může vrátit charge_pending_check; kontrolujte tuto původní úlohu místo jejího opětovného vytváření.
Pokud je nutné ověřit původní odpověď
Načítejte existující původní úlohu; odeslání s neznámým výsledkem nikdy neopakujte.
Maximální počet výstupů: 1.
Pole odpovědi
| 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ýznamVrací se při status=unknown; skutečné původní veřejné ID operace videa |
Polerequest_id | Typstring | VýznamVolitelné při status=unknown; vrací se pouze tehdy, má-li původní úloha ID požadavku |
Chyby a další kroky
| Odpověď | Podmínka | Další krok |
|---|---|---|
Odpověď400 · invalid_request_error | PodmínkaNačtení nezpracovaného těla požadavku selže před zpracováním profilu videa | Další krokZachovejte vrácenou odpověď a opravte nečitelné tělo požadavku. |
Odpověď422 · price_unavailable | PodmínkaPřesný profil videa nelze zpracovat nebo pro celý zpracovaný profil není připravena přesná cenová karta | Další krokZachovejte odpověď; použijte celý přesný profil s povoleným přístupem a jeho zveřejněnou kartu. Tato větev se provádí před odesláním poskytovateli. |
Odpověď409 · video_not_ready | PodmínkaObsah původního výsledku zatím není dostupný | Další krokDotazujte se na původní vrácené ID a dodržujte Retry-After. |
Odpověďserver_error | PodmínkaVrácená odpověď uvádí, že operaci nebo výsledek je třeba zkontrolovat | Další krokUchovejte původní vrácené ID operace nebo úlohy, hlavičky požadavku a odpověď; pokračujte v podporovaném načítání údajů o této původní operaci. Požadavek na vytvoření znovu neodesílejte. |
Odpověď200 · video_result_unverified | PodmínkaStav původní úlohy Fast není znám; status=unknown a charge_pending_check=true | Další krokUchovejte skutečně vrácené id/operation_id a volitelné request_id; načítejte pouze původní úlohu. Nikdy znovu neodesílejte. |
Aliasy
Aliasy modelu
Ailoot Ultra MiniMax-Hailuo-2.3-Fast
Aliasy cest metod
/v1/videos/generations, /videos, /videos/generations
Související ID modelů
FAQ · Hailuo 2.3 Fast
- Jaké vstupy a výsledky jsou dostupné?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:text,image→video- Jaká pole požadavek používá?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:model,prompt,duration,resolution,first_frame_image- Jaké limity platí?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:prompt.maximum_length:199