APIMart
Imagem

Muse Image API

Crie imagens com Muse Image API a partir de um prompt ou de até nove referências. Escolha uma proporção ou siga a das referências e obtenha uma imagem WebP pela API de tarefas.

Geração de imagens

Destaques do Serviço

  • Descontos Oficiais
  • Pagamento conforme uso
  • Rápido e baixa latência
Input
Imagem de Referência

Opcional: até 9 imagens, 11 MiB no total. Automático segue a proporção da referência.

Saída

Nenhuma geração ainda.

Preços da Muse Image API

Preços transparentes sem taxas ocultas. Pague apenas pelo que usar.

VariantePreço OuroPreço atualPreço PlatinaPreço DiamantePreço oficialSua economia
muse-image-ext0.048Credits(~$0.0048)/img0.0456Credits(~$0.0046)/img0.0432Credits(~$0.0043)/img0.06Credits(~$0.006)/img20%

* Os custos reais dependem da saída final.

Crie com Muse Image API

Crie imagens com Muse Image API a partir de um prompt ou de até nove referências. Escolha uma proporção ou siga a das referências e obtenha uma imagem WebP pela API de tarefas.

Recursos de Muse Image API

Modos de geração, requisitos de entrada e especificações de saída.

Texto para imagem com Muse Image API

Descreva o assunto, o cenário, a composição e a luz. Envie o prompt sem referências para gerar a partir do texto.

Imagens de referência com Muse Image API

Adicione até nove imagens ao prompt por URL, Data URI ou base64. O tamanho original total não pode exceder 11 MiB.

Sete proporções para Muse Image

Escolha 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 ou 2:3. Automático omite aspect_ratio e segue a proporção das referências, quando presentes.

Uma imagem WebP com Muse Image Model

Cada solicitação gera uma imagem. O modelo define as dimensões; tamanhos em pixels e níveis de resolução não podem ser selecionados.

Use o modelo muse-image-ext

Envie o identificador completo do modelo para /v1/images/generations para iniciar uma tarefa de geração.

Tarefas assíncronas com Muse Image API

Envie uma vez, salve o ID da tarefa e consulte o status. Após uma interrupção, reutilize a mesma chave de idempotência e o mesmo corpo da solicitação.

Preços de Muse Image API

Confira os preços atuais da conta antes de gerar. O custo final da tarefa e o extrato determinam a cobrança. Cada solicitação é cobrada por imagem.

Obtenha e salve os resultados de Muse Image

Leia a URL após o status completed. Se a resposta incluir expires_at, baixe ou arquive o conteúdo antes desse prazo.

Casos de uso de Muse Image API

Prepare um briefing para o objetivo do projeto e revise o resultado entregue.

Cenas de produto com Muse Image API

Descreva cenário, iluminação e composição, com referências quando necessário. Revise os detalhes do produto antes de publicar.

Conceitos de campanha com Muse Image

Explore temas, paletas e estilos de campanha e compare as imagens com o briefing.

Visuais editoriais com Muse Image API

Transforme o tema de um artigo em briefing visual e reserve espaço para textos adicionados na diagramação.

Design por referências com muse-image-ext

Combine texto e referências para descrever a cena e confira os detalhes essenciais do design.

Imagens sociais com Muse Image

Escolha formato vertical, quadrado ou horizontal conforme o destino e prepare a imagem final para publicação.

Ferramentas de imagem com Muse Image API

Integre prompts, acompanhamento de tarefas e obtenção de imagens ao aplicativo. Guarde as chaves de API no servidor.

Como obter uma chave Muse Image API e começar

Crie sua chave, prepare o briefing e organize seus resultados.

1

Obtenha sua chave Muse Image API

Entre na APIMart e crie uma chave em API Keys. Guarde-a no servidor, fora do código do navegador e de repositórios públicos.

2

Prepare um briefing claro

Descreva o resultado esperado e seu contexto. Guarde o briefing junto com a solicitação para comparar revisões.

3

Revise e integre o resultado

Compare o resultado com o briefing antes de usá-lo. Organize os recursos selecionados para a próxima etapa da produção.

Exemplos e integração de Muse Image API

