Chave de API do Muse Code: como criar, usar no CI e quanto custa

Uma chave, dois usos

Uma chave da Meta Model API faz dois trabalhos. Ela pode fazer login no Muse Code, o agente de programação para terminal da Meta, no lugar do fluxo pelo navegador, que é a escolha normal para CI, servidores e scripts. E ela pode chamar a Meta Model API diretamente, com os mesmos modelos que o Muse Code usa, a partir do seu próprio código ou de outros agentes de programação.

Cada uso lê a chave de uma variável de ambiente diferente, e é aí que muita gente se confunde:

Se você está usando…	Variável	Observações
A CLI do Muse Code (`muse`, `muse exec`)	`META_API_KEY`	Ou salve uma vez com `muse auth set`
A Model API no seu código, no OpenCode ou no Codex	`MODEL_API_KEY`	É o nome usado nos exemplos da Meta; os SDKs não leem essa variável sozinhos, então passe a chave explicitamente
O Claude Code com modelos da Meta	`ANTHROPIC_AUTH_TOKEN`	Coloque a sua chave da Model API como valor

Criar a chave

Entre no painel da Meta Model API, em dev.meta.ai, com a sua conta de desenvolvedor da Meta.
Abra a aba API keys e clique em Create API key.
Dê um nome que diga onde ela vai ficar (ci-github-actions é bem melhor que key1) e clique em Create.
Copie na hora. A Meta mostra a chave uma única vez.

As chaves começam com LLM_, seguidas de um ID numérico e do segredo. Se a sua conta foi criada pelo cadastro Business & Enterprise da Meta, o login pelo navegador não está disponível para você, então a chave de API é o único jeito de usar o Muse Code: peça para um administrador do time criar uma.

Usar com o Muse Code

Na sua própria máquina, dá para salvar a chave uma vez:

muse auth set

Em qualquer outro lugar, principalmente no CI, injete a chave a partir do seu cofre de segredos como META_API_KEY:

META_API_KEY="$MUSE_KEY" muse exec --json "fix the failing test in tests/date.test.ts"

O Muse Code procura credenciais sempre na mesma ordem: primeiro META_API_KEY, depois uma chave salva e, por fim, uma sessão de navegador salva. Se uma chave de ambiente estiver escondendo a sessão de navegador que você queria usar, o Muse Code avisa. /login reabre as opções de login dentro de uma sessão, e muse logout apaga a sessão e a chave salvas, mas não um META_API_KEY que você exportou no shell; esse você mesmo precisa remover.

Dois detalhes de CI merecem atenção. O muse exec sai com código 0 quando o turno termina, o que não quer dizer que o trabalho está certo, então condicione os merges aos seus próprios testes. E em runners Linux o sandbox precisa do bubblewrap e de uma build que não seja musl: imagens baseadas em Alpine não executam comandos de shell. Nossa lista de comandos da CLI traz as outras flags do muse exec.

Quanto custa uma chave de API no Muse Code

A chave funciona no modelo pay-as-you-go: cada token é cobrado pelo preço da Model API, separado de qualquer plano mensal. A documentação de assinaturas da Meta diz que o uso por chaves de API extras é cobrado assim mesmo que você também tenha assinatura, então uma chave no seu CI não consome a cota do seu plano. As cobranças acontecem quando o saldo atinge um limite de pagamento e no dia 1º de cada mês para o que sobrar; o painel Usage mostra para onde foram os tokens, e o botão Pay now na página Billing quita antes.

Duas coisas que a chave não faz: ela não acessa o Muse Wonder Full, disponível só nos planos Power e Maximum, e não vem com a cota baseada em requisições dos planos.

Preço por modelo

Por 1M de tokens, conforme a página de preços da Meta em 25 de outubro de 2026:

Modelo	Entrada	Entrada em cache	Saída
`muse-wonder-1.0`	$4.00	$0.20	$20.00
`muse-spark-1.3`	$1.25	$0.15	$4.25
`muse-spark-1.3-contributor`	$0.10	$0.002	$0.20

O modelo Contributor é o mesmo Muse Spark 1.3 por uma fração do preço, porque a Meta pode usar os dados para treinar modelos futuros. Não existe versão Contributor do Muse Wonder. O Muse Image custa US$ 0,01 por imagem, e o grounding com busca na web soma US$ 2,50 a cada 1.000 buscas. Nosso estimador transforma volume de tokens em conta mensal, e Contributor vs. Standard trata do lado da privacidade dessa escolha.

Limites de taxa

Os limites valem por time, não por chave, então criar mais chaves não aumenta a sua vazão:

Modelo	Requisições / minuto	Tokens / minuto
`muse-wonder-1.0`	3,000	4,000,000
`muse-spark-1.3`	3,000	4,000,000
`muse-spark-1.3-contributor`	150	3,000,000

Fique de olho nas 150 requisições por minuto do modelo Contributor se você for disparar muitos agentes em paralelo nele.

Chamar a Model API diretamente

A API fala os formatos que outras ferramentas já usam. Para clientes no estilo OpenAI, a URL base é https://api.meta.ai/v1; para clientes no estilo Anthropic, é https://api.meta.ai, sem o /v1. Uma primeira requisição:

curl https://api.meta.ai/v1/chat/completions \
  -H "Authorization: Bearer $MODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "muse-spark-1.3", "messages": [{"role": "user", "content": "Hello"}]}'

A mesma chave funciona no OpenCode, no Codex e no Claude Code com as configurações da nossa documentação. Se as chamadas começarem a falhar, https://api.meta.ai/v1/status mostra a saúde da API e a disponibilidade de cada modelo, sem precisar de chave.

Mantenha a chave segura

Guarde a chave no cofre de segredos do seu CI ou num gerenciador de senhas, nunca no repositório nem no AGENTS.md.
Use uma chave para cada lugar onde ela fica, para conseguir revogar uma chave de CI vazada sem quebrar o seu notebook.
Passe a chave como variável de ambiente só para o comando que precisa dela, como no exemplo do muse exec acima, em vez de exportá-la num perfil de shell compartilhado.
Se uma chave vazar, apague-a no painel e crie outra: quem tiver a chave pode gerar cobranças altas na sua conta.