HƯỚNG DẪN· 5 phút đọc

Muse Code API key: cách tạo, dùng trong CI và giá bao nhiêu

Muse Code đăng nhập được bằng trình duyệt hoặc API key, và key này cũng là cửa vào Meta Model API. Hướng dẫn tạo key, biến môi trường mà từng công cụ cần (META_API_KEY hay MODEL_API_KEY), base URL, giá theo token, rate limit và những lỗi hay khiến hóa đơn tăng vọt.

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

Một key, hai công dụng

Một Meta Model API key làm được hai việc. Nó dùng để đăng nhập Muse Code — coding agent chạy trong terminal của Meta — thay cho luồng đăng nhập qua trình duyệt, đây là cách thường dùng cho CI, server và script. Nó cũng gọi thẳng được Meta Model API, tức chính các model mà Muse Code đang chạy, từ code của bạn hoặc từ các coding agent khác.

Hai công dụng này đọc key từ hai biến môi trường khác nhau, và đây là chỗ nhiều người vấp:

Bạn đang dùng… Biến Ghi chú
Muse Code CLI (muse, muse exec) META_API_KEY Hoặc lưu một lần bằng muse auth set
Model API từ code của bạn, OpenCode hoặc Codex MODEL_API_KEY Tên dùng trong ví dụ của Meta; SDK không tự đọc biến này nên phải truyền vào rõ ràng
Claude Code chạy model của Meta ANTHROPIC_AUTH_TOKEN Đặt giá trị là Model API key của bạn

Tạo key

  1. Đăng nhập dashboard Meta Model API tại dev.meta.ai bằng tài khoản Meta developer.
  2. Mở tab API keys và bấm Create API key.
  3. Đặt tên nói rõ key sẽ nằm ở đâu — ci-github-actions dễ hiểu hơn nhiều so với key1 — rồi bấm Create.
  4. Copy ngay. Meta chỉ hiển thị key đúng một lần.

Key bắt đầu bằng LLM_, tiếp theo là một ID dạng số và phần secret. Nếu tài khoản của bạn được tạo qua luồng đăng ký Business & Enterprise của Meta, bạn hoàn toàn không đăng nhập bằng trình duyệt được, nên API key là cách duy nhất để dùng Muse Code — hãy nhờ admin của team tạo giúp.

Dùng với Muse Code

Trên máy cá nhân, bạn có thể lưu key một lần:

muse auth set

Ở mọi nơi khác, nhất là CI, hãy inject key từ secret store dưới tên META_API_KEY:

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

Muse Code tìm thông tin đăng nhập theo thứ tự cố định: META_API_KEY trước, rồi đến key đã lưu, sau cùng là phiên đăng nhập trình duyệt đã lưu. Nếu key trong biến môi trường đang che mất phiên trình duyệt mà bạn định dùng, Muse Code sẽ báo cho bạn. Trong một phiên, /login mở lại các tùy chọn đăng nhập; muse logout xóa phiên và key đã lưu — nhưng không xóa META_API_KEY bạn đã export trong shell, phần đó bạn phải tự unset.

Có hai chi tiết về CI đáng biết. muse exec trả exit code 0 khi lượt chạy kết thúc, nhưng thế không có nghĩa là kết quả đúng, nên hãy chặn merge bằng test của chính bạn. Còn trên runner Linux, sandbox cần bubblewrap và bản build không phải musl; image dựa trên Alpine sẽ không chạy được lệnh shell. Bảng lệnh CLI của chúng tôi liệt kê các flag khác của muse exec.

Dùng API key trong Muse Code tốn bao nhiêu

Key tính tiền theo mức dùng thực tế: mọi token đều tính theo giá Model API, tách riêng khỏi gói tháng. Tài liệu về gói đăng ký của Meta ghi rõ lượng dùng qua các API key bổ sung được tính theo cách này kể cả khi bạn có đăng ký gói, nên key đặt trong CI sẽ không trừ vào hạn mức của gói. Tiền bị trừ khi số dư chạm ngưỡng thanh toán và vào ngày đầu mỗi tháng cho phần còn lại; dashboard Usage cho thấy token đã đi đâu, còn nút Pay now trên trang Billing cho phép thanh toán sớm.

Có hai thứ key không làm được: nó không truy cập được Muse Wonder Full — model chỉ có ở gói Power và Maximum — và không đi kèm hạn mức tính theo request của các gói.

Giá theo từng model

Giá mỗi 1M token, theo trang giá của Meta ngày 25 tháng 10 năm 2026:

Model Input Input đã 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 vẫn là Muse Spark 1.3 nhưng giá chỉ bằng một phần nhỏ, vì Meta có thể dùng dữ liệu để train model sau này. Muse Wonder không có bản Contributor. Muse Image giá $0.01 mỗi ảnh, còn grounding bằng web search cộng thêm $2.50 mỗi 1,000 lượt tìm kiếm. Công cụ ước tính của chúng tôi quy đổi lượng token ra hóa đơn hằng tháng, còn bài Contributor vs. Standard bàn về mặt quyền riêng tư của lựa chọn này.

Rate limit

Giới hạn áp theo team chứ không theo key, nên tạo thêm key không giúp tăng throughput:

Model Request / phút Token / phút
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

Mức 150 request mỗi phút của model Contributor là con số cần để ý nếu bạn tỏa ra nhiều agent song song trên nó.

Gọi thẳng Model API

API hỗ trợ sẵn các định dạng mà công cụ khác đang dùng. Với client kiểu OpenAI, base URL là https://api.meta.ai/v1; với client kiểu Anthropic thì là https://api.meta.ai, không có /v1. Request đầu tiên:

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

Cùng một key dùng được trong OpenCode, Codex và Claude Code với cấu hình có trong tài liệu của chúng tôi. Nếu request bắt đầu lỗi, https://api.meta.ai/v1/status cho biết tình trạng API và trạng thái từng model mà không cần key.

Giữ key an toàn

  • Lưu key trong secret store của CI hoặc trình quản lý mật khẩu, tuyệt đối không để trong repository hay trong AGENTS.md.
  • Mỗi nơi dùng một key riêng, để khi key CI bị lộ bạn thu hồi được mà không làm hỏng máy laptop.
  • Truyền key dưới dạng biến môi trường chỉ cho đúng lệnh cần nó, như ví dụ muse exec ở trên, thay vì export trong shell profile dùng chung.
  • Nếu key bị lộ, hãy xóa nó trong dashboard và tạo key mới — người khác có thể đốt tiền trên tài khoản của bạn.
Đọc tiếp
Bắt đầu với Muse Code: từ cài đặt đến lần merge đầu tiên →Contributor hay Standard: làm phép tính chọn bậc giá →Một API, mọi harness: nước cờ hệ sinh thái của Model API →