MiniMax H3 Max Turbo

O MiniMax H3 Max Turbo gera vídeos curtos com texto ou quadros. Use o ID de modelo minimax-h3-max-turbo, guarde o ID da tarefa retornado e consulte a tarefa para obter o vídeo pronto. Esta página descreve a interface nativa com array content oferecida no SeedRouter.

IDs de modelo

Veja a página do modelo para os preços atuais.

Exemplo rápido

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-max-turbo",
    "content": [
      {"type": "text", "text": "A small sailboat glides across a calm turquoise bay at sunrise, seagulls in the distance, the sound of water and wind. No text, no logos."}
    ],
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9"
  }'

Endpoint

POST https://api.seedrouter.ai/v1/videos/generations

A resposta é uma tarefa ({"id": "task_...", "status": "processing"}), não o vídeo pronto. Consulte GET /v1/tasks/{task_id} para obter o resultado. Mantenha as chaves de API no código do lado do servidor.

Parâmetros

O esquema é estrito: campos desconhecidos são rejeitados, não ignorados. callback_url não está disponível; consulte a tarefa. extra é um objeto estrito opcional que contém apenas prompt_expansion_mode. Todos os campos rejeitam null; omita os campos opcionais em vez disso.

Itens de content

É obrigatório exatamente um item de texto não vazio. Uma imagem sozinha sem role é tratada como primeiro quadro. Aceita-se no máximo um primeiro e um último quadro; o último exige o primeiro. Imagens, vídeo e áudio de referência não são aceitos.

Modos

Os itens de content determinam o modo; nenhum campo mode é enviado.

{
  "model": "minimax-h3-max-turbo",
  "content": [
    {"type":"text","text":"Slowly move closer to the ceramic bowl. Keep the glaze and window lighting consistent."},
    {"type":"image_url","image_url":{"url":"https://example.com/first.jpg"},"role":"first_frame"},
    {"type":"image_url","image_url":{"url":"https://example.com/last.jpg"},"role":"last_frame"}
  ],
  "resolution": "480P",
  "duration": 5,
  "ratio": "adaptive",
  "extra": {"prompt_expansion_mode":"balanced"}
}

Quadros

Use URLs HTTP(S) públicas sem credenciais embutidas. Base64 e IDs mm_file:// não são aceitos. As imagens podem ser JPG, JPEG, PNG, WebP, HEIC ou HEIF, com até 30 MB cada, lados de 256–5760 pixels e largura/altura entre 0,4 e 2,5. A entrada é verificada antes da geração. Use composições e proporções compatíveis para dois quadros.

Filtro de conteúdo

content_filter é true, a menos que você o defina. Com o filtro ativado, a requisição, com seu texto e suas mídias, é verificada antes da geração. Uma requisição sinalizada falha com o código 60001 e não é cobrada. Defina content_filter como false para pular a verificação; o Playground do site sempre mantém o filtro ativado.

Fatores de custo

A seção de preços do modelo mostra as tarifas atuais. O Turbo tem uma cobrança: segundos de saída na resolução escolhida. O primeiro e o último quadro e a expansão do prompt não têm cobrança separada.

cost = reported output seconds × output-second rate for the resolution

A estimativa usa os segundos inteiros solicitados. A cobrança final usa os segundos de saída informados pela tarefa concluída, pela tarifa registrada para a requisição. Se não houver dados de uso válidos, usa-se a estimativa aceita. A duração do contêiner de mídia pode diferir ligeiramente dos segundos cobrados. Consulte as cobranças no histórico de uso da conta; respostas públicas de tarefas não incluem custos. Tarefas com falha não são cobradas.

Esquema de saída

O envio retorna a tarefa:

{"id": "task_...", "model": "minimax-h3-max-turbo", "status": "processing", "created_at": 1789689600}

Consultar a tarefa

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Consulte a cada 10–20 segundos até que status seja completed ou failed. Um tempo limite de rede durante a consulta não significa que a geração falhou: guarde o ID da tarefa e retome a verificação. Não crie outra tarefa para acompanhar o progresso.

Tarefa concluída

{
  "id": "task_...",
  "model": "minimax-h3-max-turbo",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689740,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4",
    "resolution": "768P",
    "ratio": "16:9",
    "duration": 5
  }
}

ratio é a proporção em que o clipe foi criado, incluindo a escolhida para adaptive. A tarefa contém resolução, proporção e duração reais quando informadas. O JSON acima ilustra o formato da resposta; não é um resultado de geração medido.

Erros

Requisições rejeitadas antes de uma tarefa ser criada retornam um erro HTTP com um objeto error e não são cobradas. Uma tarefa que falha depois de aceita retorna HTTP 200 quando consultada, com status: "failed" e um objeto error.

Veja o catálogo de erros comum para códigos, status HTTP e orientações de nova tentativa.

{
  "id": "task_...",
  "model": "minimax-h3-max-turbo",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "the request was blocked by content moderation"
  }
}

Se o próprio envio atingir o tempo limite, confira suas tarefas antes de enviar de novo: a primeira requisição pode ter sido aceita.

Dicas

• Descreva um assunto, uma ação, um movimento de câmera e uma iluminação por tomada.
• Use 480P para um rascunho e 768P para mais detalhes de saída. Cada nova geração é uma requisição paga separada.
• Forneça um primeiro quadro para definir a composição inicial; adicione o último somente se também fornecer o primeiro.
• Use extra.prompt_expansion_mode para escolher disabled, balanced ou quality; omitir mantém balanced.
• Revise o clipe inteiro e seu áudio antes de publicar. Um prompt não garante geometria de produto ou textos exatos.

Relacionados

• Playground e preços do MiniMax H3 Max Turbo
• Baixar OpenAPI
• Markdown para copiar

Escopo do contrato

Esta interface usa o formato de requisição da MiniMax com array content, IDs de modelo SeedRouter, tarefas assíncronas, imagens somente por URL e entrega de resultados hospedados. Callbacks e cancelamento não estão disponíveis. content_filter é uma verificação de entrada do SeedRouter, não um parâmetro da MiniMax.

A interface separada hospedada no fal tem campos e limites diferentes; seus controles 1080P, durações fracionárias, áudio alvo e referências ordenadas não se aplicam aqui. Esta interface não aceita controles de seed e marca d’água. Consulte o guia comparativo para essa distinção e as fontes relacionadas.