MiniMax: I2V 01 Director
I2V 01 Director anima un’immagine del primo fotogramma con comandi espliciti di movimento della camera nel prompt. Combinate la composizione fornita con istruzioni mirate truck, pan, push, tilt, zoom, tracking o camera statica per pianificare una breve inquadratura.
Informazioni sul modello
Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.
I2V 01 Director è l’edizione da immagine a video di MiniMax con comandi della camera documentati. Un’immagine fornita stabilisce il primo fotogramma e il prompt dirige sia l’azione visibile sia la camera. È utile quando una composizione esistente richiede un particolare avvicinamento, una rivelazione, un movimento di inseguimento o una vista statica controllata, anziché un’animazione non specificata.
Preparate l’immagine come apertura dell’inquadratura desiderata. Per una rivelazione, mostrate il soggetto e la parte dell’ambiente che la camera deve esporre. Per un avvicinamento ravvicinato, iniziate con spazio circostante sufficiente a rendere leggibile il cambiamento di inquadratura. Verificate che le caratteristiche importanti del soggetto siano visibili prima dell’inizio del movimento, soprattutto quando la forma di un prodotto o l’aspetto di un personaggio devono restare riconoscibili.
Il produttore accetta riferimenti JPG, JPEG, PNG e WebP inferiori a 20 MB, con il lato corto superiore a 300 pixel e un rapporto d’aspetto compreso tra 2:5 e 5:2. Un URL dell’immagine accessibile o dati immagine codificati possono identificare il primo fotogramma nel processo del produttore. Conservate il riferimento originale, affinché una revisione successiva usi la stessa composizione, anziché un’approssimazione ricreata.
Il prompt supporta fino a 2 000 caratteri e comprende quindici comandi della camera nominati. Truck sposta la camera orizzontalmente, pan ne cambia la direzione orizzontale, pedestal la sposta verticalmente e tilt ne cambia la direzione verticale. Push, pull e zoom offrono diversi tipi di avvicinamento o allontanamento; tracking, shake e un’inquadratura statica coprono altre intenzioni della camera. Usate la grafia documentata dei comandi quando specificate un movimento.
Inserite i comandi tra parentesi quadre nella parte della descrizione in cui il movimento deve avvenire. Più comandi in una coppia di parentesi richiedono movimento simultaneo, mentre comandi in punti successivi descrivono una sequenza. Il produttore raccomanda un massimo di tre movimenti combinati. Un semplice push verso un soggetto può comunicare un dettaglio più chiaramente di più movimenti in competizione nella stessa breve inquadratura.
Descrivete il movimento del soggetto separatamente da quello della camera. Una persona che cammina verso una porta e una camera che la segue sono due istruzioni con effetti visivi diversi. Indicate la relazione desiderata tra esse, come mantenere visibile il viso durante l’avvicinamento o tenere ferma la camera mentre il soggetto attraversa l’inquadratura. Identificate la composizione finale, affinché l’azione generata abbia una destinazione utile.
La tabella precedente del produttore per la generazione da immagine a video indica 720P come valore predefinito per questa edizione e non elenca un’opzione di dieci secondi. L’ottimizzazione automatica del prompt è attivata per impostazione predefinita e può essere disattivata per un controllo più preciso della descrizione scritta. Conservatene l’impostazione insieme all’immagine sorgente e alle istruzioni della camera quando confrontate inquadrature, affinché una diversa formulazione o interpretazione sia visibile nel record di generazione.
Esaminate il filmato completo per il percorso della camera richiesto, la continuità del soggetto e l’inquadratura dei dettagli importanti. Verificate se un push o un pan riveli le informazioni desiderate e se la vista finale lasci spazio sufficiente alla fase successiva del montaggio. Salvate il video finito con il prompt esatto, l’immagine sorgente e le impostazioni. Per una revisione, modificate la direzione della camera, i tempi o l’azione del soggetto che hanno causato il problema osservato e confrontate il risultato con lo stesso piano dell’inquadratura.
Ailoot Ultra · Generazione video POST /v1/videos minimaxi-i2v-01-director
minimaxi-i2v-01-directorIntroduzione
I2V 01 Director anima un’immagine del primo fotogramma con comandi espliciti di movimento della camera nel prompt. Combinate la composizione fornita con istruzioni mirate truck, pan, push, tilt, zoom, tracking o camera statica per pianificare una breve inquadratura.
- Input accettati
- Testo · Immagini
- Risultati
- Video
Disponibile in Ailoot · input e metodi
Ailoot Ultra · Generazione video POST /v1/videos
- Tipi di input
text,image- Tipi di output
video
| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti minimaxi-i2v-01-director Condizioni: Usa il selettore esatto del modello Ailoot. | Predefinito— |
Campoprompt | Tipostring | RequisitoObbligatorio | Valori e limiti Condizioni: Descrivi la scena e il movimento. | Predefinito— |
Campoend_image | Tipostring | RequisitoFacoltativo | Valori e limiti Condizioni: Un fotogramma finale si applica solo in una modalità di input con immagini supportata. | Predefinito— |
Campoimage | Tipostring or array<string> | RequisitoFacoltativo | Valori e limiti Condizioni: Usa un URL reale di un'immagine raggiungibile pubblicamente oppure una stringa di immagine in base64; qui non viene dichiarato un numero massimo di immagini. | Predefinito— |
Parametri e ciclo di vita del metodo
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, prompt |
Parametrooptional | Contrattoend_image, image |
Parametromaterial_types | Contrattotext, image |
Parametroconditions | ContrattoUsa il selettore esatto del modello Ailoot., Descrivi la scena e il movimento., Un fotogramma finale si applica solo in una modalità di input con immagini supportata., Usa un URL reale di un'immagine raggiungibile pubblicamente oppure una stringa di immagine in base64; qui non viene dichiarato un numero massimo di immagini. |
Alias del metodo: /v1/videos/generations
Ciclo di vita: 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}
Tariffe
Calcolo del costo finale
Le tariffe visualizzate stimano il costo prima della generazione. L'addebito finale viene calcolato in base al costo registrato per la generazione originale. La durata misurata dell'output e le quantità previste non costituiscono la quantità finale fatturabile.
Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.
- Modalità rapida
- Non specificato Quando è selezionata la modalità rapida
- Modalità flex
- Non specificato Quando è selezionata la modalità flex
- Sforzo massimo di ragionamento
- Non specificato Quando lo sforzo massimo di ragionamento usa l'adeguamento predefinito (default)
Tariffe stimate per il confronto
Prezzi per configurazione
Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.
| Configurazione | Listino delle tariffe | Quantità prevista | Quantità fatturata | Costo |
|---|---|---|---|---|
| ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Quantità prevista— | Quantità fatturata— | Costo Input · Token in input · Stima solo a fini di confronto — / 1K token Output · Token in output · Stima solo a fini di confronto — / 1K token Input · Lettura dalla cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache, 1 ora · Stima solo a fini di confronto — / 1K token |
| ConfigurazionePer richiesta | Listino delle tariffe— | Quantità prevista— | Quantità fatturatauna richiesta | Costo Input · Stima solo a fini di confronto $1 per richiesta |
| ConfigurazioneCosto stimato della generazione | Listino delle tariffe— | Quantità previstastima per una generazione | Quantità fatturata— | Costo Output · Costo di generazione stimato · Stima solo a fini di confronto $1 stima prima della generazione Questa stima non è un addebito aggiuntivo né una tariffa fissa per la generazione completata. |
Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →
Esempi di richieste
Ailoot Ultra · Generazione video
# 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
Ricevi e salva i risultati
Ailoot Ultra · Generazione video
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}
Conserva tutti i risultati completati
Salva ogni video completato o file restituito; recupera ogni URL di risorsa effettivamente restituito.
Conserva la risposta completa e le intestazioni, gli identificatori originali, ogni risultato effettivo e tutti i campi di utilizzo e contabilizzazione. Salva ogni risorsa univoca di tua proprietà e conserva ogni ruolo che vi fa riferimento.
Se occorre verificare la risposta originale
Conserva l'id pubblico dell'attività o dell'operazione restituito e tutte le intestazioni. Consulta solo l'attività originale; unknown o result_pending_check non autorizza un'altra creazione.
Campi della risposta
| Campo | Tipo |
|---|---|
Campoid | Tipostring |
Campopolling_url | Tipostring |
Campoprovider_task_id | Tipostring |
Campotask_id | Tipostring |
Campostatus | Tipostring |
Campovideo_url | Tipostring |
Alias
Alias del modello
Ailoot Ultra minimaxi-i2v-01-director
Alias dei percorsi dei metodi
/v1/videos/generations
ID di chiamata correlati
FAQ · MiniMax: I2V 01 Director
- Quali input e risultati sono disponibili?
POST /v1/videos·minimaxi-i2v-01-director:text,image→video- Quali campi usa la richiesta?
POST /v1/videos·minimaxi-i2v-01-director:model,prompt,end_image,image