Muse Video

Gere clipes do Muse Video de 10 segundos em 720p com som, de um prompt ou até 9 imagens de referência, em sete proporções, por clipe e com entrega por tarefa.

Muse Video é o modelo de vídeo da Meta Superintelligence Labs. Uma requisição gera um clipe de cerca de 10 segundos em 720p com som a partir de um prompt ou de um prompt com até 9 imagens de referência, em uma de sete proporções. Envie a requisição, guarde o ID da tarefa retornado e leia o vídeo pronto na tarefa. As imagens de referência são enviadas como URLs.

IDs dos modelos

ID do modelo	Entradas	Resolução	Duração
`muse-video`	texto, 0–9 imagens	`720p`	cerca de 10 segundos, com som

Veja os preços atuais na página do modelo.

Exemplo rápido

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "muse-video",
    "prompt": "Waves rolling onto a sandy beach at sunset, slow camera pan, natural ocean sound. No text.",
    "aspect_ratio": "16:9"
  }'

Endpoint

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

Cabeçalho	Valor
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/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 servidor.

Parâmetros

Campo	Tipo	Padrão	Notas
`model`	string	obrigatório	`muse-video`
`prompt`	string	obrigatório	Não pode ficar vazio após remover espaços nas extremidades. Também é obrigatório com referências.
`image_urls`	lista de URLs	nenhum	0–9 URLs públicas de imagens, 11 MB no total. Sem elas, a requisição é de texto para vídeo.
`aspect_ratio`	enum	auto	`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2` ou `2:3`. Omita para auto: as referências definem o formato; só texto retorna `16:9`. Não envie `"auto"`.
`size`	enum	nenhum	Alias de compatibilidade de `aspect_ratio`: uma das proporções acima ou `auto`. Quando ambos são válidos, `aspect_ratio` prevalece.
`duration`	inteiro ou string	`10`	Apenas `10`, `"10"` ou `"10s"`. O clipe dura cerca de 10 segundos.
`resolution`	enum	`720p`	Apenas `720p`.
`audio`	booleano	`true`	Apenas `true`; todo clipe tem som. `false` é recusado.
`n`	inteiro	`1`	Apenas `1`. Cada requisição retorna um clipe.

Campos fora desta lista são descartados antes de encaminhar a requisição; nunca causam erros nem alteram a saída. Não há ajustes de primeiro ou último quadro, vídeo de referência, áudio de referência, extensão, semente ou prompt negativo. callback_url não está disponível; consulte a tarefa.

Imagens de referência

Passe até 9 imagens em image_urls e descreva o movimento em prompt. Muse Video as usa como referências: o clipe se mantém próximo delas, mas o primeiro quadro não é uma cópia pixel a pixel. Se omitir aspect_ratio, o clipe segue o formato delas.

{
  "model": "muse-video",
  "prompt": "The fox slowly lifts its head, wind moving through its fur, the camera pushing in gently, soft forest ambience.",
  "image_urls": ["https://example.com/fox.png"]
}

Entradas de mídia

Cada referência é uma URL pública HTTP(S). URIs de dados Base64 não são aceitas: envie o arquivo para seu próprio armazenamento e passe a URL. Use imagens PNG, JPEG ou WebP; os arquivos originais de todas as referências devem somar até 11 MB. Um conjunto acima desse limite falha após a aceitação e não é cobrado.

Dimensões de preço

Veja as tarifas atuais na seção de preços do modelo. Muse Video tem um preço por clipe:

cost = price per clip × 1

O preço não é multiplicado pelos segundos. Requisições só de texto e com referências custam o mesmo, assim como todas as proporções. O valor reservado quando a tarefa é aceita é o valor cobrado. Veja as cobranças finais no histórico de uso da conta. Tarefas que falham não são cobradas.

Esquema de saída

O envio retorna a tarefa:

{"id": "task_...", "model": "muse-video", "status": "processing", "created_at": 1789689600}

Consultar a tarefa

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

Consulte a cada 10–20 segundos até status ser completed ou failed. Um timeout de rede durante a consulta não significa que a geração falhou: guarde o ID da tarefa e retome as consultas. Não crie outra tarefa para verificar o progresso.

Tarefa concluída

{
  "id": "task_...",
  "model": "muse-video",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689790,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

Nos nossos testes, os clipes retornaram como arquivos MP4 (H.264) de 10,0 segundos com uma faixa de áudio AAC: 1280 × 720 para 16:9, 720 × 1280 para 9:16 e 1248 × 704 para uma referência com formato 16:9, cerca de 100–200 segundos após o envio.

Erros

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

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

{
  "id": "task_...",
  "model": "muse-video",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

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

Dicas

Descreva sujeito, ação, movimento de câmera e luz e diga os sons que quer; o áudio é gerado junto com a imagem.
Crie uma imagem estática com Muse Image e passe a URL aqui para colocá-la em movimento.
Para vídeo vertical, envie aspect_ratio: "9:16" ou uma referência em retrato.
Adicione sem texto para evitar legendas inventadas.