MiniMax: I2V 01 Director
I2V 01 Director animuje obrázek prvního snímku pomocí výslovných příkazů pohybu kamery v promptu. Spojte dodanou kompozici s řízenými pokyny truck, pan, push, tilt, zoom, tracking nebo statické kamery pro plánování krátkého záběru.
O modelu
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
I2V 01 Director je edice MiniMax pro převod obrázku na video s dokumentovanými příkazy kamery. Dodaný obrázek určuje první snímek a prompt řídí viditelnou akci i kameru. To je užitečné, pokud stávající kompozice potřebuje konkrétní přiblížení, odhalení, sledovací pohyb nebo řízený statický pohled namísto neurčené animace.
Připravte obrázek jako úvod zamýšleného záběru. U odhalení ukažte hlavní objekt a část prostředí, kterou má kamera odkrýt. U blízkého přiblížení začněte s dostatečným okolním prostorem, aby byla změna zarámování srozumitelná. Před začátkem pohybu zkontrolujte viditelnost důležitých rysů hlavního objektu, zvláště pokud musí tvar produktu nebo vzhled postavy zůstat rozpoznatelný.
Výrobce přijímá reference JPG, JPEG, PNG a WebP menší než 20 MB s kratší stranou větší než 300 pixelů a poměrem stran mezi 2:5 a 5:2. Dostupná URL obrázku nebo kódovaná obrazová data mohou v postupu výrobce určit první snímek. Uchovejte původní referenci, aby pozdější revize používala stejnou kompozici namísto znovu vytvořené přibližné podoby.
Prompt podporuje až 2 000 znaků a zahrnuje patnáct pojmenovaných příkazů kamery. Truck pohybuje kamerou vodorovně, pan mění její vodorovný směr pohledu, pedestal ji posouvá svisle a tilt mění její svislý směr pohledu. Push, pull a zoom nabízejí různé druhy přiblížení nebo oddálení; tracking, shake a statický záběr pokrývají jiné kamerové záměry. Při zadávání pohybu použijte dokumentovaný zápis příkazu.
Umístěte příkazy do hranatých závorek v části popisu, kde má pohyb nastat. Několik příkazů v jedné závorce požaduje současný pohyb, zatímco příkazy na následných místech popisují sekvenci. Výrobce doporučuje maximálně tři kombinované pohyby. Jednoduchý push směrem k hlavnímu objektu může sdělit detail jasněji než několik pohybů soutěžících o stejný krátký záběr.
Pohyb hlavního objektu popište odděleně od pohybu kamery. Člověk jdoucí ke dveřím a kamera sledující tohoto člověka jsou dva pokyny s různými vizuálními účinky. Určete požadovaný vztah, například zachování viditelnosti obličeje při přibližování nebo nehybnou kameru při průchodu hlavního objektu přes záběr. Určete konečnou kompozici, aby generovaná akce měla užitečný cíl.
Starší tabulka převodu obrázku na video od výrobce uvádí 720P jako výchozí hodnotu pro tuto edici a neuvádí desetisekundovou možnost. Automatická optimalizace promptu je ve výchozím stavu zapnutá a lze ji vypnout pro přesnější kontrolu písemného zadání. Při porovnávání záběrů uchovejte její nastavení se zdrojovým obrázkem a příkazy kamery, aby bylo změněné znění nebo interpretace viditelné v záznamu generování.
Zkontrolujte celý klip z hlediska požadované dráhy kamery, kontinuity hlavního objektu a zarámování důležitých detailů. Prohlédněte, zda push nebo pan odhaluje zamýšlené informace a zda konečný pohled ponechává dostatek prostoru pro další střihový krok. Uložte dokončené video s přesným promptem, zdrojovým obrázkem a nastavením. Při revizi změňte směr kamery, časování nebo akci hlavního objektu způsobující pozorovaný problém a porovnejte výsledek se stejným plánem záběru.
Ailoot Ultra · Tvorba videa POST /v1/videos minimaxi-i2v-01-director
minimaxi-i2v-01-directorÚvod
I2V 01 Director animuje obrázek prvního snímku pomocí výslovných příkazů pohybu kamery v promptu. Spojte dodanou kompozici s řízenými pokyny truck, pan, push, tilt, zoom, tracking nebo statické kamery pro plánování krátkého záběru.
- Přijímané vstupy
- Text · Obrázky
- Výsledky
- Video
Dostupné v Ailoot · vstupy a metody
Ailoot Ultra · Tvorba videa POST /v1/videos
- Vstup
text,image- Výstup
video
| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity minimaxi-i2v-01-director Podmínky: Použijte přesný identifikátor modelu Ailoot. | Výchozí— |
Poleprompt | Typstring | PožadavekPovinné | Hodnoty a limity Podmínky: Popište scénu a pohyb. | Výchozí— |
Poleend_image | Typstring | PožadavekVolitelné | Hodnoty a limity Podmínky: Koncový snímek se uplatní pouze v podporovaném režimu obrazového vstupu. | Výchozí— |
Poleimage | Typstring or array<string> | PožadavekVolitelné | Hodnoty a limity Podmínky: Použijte skutečnou veřejně dostupnou URL obrázku nebo řetězec obrázku v base64; žádný maximální počet obrázků se zde neuvádí. | Výchozí— |
Parametry a životní cyklus metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt |
Parametroptional | Kontraktend_image, image |
Parametrmaterial_types | Kontrakttext, image |
Parametrconditions | KontraktPoužijte přesný identifikátor modelu Ailoot., Popište scénu a pohyb., Koncový snímek se uplatní pouze v podporovaném režimu obrazového vstupu., Použijte skutečnou veřejně dostupnou URL obrázku nebo řetězec obrázku v base64; žádný maximální počet obrázků se zde neuvádí. |
Aliasy metody: /v1/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/media/assets
GET /v1/media/assets/{asset_id}
Tarify
Jak se vypočítá konečný poplatek
Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.
Ú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)
Odhadované sazby pro srovnání
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 | Předpokládané množství | Množství pro účtování | Poplatek |
|---|---|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Předpokládané množství— | Množství pro účtování— | Poplatek Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů |
| KonfiguraceZa požadavek | Tabulka sazeb— | Předpokládané množství— | Množství pro účtováníjeden požadavek | Poplatek Vstup · Odhad pouze pro srovnání $1 za požadavek |
| KonfiguraceOdhadovaná cena generování | Tabulka sazeb— | Předpokládané množstvíodhad pro jedno generování | Množství pro účtování— | Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $1 odhad před generováním Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování. |
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í →
Příklady požadavků
Ailoot Ultra · Tvorba videa
# Replace YOUR_ACCESSIBLE_IMAGE_URL with your actual reachable reference image URL.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "minimaxi-i2v-01-director",
"prompt": "A cat is walking on grass.",
"image": "YOUR_ACCESSIBLE_IMAGE_URL"
}
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
Přijímání a ukládání výsledků
Ailoot Ultra · Tvorba videa
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}
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.
Uchovejte celou odpověď a hlavičky, původní identifikátory, každý skutečný výstup a všechna pole využití a účtování. Uložte každý jedinečný soubor spravovaný službou a zachovejte každou roli, která na něj odkazuje.
Pokud je nutné ověřit původní odpověď
Uchovejte vrácené veřejné id úlohy nebo operace a všechny hlavičky. Načítejte pouze původní úlohu; unknown ani result_pending_check neopravňují k dalšímu vytvoření.
Pole odpovědi
| Pole | Typ |
|---|---|
Poleid | Typstring |
Polepolling_url | Typstring |
Poleprovider_task_id | Typstring |
Poletask_id | Typstring |
Polestatus | Typstring |
Polevideo_url | Typstring |
Aliasy
Aliasy modelu
Ailoot Ultra minimaxi-i2v-01-director
Aliasy cest metod
/v1/videos/generations
Související ID modelů
FAQ · MiniMax: I2V 01 Director
- Jaké vstupy a výsledky jsou dostupné?
POST /v1/videos·minimaxi-i2v-01-director:text,image→video- Jaká pole požadavek používá?
POST /v1/videos·minimaxi-i2v-01-director:model,prompt,end_image,image