MiniMax: I2V 01 Director

I2V 01 Director anima uma imagem do primeiro fotograma com comandos explícitos de movimento de câmara no prompt. Combine a composição fornecida com instruções dirigidas de truck, pan, push, tilt, zoom, tracking ou câmara estática para planear um breve plano.

Ailoot Ultra · Vídeo POST /v1/videos minimaxi-i2v-01-director

Sobre o modelo

Esta descrição apresenta as capacidades do modelo. As entradas, saídas e opções disponíveis no Ailoot para o método selecionado estão indicadas abaixo.

I2V 01 Director é a edição de imagem para vídeo da MiniMax com comandos de câmara documentados. Uma imagem fornecida estabelece o primeiro fotograma e o prompt dirige tanto a ação visível como a câmara. Isto é útil quando uma composição existente precisa de uma aproximação, revelação, movimento de acompanhamento ou vista estática controlada específicos, em vez de uma animação não especificada.

Prepare a imagem como abertura do plano pretendido. Para uma revelação, mostre o sujeito e a parte do ambiente que a câmara deve expor. Para uma aproximação a curta distância, comece com espaço envolvente suficiente para tornar legível a alteração do enquadramento. Verifique se as características importantes do sujeito são visíveis antes de o movimento começar, sobretudo quando a forma de um produto ou a aparência de uma personagem devem permanecer reconhecíveis.

O fabricante aceita referências JPG, JPEG, PNG e WebP inferiores a 20 MB, com o lado curto superior a 300 píxeis e uma proporção entre 2:5 e 5:2. Um URL de imagem acessível ou dados de imagem codificados podem identificar o primeiro fotograma no processo do fabricante. Conserve a referência original, para que uma revisão posterior use a mesma composição em vez de uma aproximação recriada.

O prompt suporta até 2 000 caracteres e inclui quinze comandos de câmara nomeados. Truck move a câmara horizontalmente, pan altera a sua direção horizontal, pedestal move-a verticalmente e tilt altera a sua direção vertical. Push, pull e zoom oferecem diferentes tipos de aproximação ou afastamento; tracking, shake e um plano estático cobrem outras intenções de câmara. Utilize a grafia documentada dos comandos ao especificar um movimento.

Coloque comandos entre parênteses retos na parte da descrição em que o movimento deve ocorrer. Vários comandos num par de parênteses pedem movimento simultâneo, enquanto comandos em pontos sucessivos descrevem uma sequência. O fabricante recomenda um máximo de três movimentos combinados. Um simples push em direção a um sujeito pode comunicar um detalhe com mais clareza do que vários movimentos a competir no mesmo breve plano.

Descreva o movimento do sujeito separadamente do movimento da câmara. Uma pessoa a caminhar para uma porta e uma câmara a acompanhar essa pessoa são duas instruções com efeitos visuais diferentes. Indique a relação pretendida entre elas, como manter o rosto visível durante a aproximação ou deixar a câmara imóvel enquanto o sujeito atravessa o enquadramento. Identifique a composição final, para que a ação gerada tenha um destino útil.

A tabela anterior do fabricante de imagem para vídeo indica 720P como predefinição para esta edição e não indica uma opção de dez segundos. A otimização automática do prompt está ativada por predefinição e pode ser desativada para um controlo mais próximo da descrição escrita. Conserve a sua definição com a imagem de origem e as instruções de câmara ao comparar planos, para que uma alteração de formulação ou interpretação fique visível no registo de geração.

Examine o vídeo completo quanto ao percurso de câmara pedido, à continuidade do sujeito e ao enquadramento dos detalhes importantes. Verifique se um push ou pan revela a informação pretendida e se a vista final deixa espaço suficiente para a etapa de edição seguinte. Guarde o vídeo terminado com o prompt exato, a imagem de origem e as definições. Para uma revisão, altere a direção da câmara, os tempos ou a ação do sujeito que causaram o problema observado e compare o resultado com o mesmo plano de filmagem.

Ailoot Ultra · Vídeo POST /v1/videos minimaxi-i2v-01-director

minimaxi-i2v-01-director

MiniMax /minimaxi-i2v-01-director

Introdução

Entradas aceites: Texto · Imagens
Resultados: Vídeo

Disponível no Ailoot · entradas e métodos

Ailoot Ultra · Vídeo POST /v1/videos

Entrada: text, image
Saída: video