Envie muse-image-ext para /v1/images/generations, salve o ID e consulte o resultado com GET /v1/tasks/{task_id}.

  1. 1

    Autentique as solicitações de Muse Image API

    Guarde a chave no servidor e envie Authorization: Bearer <key>. Crie um Idempotency-Key para cada nova geração.

  2. 2

    Envie uma tarefa muse-image-ext

    Faça POST de model e prompt para /v1/images/generations e salve data[0].task_id da resposta padrão. Ao repetir um envio interrompido, preserve a chave e o corpo.

  3. 3

    Obtenha o resultado de Muse Image

    Consulte GET /v1/tasks/{task_id} até completed ou failed. Leia data.result.images[0].url[0] no sucesso ou data.error.message na falha. Um tempo limite local não indica falha da tarefa.

    Consulte a referência de Muse Image API para detalhes de solicitações e respostas.

POST /v1/images/generations
IDEMPOTENCY_KEY="${IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.apimart.ai/v1/images/generations \
  -H "Authorization: Bearer $APIMART_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
    "model": "muse-image-ext",
    "prompt": "A red ceramic cup on a white table, soft studio lighting, product photograph, no text",
    "n": 1,
    "aspect_ratio": "1:1"
  }'

Parâmetros de Muse Image API

ParâmetroTipoObrigatórioPadrãoDescrição
modelstringObrigatórioPadrão: —Identificador obrigatório: muse-image-ext.
promptstringObrigatórioPadrão: —Texto não vazio após remover espaços nas extremidades. Aceita inglês e chinês; obrigatório mesmo com referências.
image_urlsstring[]OpcionalPadrão: —Até nove URLs de imagem, Data URIs ou strings base64, com tamanho original total máximo de 11 MiB. Omita sem referências.
aspect_ratiostringOpcionalPadrão: —1:1, 16:9, 9:16, 4:3, 3:4, 3:2 ou 2:3. No automático, omita o campo, sem enviar "auto". Sem referências: 1:1; com referências: a proporção delas.
nintegerOpcionalPadrão: 1Somente o número 1. Um resultado por solicitação.
nsfw_checkbooleanOpcionalPadrão: falseAtiva a moderação antes do envio. O envio bem-sucedido não garante aprovação em todas as verificações.

Explore as APIs Muse

Escolha a página Muse para o tipo de conteúdo do seu projeto.

Muse Video API

Perguntas sobre Muse Image API

O que é Muse Image API?

É a geração de imagens a partir de texto ou referências pelo APIMart. O modelo muse-image-ext retorna uma imagem WebP por tarefa assíncrona.

Qual ID de modelo usa Muse Image API?

Use muse-image-ext completo, incluindo -ext, no campo model da solicitação.

Como obter uma chave de Muse Image API?

Entre no APIMart e crie uma chave em API Keys. Guarde-a no servidor e envie Authorization: Bearer <key> para criar e consultar tarefas.

Quantas referências Muse Image aceita?

De zero a nove imagens, com tamanho original total de até 11 MiB. Envie URLs, Data URIs ou base64 em image_urls; o prompt continua obrigatório.

Quais proporções Muse Image API aceita?

1:1, 16:9, 9:16, 4:3, 3:4, 3:2 e 2:3. No automático, omita aspect_ratio: segue a proporção das referências ou usa 1:1 quando não há referências.

Posso escolher a resolução de Muse Image?

Não. O modelo determina as dimensões e retorna WebP. Não envie um nível de resolução nem tamanho em pixels como 1024x1024.

Muse Image API gera várias imagens ou aceita máscaras?

Uma solicitação gera uma imagem e n só aceita o número 1. Máscaras, vídeos e áudios de referência não são compatíveis.

E se Muse Image API ultrapassar a espera da página?

Guarde o ID e consulte a tarefa depois. Um tempo limite no navegador não cancela a tarefa no servidor; não gere novamente de forma automática.

Como os preços de Muse Image API são calculados?

Confira os preços atuais da conta antes de gerar. O custo final da tarefa e o extrato determinam a cobrança. Cada solicitação é cobrada por imagem.

Posso guardar os resultados de Muse Image?

Baixe ou arquive os arquivos. Quando expires_at estiver presente, faça isso antes do prazo; um link expirado não deve iniciar outra geração paga automaticamente.