MiniMax: S2V 01

S2V 01 usa um retrato de referência para orientar uma personagem num vídeo recém-gerado. Forneça uma imagem clara do rosto e descreva a cena e a ação; o processo do fabricante baseado num sujeito de referência trata a imagem como referência da personagem.

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

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.

S2V 01 é o modelo de vídeo da MiniMax baseado num sujeito de referência. A imagem fornecida orienta a aparência de uma personagem, enquanto o texto descreve a cena e a ação do vídeo. O tipo de referência documentado é o rosto de uma pessoa, pelo que deve preparar o retrato como guia da identidade visual da personagem que pretende colocar na sequência gerada.

Escolha uma referência em que o rosto pretendido seja claro e fácil de distinguir. Evite esconder características distintivas atrás de uma mão, de um acessório grande ou de um recorte acentuado quando essas características forem importantes para o resultado. Mantenha o retrato consistente entre planos relacionados, para que a fonte usada para orientar a personagem permaneça conhecida. A referência fornece informação de aparência; utilize o prompt para explicar a cena que a personagem deve representar.

O esquema do fabricante para sujeito de referência aceita uma imagem no array de imagens de referência. Os formatos suportados são JPG, JPEG, PNG e WebP, com tamanho de ficheiro inferior a 20 MB. O lado mais curto deve exceder 300 píxeis e a proporção deve estar entre 2:5 e 5:2. Conserve o ficheiro de imagem exato com o registo de geração, em vez de substituir o retrato por outro numa comparação posterior.

Descreva uma cena com um papel claro para a pessoa de referência. Por exemplo, a personagem pode entrar numa oficina tranquila, olhar para um objeto na mesa e parar ao lado dele. Especifique a ação, o cenário e o ponto de vista importantes para o plano terminado. Se o rosto precisar de permanecer legível, planeie o enquadramento e o movimento em torno desse requisito.

A descrição textual suporta até 2 000 caracteres. Utilize-os para instruções concretas: o que a personagem faz, o que a rodeia e o que a vista final deve mostrar. Descreva vestuário ou detalhes da cena quando forem importantes para a história e examine depois como o vídeo gerado os combina com a referência de identidade fornecida. Mantenha o papel da referência distinto de um pedido para reproduzir todo o fundo do retrato como fotograma inicial.

A otimização automática do prompt é documentada e está ativada por predefinição. Pode ser desativada quando for necessário um controlo mais próximo da descrição escrita. Preserve essa escolha com o texto e o retrato ao comparar cenas diferentes. Para investigar um problema de semelhança, mantenha a descrição da cena constante ao comparar uma referência melhorada; para investigar a ação, mantenha a referência constante ao rever a descrição do movimento.

O processo do fabricante devolve um identificador da tarefa antes de o vídeo estar concluído. Conserve esse identificador original ao longo das etapas de estado e resultado e guarde o vídeo concluído para inspeção e edição. Mantenha o retrato, o prompt e o vídeo resultante como um registo, para que um plano posterior possa ser comparado com os materiais reais que orientaram o resultado anterior.

Examine a personagem durante toda a sequência, incluindo rotações, gestos e alterações do enquadramento. Verifique a consistência facial, a legibilidade da ação pretendida e a relação entre a personagem e os objetos da cena. Selecione o vídeo que melhor serve a finalidade do plano e identifique qualquer discrepância concreta antes de rever a entrada. Um processo com uma personagem recorrente beneficia do exame de vários planos terminados lado a lado, usando o mesmo retrato de referência e um registo claro de cada descrição da cena.

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

minimaxi-s2v-01

MiniMax /minimaxi-s2v-01

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-s2v-01 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.4 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.4 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-s2v-01",
  "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-s2v-01

Aliases dos caminhos dos métodos

/v1/videos/generations

IDs de chamada relacionados

minimaxi-s2v-01

FAQ · MiniMax: S2V 01

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

MiniMax: S2V 01

MiniMax: S2V 01

Introdução

Disponível no Ailoot · entradas e métodos

Tarifários

Cálculo do custo final

Tarifas estimadas para comparação

Preços por configuração

Exemplos de pedidos

Ailoot Ultra · Vídeo

Receber e guardar os resultados

Ailoot Ultra · Vídeo

Guardar todos os resultados concluídos

Se for necessário verificar a resposta original

Aliases

Aliases do modelo

Aliases dos caminhos dos métodos

IDs de chamada relacionados

A empresa e a sua carteira de projetos

Compre tokens com desconto.

Ligue a API ao produto que vende.