MiniMax H3 Max

O MiniMax H3 Max é a variante de geração mais rápida do MiniMax H3. Uma requisição cria imagem e som juntos: um clipe de 5 a 15 segundos em 480P ou 768P com diálogo, ambiência e efeitos próprios. O corpo da requisição segue o formato oficial da MiniMax com o ID de modelo minimax-h3-max. Envie a requisição, guarde o ID da tarefa retornado e obtenha o vídeo pronto pela tarefa. Quadros e referências são enviados como URLs.

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",
    "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

Uma única imagem sem role é o primeiro quadro. Com mais de uma imagem, toda imagem precisa de um role.

Modos

Os itens em content definem o modo; não existe um campo de modo.

Quadros e referências não podem ser combinados em uma requisição. A documentação oficial lista a entrada só com o último quadro, mas também contém a exigência conflitante de associá-lo a um primeiro quadro. Esse caso não foi verificado no SeedRouter. Use ambos os quadros quando precisar de uma imagem final.

{
  "model": "minimax-h3-max",
  "content": [
    {"type": "text", "text": "The person in the photo speaks to camera: Follow the wind. Voice follows the reference audio."},
    {"type": "image_url", "image_url": {"url": "https://example.com/person.jpg"}, "role": "reference_image"},
    {"type": "audio_url", "audio_url": {"url": "https://example.com/voice.mp3"}, "role": "reference_audio"}
  ],
  "resolution": "768P",
  "duration": 6
}

Entradas de mídia

Cada item de imagem, vídeo e áudio é uma URL HTTP(S) pública. URIs de dados em base64 e IDs mm_file:// não são aceitos: envie o arquivo para o seu próprio armazenamento e passe a URL dele.

Os vídeos de referência são medidos quando a requisição é aceita; um vídeo cuja duração não pode ser lida é recusado sem cobrança. Os outros limites são verificados antes da geração, e uma requisição que viola algum deles falha sem cobrança.

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

Confira a seção de preços do modelo para as tarifas atuais. O MiniMax H3 Max cobra segundos de saída gerados e segundos de vídeo de referência separadamente, conforme a resolução de saída. As duas primeiras imagens são gratuitas; cada imagem posterior adiciona uma cobrança.

output seconds = reported generated seconds
input seconds  = reported reference-video seconds
extra images   = max(0, reported input image count − 2)
cost = output seconds × output rate
     + input seconds × reference-video rate
     + extra images × image rate

As durações dos vídeos de referência são somadas e arredondadas para o segundo inteiro mais próximo no uso final. Dois clipes de 2,4 segundos correspondem, portanto, a cinco segundos de entrada. O áudio de referência não tem cobrança de entrada. Primeiro e último quadro contam como imagens; dois quadros sozinhos não adicionam cobrança de imagem.

A estimativa do Playground arredonda as durações de referência para cima para cobrir a possível cobrança final. O uso final é cobrado pela tarifa registrada para sua requisição. Se não houver um relatório de uso completo, usa-se a estimativa aceita. 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", "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",
  "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",
  "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 a cena e o som dela juntos: assunto, lugar, câmera, luz, diálogo e efeitos.
• Escreva o diálogo no prompt e anexe um áudio de referência quando a voz precisar segui-lo.
• Faça um rascunho em 480P e selecione 768P quando precisar de mais detalhes. Cada nova geração é uma requisição paga separada.
• Use extra: {"prompt_expansion_mode": "disabled"} para um prompt já completo ou escolha a expansão balanced / quality.
• Use um primeiro e um último quadro para controlar onde a cena começa e termina; use referências para manter um produto, uma pessoa ou um movimento.
• Adicione no text, no logos para evitar marcas inventadas.

Relacionados

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

Fontes do contrato

Os parâmetros seguem a documentação de geração de vídeo da MiniMax. O SeedRouter usa seu próprio ID de modelo, tarefas assíncronas, mídias somente por URL e entrega de resultados hospedados; callbacks e cancelamento não estão disponíveis. content_filter é uma extensão do SeedRouter.