Campo	Tipo	Requisito	Valores e limites	Predefinição
Campo`model`	Tipo`string`	RequisitoObrigatório	Valores e limites minimaxi-i2v-01-director Condições: Utilize o seletor exato de modelos da Ailoot.	Predefinição—
Campo`prompt`	Tipo`string`	RequisitoObrigatório	Valores e limites Condições: Descreva a cena e o movimento.	Predefinição—
Campo`end_image`	Tipo`string`	RequisitoOpcional	Valores e limites Condições: Um fotograma final aplica-se apenas num modo suportado de entrada de imagem.	Predefinição—
Campo`image`	Tipo`string or array<string>`	RequisitoOpcional	Valores e limites Condições: Utilize um URL real de imagem acessível publicamente ou uma cadeia de imagem em base64; não é indicado aqui qualquer número máximo de imagens.	Predefinição—

Parâmetros e ciclo de vida do método

Parâmetro	Contrato
Parâmetro`content_type`	Contratoapplication/json
Parâmetro`required`	Contratomodel, prompt
Parâmetro`optional`	Contratoend_image, image
Parâmetro`material_types`	Contratotext, image
Parâmetro`conditions`	ContratoUtilize o seletor exato de modelos da Ailoot., Descreva a cena e o movimento., Um fotograma final aplica-se apenas num modo suportado de entrada de imagem., Utilize um URL real de imagem acessível publicamente ou uma cadeia de imagem em base64; não é indicado aqui qualquer número máximo de imagens.

Aliases do método: /v1/videos/generations

Ciclo de vida: 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}

Tarifários

Cálculo do custo final

As tarifas apresentadas permitem estimar o custo antes da geração. O montante final cobrado é calculado a partir do custo registado para a geração original. A duração medida do resultado e as quantidades previstas não correspondem à quantidade final faturável.

As referências tarifárias não acrescentam opções ao pedido. Os parâmetros suportados constam do método selecionado.

Modo rápido: Não especificado Quando o modo rápido está selecionado
Modo flex: Não especificado Quando o modo flex está selecionado
Esforço máximo de raciocínio: Não especificado Quando o esforço máximo de raciocínio usa o ajuste predefinido (default)

Tarifas estimadas para comparação

Preços por configuração

Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas.

Configuração	Tabela de tarifas	Quantidade prevista	Quantidade faturada	Custo
ConfiguraçãoTarifas base por token	Tabela de tarifasTarifa base	Quantidade prevista—	Quantidade faturada—	Custo Entrada · Tokens de entrada · Estimativa apenas para comparação — / 1K tokens Saída · Tokens de saída · Estimativa apenas para comparação — / 1K tokens Entrada · Leitura da cache · Estimativa apenas para comparação — / 1K tokens Entrada · Escrita na cache · Estimativa apenas para comparação — / 1K tokens Entrada · Escrita na cache, 1 hora · Estimativa apenas para comparação — / 1K tokens
ConfiguraçãoPor pedido	Tabela de tarifas—	Quantidade prevista—	Quantidade faturadaum pedido	Custo Entrada · Estimativa apenas para comparação $1 por pedido
ConfiguraçãoCusto estimado de geração	Tabela de tarifas—	Quantidade previstaestimativa para uma geração	Quantidade faturada—	Custo Saída · Custo estimado de geração · Estimativa apenas para comparação $1 estimativa antes da geração Esta estimativa não é um encargo adicional nem uma tarifa fixa para a geração concluída.

O Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. Como funcionam a reserva e a liquidação →

Exemplos de pedidos

Ailoot Ultra · Vídeo

curl · crie uma única vez e guarde o comprovativoConsulte a tarefa originalGuarde cada recurso concluído que lhe pertence

# 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

Receber e guardar os resultados

Ailoot Ultra · Vídeo

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}

Guardar todos os resultados concluídos

Guarde cada vídeo concluído ou ficheiro devolvido; obtenha cada URL de recurso efetivamente devolvido.

Conserve a resposta completa e os cabeçalhos, os identificadores originais, todos os resultados reais e todos os campos de utilização/contabilidade. Guarde cada recurso único pertencente ao utilizador e conserve todas as funções que apontam para ele.

Se for necessário verificar a resposta original

Conserve o id público de tarefa ou operação devolvido e todos os cabeçalhos. Consulte apenas a tarefa original; unknown ou result_pending_check não autoriza uma nova criação.

Campos da resposta

Campo	Tipo
Campo`id`	Tipostring
Campo`polling_url`	Tipostring
Campo`provider_task_id`	Tipostring
Campo`task_id`	Tipostring
Campo`status`	Tipostring
Campo`video_url`	Tipostring

Aliases

Aliases do modelo

Ailoot Ultra minimaxi-i2v-01-director

Aliases dos caminhos dos métodos

/v1/videos/generations

IDs de chamada relacionados

minimaxi-i2v-01-director

FAQ · MiniMax: I2V 01 Director

Que entradas e resultados estão disponíveis?: POST /v1/videos · minimaxi-i2v-01-director: text, image → video
Que campos utiliza o pedido?: POST /v1/videos · minimaxi-i2v-01-director: model, prompt, end_image, image

MiniMax: I2V 01 Director