Clé API Muse Code : la créer, l’utiliser en CI et combien elle coûte

Une clé, deux usages

Une clé Meta Model API sert à deux choses. Elle peut connecter Muse Code, l’agent de code en terminal de Meta, à la place du parcours dans le navigateur : c’est la solution habituelle pour la CI, les serveurs et les scripts. Elle permet aussi d’appeler directement la Meta Model API, c’est-à-dire les mêmes modèles que ceux de Muse Code, depuis ton propre code ou depuis d’autres agents de code.

Piège classique : selon l’usage, la clé est lue dans une variable d’environnement différente.

Tu utilises…	Variable	Remarques
La CLI Muse Code (`muse`, `muse exec`)	`META_API_KEY`	Ou enregistre-la une fois pour toutes avec `muse auth set`
La Model API depuis ton code, OpenCode ou Codex	`MODEL_API_KEY`	Le nom utilisé dans les exemples de Meta ; les SDK ne la lisent pas d’eux-mêmes, passe-la explicitement
Claude Code sur les modèles de Meta	`ANTHROPIC_AUTH_TOKEN`	À renseigner avec ta clé Model API

Créer une clé

Connecte-toi au tableau de bord de la Meta Model API sur dev.meta.ai avec ton compte développeur Meta.
Ouvre l’onglet API keys et clique sur Create API key.
Donne-lui un nom qui indique où elle sera utilisée (ci-github-actions vaut mieux que key1), puis clique sur Create.
Copie-la tout de suite : Meta ne l’affiche qu’une seule fois.

Les clés commencent par LLM_, suivi d’un identifiant numérique et du secret. Si ton compte a été créé via l’inscription Business & Enterprise de Meta, la connexion par navigateur ne t’est pas proposée du tout : la clé API est alors le seul moyen d’utiliser Muse Code. Demande à un administrateur de ton équipe d’en créer une.

L’utiliser avec Muse Code

Sur ta propre machine, tu peux enregistrer la clé une fois :

muse auth set

Partout ailleurs, et surtout en CI, injecte-la depuis ton gestionnaire de secrets sous le nom META_API_KEY :

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

Muse Code cherche ses identifiants dans un ordre fixe : d’abord META_API_KEY, puis une clé enregistrée, puis une session de navigateur enregistrée. Si une clé d’environnement masque la session de navigateur que tu voulais utiliser, Muse Code te le signale. Dans une session, /login rouvre les options de connexion, et muse logout efface la session et la clé enregistrées, mais pas une META_API_KEY exportée dans ton shell : celle-là, supprime-la toi-même.

Deux détails à connaître pour la CI. muse exec renvoie le code 0 quand le tour se termine, ce qui ne veut pas dire que le travail est juste : conditionne les fusions à tes propres tests. Et sur les runners Linux, la sandbox a besoin de bubblewrap et d’un build non musl ; sur les images basées sur Alpine, les commandes shell ne s’exécutent pas. Notre aide-mémoire des commandes recense les autres options de muse exec.

Ce que coûte une clé API dans Muse Code

Une clé fonctionne en paiement à l’usage : chaque token est facturé au tarif de la Model API, indépendamment de tout forfait mensuel. D’après la documentation des abonnements de Meta, l’usage via des clés API supplémentaires est facturé ainsi même si tu es abonné : une clé dans ta CI ne puise donc pas dans le quota de ton forfait. Les prélèvements ont lieu quand ton solde atteint un seuil de paiement, puis le 1er de chaque mois pour le reste ; le tableau de bord Usage montre où sont partis les tokens, et le bouton Pay now de la page Billing permet de régler en avance.

Deux choses restent hors de portée d’une clé : elle ne donne pas accès à Muse Wonder Full, réservé aux forfaits Power et Maximum, et elle n’inclut pas le quota par requêtes des forfaits.

Prix par modèle

Pour 1 million de tokens, d’après la page tarifaire de Meta au 25 octobre 2026 :

Modèle	Entrée	Entrée en cache	Sortie
`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

Le modèle Contributor, c’est le même Muse Spark 1.3 pour une fraction du prix, parce que Meta peut utiliser les données pour entraîner ses futurs modèles. Il n’existe pas de version Contributor de Muse Wonder. Muse Image coûte 0,01 $ par image, et l’ancrage par recherche web ajoute 2,50 $ pour 1 000 recherches. Notre simulateur convertit des volumes de tokens en facture mensuelle, et Contributor vs Standard traite le volet confidentialité de ce choix.

Limites de débit

Les limites s’appliquent par équipe, pas par clé : multiplier les clés n’augmente pas le débit.

Modèle	Requêtes / minute	Tokens / minute
`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

Les 150 requêtes par minute du modèle Contributor sont le chiffre à surveiller si tu fais tourner de nombreux agents en parallèle dessus.

Appeler directement la Model API

L’API parle les formats que les autres outils utilisent déjà. Pour les clients de type OpenAI, l’URL de base est https://api.meta.ai/v1 ; pour les clients de type Anthropic, c’est https://api.meta.ai, sans /v1. Une première requête :

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"}]}'

La même clé fonctionne dans OpenCode, Codex et Claude Code avec les configurations de notre documentation. Si les appels se mettent à échouer, https://api.meta.ai/v1/status indique l’état de l’API et la disponibilité de chaque modèle, sans clé.

Protéger ta clé

Range-la dans le gestionnaire de secrets de ta CI ou dans un gestionnaire de mots de passe, jamais dans le dépôt ni dans AGENTS.md.
Utilise une clé par emplacement : tu pourras révoquer une clé de CI compromise sans casser ton portable.
Passe-la en variable d’environnement uniquement pour la commande qui en a besoin, comme dans l’exemple muse exec ci-dessus, plutôt que de l’exporter dans un profil de shell partagé.
Si une clé fuite, supprime-la dans le tableau de bord et crées-en une nouvelle : elle peut faire grimper la facture sur ton compte.