API key Muse Code: cara membuat, pakai di CI, dan berapa harganya
Muse Code bisa login lewat browser atau API key, dan key yang sama juga jadi pintu masuk ke Meta Model API. Cara membuat key, environment variable yang dibaca tiap tool (META_API_KEY vs. MODEL_API_KEY), base URL, harga per token, rate limit, dan kesalahan yang bikin tagihan membengkak.
Satu key, dua kegunaan
Meta Model API key punya dua fungsi. Pertama, untuk login ke Muse Code, coding agent berbasis terminal dari Meta, sebagai pengganti alur login browser — pilihan standar untuk CI, server, dan script. Kedua, untuk memanggil Meta Model API secara langsung, yaitu model yang sama yang dipakai Muse Code, dari kode kamu sendiri atau dari coding agent lain.
Kedua kegunaan ini membaca key dari environment variable yang berbeda, dan di sinilah banyak orang terjebak:
| Yang kamu pakai… | Variabel | Catatan |
|---|---|---|
Muse Code CLI (muse, muse exec) |
META_API_KEY |
Atau simpan sekali saja dengan muse auth set |
| Model API dari kode kamu, OpenCode, atau Codex | MODEL_API_KEY |
Nama yang dipakai di contoh-contoh Meta; SDK tidak membacanya otomatis, jadi oper secara eksplisit |
| Claude Code dengan model Meta | ANTHROPIC_AUTH_TOKEN |
Isi dengan Model API key kamu |
Membuat key
- Login ke dashboard Meta Model API di dev.meta.ai dengan akun developer Meta kamu.
- Buka tab API keys lalu klik Create API key.
- Beri nama yang menjelaskan di mana key itu akan dipakai —
ci-github-actionsjauh lebih jelas daripadakey1— lalu klik Create. - Langsung salin. Meta hanya menampilkan key satu kali.
Key diawali LLM_, diikuti ID berupa angka dan bagian rahasianya. Kalau akun kamu dibuat lewat pendaftaran Business & Enterprise dari Meta, login lewat browser sama sekali tidak tersedia, jadi API key adalah satu-satunya cara memakai Muse Code — minta admin tim untuk membuatkannya.
Memakainya di Muse Code
Di mesin sendiri, kamu bisa menyimpan key sekali saja:
muse auth setDi tempat lain, terutama CI, inject key dari secret store sebagai META_API_KEY:
META_API_KEY="$MUSE_KEY" muse exec --json "fix the failing test in tests/date.test.ts"Muse Code mencari kredensial dengan urutan tetap: META_API_KEY dulu, lalu key yang tersimpan, terakhir sesi browser yang tersimpan. Kalau key dari environment menutupi sesi browser yang sebenarnya ingin kamu pakai, Muse Code akan memberi tahu. /login membuka lagi opsi login dari dalam sesi, dan muse logout menghapus sesi dan key yang tersimpan — tapi tidak menghapus META_API_KEY yang kamu export di shell, jadi unset sendiri.
Ada dua detail CI yang perlu kamu tahu. muse exec keluar dengan code 0 saat giliran selesai, dan itu belum tentu berarti hasilnya benar, jadi jadikan test kamu sendiri sebagai syarat merge. Lalu di runner Linux, sandbox butuh bubblewrap dan build non-musl; image berbasis Alpine tidak akan bisa menjalankan perintah shell. Daftar perintah CLI kami memuat flag muse exec lainnya.
Berapa biaya API key di Muse Code
Key bersifat pay-as-you-go: setiap token ditagih dengan tarif Model API, terpisah dari paket bulanan apa pun. Dokumentasi langganan Meta menyebutkan pemakaian lewat API key tambahan ditagih dengan cara ini meskipun kamu juga berlangganan, jadi key di CI kamu tidak akan memotong kuota paket. Tagihan ditarik saat saldo mencapai batas pembayaran dan setiap tanggal satu untuk sisanya; dashboard Usage menunjukkan ke mana saja token terpakai, dan tombol Pay now di halaman Billing untuk melunasi lebih awal.
Ada dua hal yang tidak bisa dilakukan key: tidak bisa mengakses Muse Wonder Full, yang hanya ada di paket Power dan Maximum, dan tidak mendapat kuota berbasis request seperti di paket.
Harga per model
Per 1M token, dari halaman harga Meta per 25 Oktober 2026:
| Model | Input | Input ter-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 |
Model Contributor adalah Muse Spark 1.3 yang sama dengan harga jauh lebih murah, karena Meta boleh memakai datanya untuk melatih model berikutnya. Muse Wonder tidak punya versi Contributor. Muse Image dihargai $0.01 per gambar, dan grounding web search menambah $2.50 per 1,000 pencarian. Kalkulator kami mengubah volume token jadi perkiraan tagihan bulanan, dan Contributor vs. Standard membahas sisi privasi dari pilihan ini.
Rate limit
Batasnya berlaku per tim, bukan per key, jadi membuat key tambahan tidak menambah throughput:
| Model | Request / menit | Token / menit |
|---|---|---|
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 |
Batas 150 request per menit di model Contributor yang perlu kamu waspadai kalau menyebar banyak agent paralel di atasnya.
Memanggil Model API langsung
API ini mendukung format yang sudah dipakai tool lain. Untuk client bergaya OpenAI, base URL-nya https://api.meta.ai/v1; untuk client bergaya Anthropic, https://api.meta.ai, tanpa /v1. Request pertama:
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"}]}'Key yang sama bisa dipakai di OpenCode, Codex, dan Claude Code dengan konfigurasi di dokumentasi kami. Kalau panggilan mulai gagal, https://api.meta.ai/v1/status melaporkan kesehatan API dan ketersediaan tiap model tanpa perlu key.
Jaga key tetap aman
- Simpan di secret store CI atau password manager, jangan pernah di repository atau di
AGENTS.md. - Pakai satu key untuk tiap tempat, supaya kalau key CI bocor kamu bisa mencabutnya tanpa merusak setup di laptop.
- Oper sebagai environment variable hanya untuk satu perintah yang membutuhkannya, seperti contoh
muse execdi atas, alih-alih meng-export-nya di shell profile bersama. - Kalau key bocor, hapus di dashboard dan buat yang baru — key itu bisa menumpuk tagihan di akun kamu.