Chiave API di Muse Code: come crearla, usarla in CI e quanto costa
Muse Code può accedere tramite browser o con una chiave API, e la stessa chiave apre anche la Model API di Meta. Come creare la chiave, quale variabile d’ambiente si aspetta ogni strumento (META_API_KEY o MODEL_API_KEY), URL di base, prezzi a token, limiti di frequenza e gli errori che portano a bollette inattese.
Una chiave, due usi
Una chiave Meta Model API fa due lavori. Può autenticare Muse Code, l’agente di coding da terminale di Meta, al posto del login dal browser: è la scelta normale per CI, server e script. E può chiamare direttamente la Meta Model API, cioè gli stessi modelli su cui gira Muse Code, dal tuo codice o da altri agenti di coding.
I due usi leggono la chiave da variabili d’ambiente diverse, ed è qui che molti inciampano:
| Stai usando… | Variabile | Note |
|---|---|---|
La CLI di Muse Code (muse, muse exec) |
META_API_KEY |
Oppure salvala una volta per tutte con muse auth set |
| La Model API dal tuo codice, da OpenCode o da Codex | MODEL_API_KEY |
Il nome usato negli esempi di Meta; gli SDK non la leggono da soli, quindi passala esplicitamente |
| Claude Code sui modelli di Meta | ANTHROPIC_AUTH_TOKEN |
Impostala con la tua chiave Model API |
Creare una chiave
- Accedi alla dashboard della Meta Model API su dev.meta.ai con il tuo account sviluppatore Meta.
- Apri la scheda API keys e fai clic su Create API key.
- Dalle un nome che dica dove verrà usata (
ci-github-actionsè meglio dikey1) e fai clic su Create. - Copiala subito: Meta la mostra una volta sola.
Le chiavi iniziano con LLM_, seguito da un ID numerico e dal segreto. Se il tuo account è stato creato tramite la registrazione Business & Enterprise di Meta, il login dal browser non è proprio disponibile: la chiave API è l’unico modo per usare Muse Code, quindi chiedi a un amministratore del team di crearne una.
Usarla con Muse Code
Sulla tua macchina puoi salvare la chiave una volta sola:
muse auth setOvunque altrove, soprattutto in CI, iniettala dal tuo archivio di segreti come META_API_KEY:
META_API_KEY="$MUSE_KEY" muse exec --json "fix the failing test in tests/date.test.ts"Muse Code cerca le credenziali in un ordine fisso: prima META_API_KEY, poi una chiave salvata, poi una sessione browser salvata. Se una chiave d’ambiente nasconde la sessione browser che volevi usare, Muse Code te lo segnala. Dentro una sessione, /login riapre le opzioni di accesso, e muse logout cancella la sessione e la chiave salvate, ma non una META_API_KEY esportata nella shell: quella devi rimuoverla tu.
Due dettagli utili per la CI. muse exec esce con codice 0 quando il turno finisce, il che non significa che il lavoro sia corretto: subordina i merge ai tuoi test. E sui runner Linux la sandbox richiede bubblewrap e una build non musl; sulle immagini basate su Alpine i comandi di shell non partono. Il nostro prontuario dei comandi elenca gli altri flag di muse exec.
Quanto costa una chiave API in Muse Code
Una chiave è a consumo: ogni token viene fatturato alle tariffe della Model API, separatamente da qualsiasi piano mensile. Secondo la documentazione di Meta sugli abbonamenti, l’uso tramite chiavi API aggiuntive viene fatturato così anche se sei abbonato: una chiave nella tua CI non intacca la quota del tuo piano. L’addebito scatta quando il saldo raggiunge una soglia di pagamento e il primo di ogni mese per l’importo residuo; la dashboard Usage mostra dove sono finiti i token, e il pulsante Pay now nella pagina Billing permette di saldare in anticipo.
Due cose che una chiave non può fare: non dà accesso a Muse Wonder Full, disponibile solo sui piani Power e Maximum, e non include la quota a richieste dei piani.
Prezzi per modello
Per 1M di token, dalla pagina prezzi di Meta al 25 ottobre 2026:
| Modello | Input | Input in cache | 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 |
Il modello Contributor è lo stesso Muse Spark 1.3 a una frazione del prezzo, perché Meta può usare i dati per addestrare i modelli futuri. Non esiste una versione Contributor di Muse Wonder. Muse Image costa 0,01 $ a immagine, e il grounding con ricerca web aggiunge 2,50 $ ogni 1.000 ricerche. Il nostro calcolatore trasforma i volumi di token in una bolletta mensile, e Contributor vs Standard affronta il lato privacy di questa scelta.
Limiti di frequenza
I limiti valgono per team, non per chiave: creare più chiavi non aumenta il throughput.
| Modello | Richieste / minuto | Token / 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 |
Le 150 richieste al minuto del modello Contributor sono il limite da tenere d’occhio se ci fai girare sopra molti agenti in parallelo.
Chiamare direttamente la Model API
L’API parla i formati che gli altri strumenti già usano. Per i client in stile OpenAI l’URL di base è https://api.meta.ai/v1; per quelli in stile Anthropic è https://api.meta.ai, senza /v1. Una prima richiesta:
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 stessa chiave funziona in OpenCode, Codex e Claude Code con le configurazioni riportate nella nostra documentazione. Se le chiamate iniziano a fallire, https://api.meta.ai/v1/status riporta lo stato dell’API e la disponibilità di ogni modello, senza bisogno di chiave.
Tenere al sicuro la chiave
- Conservala nell’archivio di segreti della CI o in un password manager, mai nel repository né in
AGENTS.md. - Usa una chiave per ogni posto in cui vive, così puoi revocare una chiave di CI trapelata senza bloccare il tuo portatile.
- Passala come variabile d’ambiente solo al comando che ne ha bisogno, come nell’esempio di
muse execqui sopra, invece di esportarla in un profilo di shell condiviso. - Se una chiave trapela, eliminala dalla dashboard e creane una nuova: potrebbe farti lievitare la bolletta.