MiniMax: I2V 01 Director
I2V 01 Director animuje obrázok prvej snímky pomocou explicitných príkazov pohybu kamery v prompte. Dodanú kompozíciu spojte s pokynmi truck, pan, push, tilt, zoom, tracking alebo statickou kamerou a naplánujte krátky záber.
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.
I2V 01 Director je obrazovo-videová edícia MiniMax s dokumentovanými príkazmi kamery. Dodaný obrázok určuje prvú snímku a prompt usmerňuje viditeľný dej aj kameru. To je užitočné, keď existujúca kompozícia potrebuje konkrétne priblíženie, odhalenie, sledovací pohyb alebo riadený statický pohľad namiesto neurčenej animácie.
Obrázok pripravte ako začiatok zamýšľaného záberu. Pri odhalení ukážte subjekt a časť prostredia, ktorú má kamera odkryť. Pri tesnom priblížení začnite s dostatkom okolitého priestoru, aby bola zmena kompozície záberu zrozumiteľná. Pred začiatkom pohybu skontrolujte viditeľnosť dôležitých čŕt subjektu, najmä keď musí zostať rozpoznateľný tvar produktu alebo vzhľad postavy.
Výrobca prijíma referencie JPG, JPEG, PNG a WebP menšie než 20 MB, s kratšou stranou väčšou než 300 pixelov a pomerom strán od 2:5 do 5:2. V postupe výrobcu môže prvú snímku určovať dostupná URL obrázka alebo zakódované obrazové dáta. Uchovajte pôvodnú referenciu, aby neskoršia úprava použila rovnakú kompozíciu namiesto jej nanovo vytvorenej približnej podoby.
Prompt podporuje najviac 2 000 znakov a obsahuje pätnásť pomenovaných príkazov kamery. Truck posúva kameru vodorovne, pan mení jej vodorovný smer, pedestal ju posúva zvislo a tilt mení jej zvislý smer. Push, pull a zoom ponúkajú rôzne druhy priblíženia alebo vzdialenia; tracking, shake a statický záber pokrývajú ďalšie zámery kamery. Pri určovaní pohybu používajte dokumentovaný zápis príkazu.
Príkazy vložte do hranatých zátvoriek na miesto opisu, kde má pohyb nastať. Viaceré príkazy v jednej zátvorke požadujú súčasný pohyb, zatiaľ čo príkazy na po sebe nasledujúcich miestach opisujú sekvenciu. Výrobca odporúča kombinovať najviac tri pohyby. Jednoduchý push smerom k subjektu môže detail sprostredkovať jasnejšie než viacero pohybov súťažiacich o ten istý krátky záber.
Pohyb subjektu opisujte oddelene od pohybu kamery. Človek kráčajúci k dverám a kamera sledujúca tohto človeka sú dva pokyny s odlišnými vizuálnymi účinkami. Určite ich požadovaný vzťah, napríklad zachovanie viditeľnej tváre počas priblíženia alebo nehybnú kameru, kým subjekt prechádza záberom. Určite konečnú kompozíciu, aby mal generovaný dej použiteľný cieľ.
Staršia tabuľka výrobcu pre generovanie z obrázka uvádza pre túto edíciu predvolené rozlíšenie 720P a neuvádza desaťsekundovú možnosť. Automatická optimalizácia promptu je predvolene zapnutá a možno ju vypnúť pre presnejšie riadenie písomného zadania. Pri porovnávaní záberov uchovajte jej nastavenie so zdrojovým obrázkom a pokynmi kamery, aby bola zmena formulácie alebo interpretácie viditeľná v zázname generovania.
Celý klip skontrolujte z hľadiska požadovanej dráhy kamery, kontinuity subjektu a kompozície dôležitých detailov. Overte, či push alebo pan odhaľuje zamýšľané informácie a či záverečný pohľad ponecháva dostatok priestoru na ďalší krok strihu. Hotové video uložte s presným promptom, zdrojovým obrázkom a nastaveniami. Pri úprave zmeňte smer kamery, načasovanie alebo dej subjektu, ktoré spôsobili pozorovaný problém, a výsledok porovnajte s rovnakým plánom záberu.
Ailoot Ultra · Generovanie videa POST /v1/videos minimaxi-i2v-01-director
minimaxi-i2v-01-directorÚvod
I2V 01 Director animuje obrázok prvej snímky pomocou explicitných príkazov pohybu kamery v prompte. Dodanú kompozíciu spojte s pokynmi truck, pan, push, tilt, zoom, tracking alebo statickou kamerou a naplánujte krátky záber.
- Povolené vstupy
- Text · Obrázky
- Výsledky
- Video
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · Generovanie videa POST /v1/videos
- Vstup
text,image- Výstup
video
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity minimaxi-i2v-01-director Podmienky: Použite presný volič modelu Ailoot. | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity Podmienky: Opíšte scénu a pohyb. | Predvolené— |
Poleend_image | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: Koncová snímka sa používa iba v podporovanom režime obrazového vstupu. | Predvolené— |
Poleimage | Typstring or array<string> | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: Použite skutočnú verejne dostupnú URL obrázka alebo reťazec obrázka v base64; neuvádza sa tu žiadny maximálny počet obrázkov. | Predvolené— |
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, prompt |
Parameteroptional | Špecifikáciaend_image, image |
Parametermaterial_types | Špecifikáciatext, image |
Parameterconditions | ŠpecifikáciaPoužite presný volič modelu Ailoot., Opíšte scénu a pohyb., Koncová snímka sa používa iba v podporovanom režime obrazového vstupu., Použite skutočnú verejne dostupnú URL obrázka alebo reťazec obrázka v base64; neuvádza sa tu žiadny maximálny počet obrázkov. |
Aliasy metódy: /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}
Cenník
Ako sa vypočíta konečný poplatok
Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.
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)
Odhadované sadzby na porovnanie
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 | Odhadované množstvo | Účtovacie množstvo | Poplatok |
|---|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Účtovacie množstvo— | Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov |
| KonfiguráciaZa požiadavku | Sadzobník— | Odhadované množstvo— | Účtovacie množstvojedna požiadavka | Poplatok Vstup · Odhad iba na porovnanie $1 za požiadavku |
| KonfiguráciaOdhadované náklady na generovanie | Sadzobník— | Odhadované množstvoodhad pre jedno generovanie | Účtovacie množstvo— | Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $1 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie. |
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 →
Príklady požiadaviek
Ailoot Ultra · Generovanie 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
Prijať a uložiť výsledky
Ailoot Ultra · Generovanie 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}
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.
Zachovajte celú odpoveď a hlavičky, pôvodné identifikátory, každý skutočný výstup a všetky polia spotreby a účtovania. Uložte každý jedinečný súbor vo vašom vlastníctve a zachovajte každú rolu, ktorá naň odkazuje.
Ak treba overiť pôvodnú odpoveď
Zachovajte vrátené verejné id úlohy alebo operácie a všetky hlavičky. Načítavajte iba pôvodnú úlohu; unknown ani result_pending_check neoprávňujú na ďalšie vytvorenie.
Polia odpovede
| Pole | Typ |
|---|---|
Poleid | Typstring |
Polepolling_url | Typstring |
Poleprovider_task_id | Typstring |
Poletask_id | Typstring |
Polestatus | Typstring |
Polevideo_url | Typstring |
Aliasy
Aliasy modelov
Ailoot Ultra minimaxi-i2v-01-director
Aliasy ciest metód
/v1/videos/generations
Súvisiace ID na volanie
FAQ · MiniMax: I2V 01 Director
- Aké vstupy a výsledky sú dostupné?
POST /v1/videos·minimaxi-i2v-01-director:text,image→video- Aké polia používa požiadavka?
POST /v1/videos·minimaxi-i2v-01-director:model,prompt,end_image,image