Claude Opus 5.5 já está disponível no SeedRouter

Video

MiniMax H3

View Markdown

Gere com o MiniMax H3 clipes de 4 a 15 segundos com som em 768P ou 2K: texto para vídeo, primeiro e último quadro e referências para vídeo, no formato de requisição oficial da MiniMax, entregues como tarefa.

Standard e Pro

Os dois canais aceitam content_filter. O padrão é true, com verificação do conteúdo antes da geração. O Playground mantém a opção ativada; quem usa a API pode definir false. As restrições de conteúdo do fornecedor ainda podem se aplicar.

minimax-h3 é Pro e mantém o formato de requisição e o comportamento atuais. As seções sobre o formato nativo abaixo descrevem o Pro. Standard usa minimax-h3-standard com seu próprio corpo JSON plano no mesmo endpoint /v1/videos/generations. Não é uma versão Max ou Turbo. As duas variantes não alternam automaticamente entre si em caso de falha.

{
  "model": "minimax-h3-standard",
  "prompt": "A sailboat crosses a quiet bay, with soft wind and waves.",
  "quality": "high",
  "content_filter": true,
  "duration_s": 5,
  "resolution": "768p",
  "aspect_ratio": "16:9"
}

Standard aceita apenas estes campos. Os URLs devem ser públicos, HTTP(S) e sem credenciais; uploads diretos de arquivos e base64 não são aceitos.

CampoTipoObrigatório / padrãoValores
modelstringobrigatóriominimax-h3-standard
promptstringobrigatórionão vazio; obrigatório em todos os modos
qualitystringobrigatóriolow, high; mesmo preço
duration_snumber55–15, incluindo decimais
resolutionstring768p480p, 768p, 1080p, 2k, 4k
aspect_ratiostring16:916:9, 9:16, 1:1, 4:3, 3:4, 21:9
seedintegeraleatório0–9223372036854775807
watermarkbooleanfalsetrue / false
enhancebooleantruereescrita do prompt; false preserva o prompt
priorityinteger10001000 / 0
content_filterbooleantrueVerificação de conteúdo do SeedRouter antes de gerar; false ignora a verificação
first_frame_image_urlstringopcionalum URL de imagem
last_frame_image_urlstringopcionalexige o primeiro quadro
reference_image_urlstring[]opcional1–4 URLs de imagens
reference_video_urlstring[]opcionalum URL de vídeo

O primeiro e o último quadro não podem ser combinados com referências. Sem mídia, a geração é de texto para vídeo. Imagens de referência e um vídeo de referência podem ser combinados. Áudio de referência independente não é suportado. Todo resultado inclui áudio nativo. Low prioriza a velocidade e High a fidelidade, sem afirmar que qualquer um dos dois tenha qualidade equivalente à do Pro.

Imagens: até 30 MiB cada; JPEG, PNG, WebP, GIF, BMP, TIFF, HEIC, HEIF ou AVIF. Não há limite de dimensões para imagens; imagens grandes podem ser redimensionadas antes da geração. Vídeos: até 100 MiB, 0.5–600 segundos, fluxo de vídeo legível (incluindo MP4, MOV e WebM), largura e altura pares de pelo menos 64 pixels cada.

Standard cobra ceil(duration_s) × a tarifa atual da resolução. Mídia de referência, áudio, qualidade e reescrita do prompt não acrescentam custos. Tarefas que falham não são cobradas. Os preços vêm da seção de preços atualizados.

A criação e a consulta de status usam o protocolo assíncrono compartilhado abaixo. O resultado bem-sucedido contém video_url, resolution, ratio e duration; duration reflete a duração solicitada. Não são retornados custos, identificadores ou URLs de fornecedores. Um envio com resultado desconhecido não deve ser repetido automaticamente. Para sementes acima do limite de inteiros seguros do JavaScript, serialize o inteiro sem perda de precisão; não o arredonde por meio de Number.

Referência Pro

