GIDS· 5 min leestijd

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.

#api#model-api#authentication#ci#pricing

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

  1. Log met je Meta-developeraccount in op het dashboard van de Meta Model API via dev.meta.ai.
  2. Open het tabblad API keys en klik op Create API key.
  3. Geef hem een naam die zegt waar hij komt te staan — ci-github-actions is beter dan key1 — en klik op Create.
  4. 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.
Verder lezen