Muse Image

Muse Image é o modelo de imagens da Meta Superintelligence Labs. Uma requisição gera uma imagem 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 a imagem pronta na tarefa. As imagens de referência são enviadas como URLs.

IDs dos modelos

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

Exemplo rápido

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "muse-image",
    "prompt": "A red ceramic mug on a white table, soft studio light, product photography. No text, no logos.",
    "aspect_ratio": "1:1"
  }'

Endpoint

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

A resposta é uma tarefa ({"id": "task_...", "status": "processing"}), não a imagem pronta. Consulte GET /v1/tasks/{task_id} para obter o resultado. Mantenha as chaves de API no código do servidor. As referências vão na mesma requisição por image_urls; /v1/images/edits não é usado para este modelo.

Parâmetros

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 resolução, semente, prompt negativo, máscara ou formato de saída. callback_url não está disponível; consulte a tarefa.

Imagens de referência

Passe até 9 imagens em image_urls e diga em prompt o que manter e o que mudar. Muse Image as usa como referências para uma nova imagem; se omitir aspect_ratio, o resultado segue o formato delas.

{
  "model": "muse-image",
  "prompt": "Keep this exact jacket; show it folded in a flat lay of hiking gear on pine boards, soft morning light.",
  "image_urls": ["https://example.com/jacket.png"],
  "aspect_ratio": "9:16"
}

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 Image tem um preço por imagem:

cost = price per image × 1

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-image", "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-image",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689680,
  "output": {
    "created": 0,
    "data": [
      { "url": "https://static.seedrouter.ai/media/tasks/task_example/0.webp" }
    ]
  }
}

A imagem é entregue em WebP, o formato próprio do modelo; não há ajuste de formato de saída. O modelo define o tamanho em pixels. Nos nossos testes, uma requisição só de texto retornou em 1600 × 1600, 16:9 em 2048 × 1152, 3:4 em 1344 × 1792 e 9:16 em 1152 × 2048, cerca de 50–180 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-image",
  "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

• Diga o sujeito, o cenário, a luz e o enquadramento; Muse Image segue de perto um briefing específico.
• Com referências, diga exatamente o que deve permanecer igual, como a cor ou a forma do produto.
• Omita aspect_ratio para seguir o formato de uma referência; defina para recortar conforme o canal.
• Adicione sem texto, sem logotipos para evitar marcas inventadas.

Relacionados

• Playground e preços do Muse Image
• Referência da API do Muse Video
• Baixar OpenAPI
• Markdown para copiar