Muse Code API-sleutel: aanmaken, gebruiken in CI en wat het kost
Muse Code logt in via de browser of met een API-sleutel, en diezelfde sleutel geeft je ook toegang tot Meta's Model API. Zo maak je een sleutel aan, welke omgevingsvariabele elke tool verwacht (META_API_KEY of MODEL_API_KEY), base-URL's, prijzen per token, rate limits en de fouten die tot onverwachte rekeningen leiden.
Eén sleutel, twee toepassingen
Een sleutel voor de Meta Model API doet twee dingen. Hij kan je aanmelden bij Muse Code, de coding-agent van Meta voor de terminal, in plaats van de browserflow — de gebruikelijke keuze voor CI, servers en scripts. En je kunt er de Meta Model API direct mee aanroepen, dus dezelfde modellen waar Muse Code op draait, vanuit je eigen code of vanuit andere coding-agents.
Die twee toepassingen lezen de sleutel uit verschillende omgevingsvariabelen, en daar gaat het vaak mis:
| Je gebruikt… | Variabele | Opmerkingen |
|---|---|---|
De Muse Code-CLI (muse, muse exec) |
META_API_KEY |
Of sla hem één keer op met muse auth set |
| De Model API vanuit je eigen code, OpenCode of Codex | MODEL_API_KEY |
De naam uit Meta’s voorbeelden; SDK’s lezen hem niet automatisch, dus geef hem expliciet mee |
| Claude Code op de modellen van Meta | ANTHROPIC_AUTH_TOKEN |
Zet hem op je Model API-sleutel |
Een sleutel aanmaken
- Log met je Meta-developeraccount in op het dashboard van de Meta Model API via dev.meta.ai.
- Open het tabblad API keys en klik op Create API key.
- Geef hem een naam die zegt waar hij komt te staan —
ci-github-actionsis beter dankey1— en klik op Create. - Kopieer hem meteen. Meta laat de sleutel maar één keer zien.
Sleutels beginnen met LLM_, gevolgd door een numeriek ID en het secret. Is je account aangemaakt via de Business & Enterprise-registratie van Meta, dan kun je helemaal niet via de browser inloggen en is een API-sleutel de enige manier om Muse Code te gebruiken. Vraag in dat geval een admin van je team om er een aan te maken.
Gebruiken met Muse Code
Op je eigen machine kun je de sleutel één keer opslaan:
muse auth set
Overal elders, en zeker in CI, injecteer je hem vanuit je secret store als META_API_KEY:
META_API_KEY="$MUSE_KEY" muse exec --json "fix the failing test in tests/date.test.ts"
Muse Code zoekt in een vaste volgorde naar credentials: eerst META_API_KEY, dan een opgeslagen sleutel, dan een opgeslagen browsersessie. Verbergt een sleutel uit de omgeving een browsersessie die je eigenlijk wilde gebruiken, dan meldt Muse Code dat. /login opent binnen een sessie opnieuw de inlogopties, en muse logout wist de opgeslagen sessie en de opgeslagen sleutel — maar niet een META_API_KEY die je in je shell hebt geëxporteerd. Die moet je zelf unsetten.
Twee CI-details om te onthouden. muse exec stopt met exitcode 0 zodra de beurt klaar is, en dat is niet hetzelfde als goed werk; laat merges dus afhangen van je eigen tests. En op Linux-runners heeft de sandbox bubblewrap en een build zonder musl nodig; op images gebaseerd op Alpine draaien geen shell-commando’s. De overige flags van muse exec staan in ons overzicht van CLI-commando’s.
Wat een API-sleutel kost in Muse Code
Een sleutel werkt op basis van pay-as-you-go: elk token wordt tegen de tarieven van de Model API afgerekend, los van een eventueel maandabonnement. Volgens Meta’s documentatie over abonnementen geldt dat ook als je daarnaast een abonnement hebt, dus een sleutel in je CI snoept niet van het tegoed van je abonnement. Er wordt afgeschreven zodra je saldo een betalingsdrempel bereikt, en op de eerste van elke maand voor wat er nog openstaat. Het Usage-dashboard laat zien waar de tokens naartoe gingen, en met Pay now op de Billing-pagina betaal je eerder af.
Twee dingen kan een sleutel niet: hij geeft geen toegang tot Muse Wonder Full, dat alleen in de Power- en Maximum-abonnementen zit, en hij komt niet met het op requests gebaseerde tegoed van de abonnementen.
Prijzen per model
Per 1M tokens, volgens de prijspagina van Meta op 25 oktober 2026:
| Model | Input | Cached input | Output |
|---|---|---|---|
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 |
Het Contributor-model is hetzelfde Muse Spark 1.3 voor een fractie van de prijs, omdat Meta de data mag gebruiken om toekomstige modellen te trainen. Een Contributor-versie van Muse Wonder bestaat niet. Muse Image kost $0,01 per afbeelding, en web search grounding komt erbij voor $2,50 per 1.000 zoekopdrachten. Onze rekentool zet tokenvolumes om in een maandbedrag, en Contributor vs. Standard gaat in op de privacykant van die keuze.
Rate limits
Limieten gelden per team, niet per sleutel. Meer sleutels aanmaken levert dus geen extra throughput op:
| Model | Requests/minuut | Tokens/minuut |
|---|---|---|
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 |
Let vooral op die 150 requests per minuut van het Contributor-model als je er veel parallelle agents op loslaat.
De Model API direct aanroepen
De API spreekt de formaten die andere tools al gebruiken. Voor clients in OpenAI-stijl is de base-URL https://api.meta.ai/v1; voor clients in Anthropic-stijl is het https://api.meta.ai, zonder /v1. Een eerste request:
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"}]}'
Dezelfde sleutel werkt in OpenCode, Codex en Claude Code met de configuraties uit onze docs. Beginnen aanroepen te falen, dan meldt https://api.meta.ai/v1/status de status van de API en de beschikbaarheid van elk model, zonder dat je een sleutel nodig hebt.
Houd de sleutel veilig
- Bewaar hem in de secret store van je CI of in een wachtwoordmanager, nooit in de repository of in
AGENTS.md. - Gebruik één sleutel per plek waar hij staat, zodat je een gelekte CI-sleutel kunt intrekken zonder dat je laptop stopt met werken.
- Geef hem als omgevingsvariabele mee aan alleen dat ene commando dat hem nodig heeft, zoals in het
muse exec-voorbeeld hierboven, in plaats van hem te exporteren in een gedeeld shellprofiel. - Is een sleutel gelekt, verwijder hem dan in het dashboard en maak een nieuwe aan — anders kan hij een flinke rekening op je account laten oplopen.