O MiniMax H3 (Hailuo 03) é o modelo de vídeo multimodal da MiniMax. Uma única requisição cria a imagem e o som juntos: um clipe de 4 a 15 segundos em 768P ou 2K 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. Envie a requisição, guarde o ID da tarefa retornado e leia o vídeo pronto a partir da tarefa. Quadros e referências são enviados como URLs.

IDs de modelo

ID de modeloEntradasResoluçõesDuração
minimax-h3texto, primeiro e último quadro, imagens, vídeos e áudios de referência768P, 2KDe 4 a 15 segundos

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",
    "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
CabeçalhoValor
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

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

CampoTipoPadrãoObservações
modelstringobrigatóriominimax-h3
contentarrayobrigatórioO prompt e qualquer mídia, como os itens descritos abaixo. Exatamente um item text não vazio.
resolutionenumobrigatório768P ou 2K.
durationintegerobrigatórioQualquer inteiro de 4 a 15 segundos.
ratioenumconforme a entradaadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16. Obrigatório só com texto, caso em que adaptive não é aceito.
content_filterbooleantrueO filtro de conteúdo do SeedRouter, descrito abaixo. Não é enviado ao modelo.

O esquema é estrito: campos desconhecidos são rejeitados em vez de ignorados. callback_url não está disponível; consulte a tarefa. extra pertence ao MiniMax-H3-Max e não é aceito por este modelo.

Itens de content

typeItemrole
text{"type": "text", "text": "..."}, até 7.000 caracteresnenhum
image_url{"type": "image_url", "image_url": {"url": "https://..."}, "role": "..."}first_frame, last_frame ou reference_image
video_url{"type": "video_url", "video_url": {"url": "https://..."}, "role": "reference_video"}reference_video
audio_url{"type": "audio_url", "audio_url": {"url": "https://..."}, "role": "reference_audio"}reference_audio

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.

Modocontent contémratio
Texto para vídeoum item textobrigatório, não adaptive
Imagem para vídeotext mais uma imagem first_frame e/ou last_framequalquer valor é tratado como adaptive: a imagem define o formato
Referências para vídeotext mais qualquer combinação de até 9 itens reference_image, 3 reference_video e 3 reference_audioopcional, padrão adaptive

Quadros e referências não podem ser combinados em uma mesma requisição.

{
  "model": "minimax-h3",
  "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": "2K",
  "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.

EntradaFormatoLimites
ImagemJPG, JPEG, PNG, WebP, HEIC, HEIFAté 30 MB; cada lado com 256–5760 px; largura / altura de 0,4 a 2,5
VídeoMP4, MOV (H.264 ou H.265)Até 50 MB; de 2 a 15 segundos cada, 15 segundos no total; cada lado com 256–5760 px; largura / altura de 0,4 a 2,5; 23,976–60 fps
ÁudioWAV, MP3Até 15 MB; de 2 a 15 segundos cada, 15 segundos no total

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

Veja a seção de preços do modelo para as tarifas atuais. O MiniMax H3 é cobrado por segundo de vídeo, com uma tarifa definida pela resolução de saída, mais as imagens de entrada além das cinco primeiras:

billed seconds = duration + ceil(Σ each reference video's seconds)
extra images   = max(0, number of images − 5)
cost = billed seconds × rate per second + extra images × rate per image

Primeiros quadros, últimos quadros e imagens de referência contam como imagens. O áudio de referência não é cobrado. As duas quantidades são conhecidas quando a requisição é aceita, então o valor reservado é o valor cobrado. Veja as cobranças finais no histórico de uso da sua conta. Tarefas que falham não são cobradas.

Esquema de saída

O envio retorna a tarefa:

{"id": "task_...", "model": "minimax-h3", "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",
  "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 feito, incluindo a escolhida para adaptive. No nosso teste, um clipe de 4 segundos em 768P com 16:9 voltou como MP4 (H.264) em 1344 × 768 e 24 fps, com uma faixa AAC estéreo de 32 kHz.

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",
  "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 o rascunho em 768P e depois renderize a cena final em 2K com a mesma requisição.
  • 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