API Meta Muse: Những gì nhà phát triển thực sự nhận được, và những mô hình Muse mà nó phục vụ

Không có sản phẩm nào thực sự có tên là Muse API. API phục vụ các mô hình Muse của Meta là Meta Model API, nó phản hồi tại https://api.meta.ai/v1, và các mô hình Muse mà nhà phát triển có thể gọi trên đó là Muse Spark 1.3 (mô hình mà Meta hiện đang khuyến nghị), Muse Spark 1.2 và Muse Spark 1.1 — hai mô hình cuối là những mô hình mà trang này định tuyến, dưới dạng meta/muse-spark-1.1 và meta/muse-spark-1.2. Nếu bạn tìm kiếm "muse api" với mong muốn có một câu trả lời ngắn gọn, thì đó chính là câu trả lời. Phần còn lại của trang này là những chi tiết đằng sau: mỗi mô hình tốn bao nhiêu cho mỗi triệu token theo bảng giá đã công bố của Meta, bạn cần có sẵn những gì trước lần gọi đầu tiên, giới hạn tốc độ thực chất được đo dựa trên cái gì, và vì sao các con số trên thẻ đăng ký Muse Code không chuyển sang hóa đơn API.

Hãy đọc trang này như một trang tham chiếu hơn là tin tức. Meta Model API đã hoạt động và các mô hình Muse trên đó có thể gọi được ngay hôm nay; không có gì ở đây là thông báo, và chưa có trang nào trên blog này từng trả lời câu hỏi về truy cập lập trình cho dòng mô hình này. Khi một số liệu đến từ tài liệu của chính Meta, trang này nói rõ điều đó; còn khi Meta không công bố gì, trang này nói như vậy thay vì lấp đầy chỗ trống.

"Meta Muse API" thực sự là gì

Định nghĩa của chính Meta chỉ là một câu: Model API là "nền tảng suy luận cho các mô hình mới nhất từ Meta, bao gồm Muse Wonder và Muse Spark." Dòng Muse được lưu trữ trên nền tảng đó chứ không phải trên một API riêng của nó, đó là lý do việc tìm kiếm một endpoint dành riêng cho Muse không dẫn đến đâu — endpoint thuộc về Meta, và Muse là một họ mô hình trên đó.

Bề mặt này mang tính quy ước một cách có chủ đích. Ba định dạng yêu cầu được tài liệu hóa thuộc cái mà Meta gọi là các bề mặt Model API: Responses API, Chat Completions API và Messages API. Tuyên bố tích hợp nổi bật là Model API "tương thích thay thế trực tiếp với OpenAI SDK, Anthropic SDK và các agent CLI tương thích OpenAI," cùng với câu đi kèm rằng "không có client tùy chỉnh nào cần học." Trên thực tế, điều đó có nghĩa là chỉ cần đổi base-URL và một khóa, chứ không phải viết lại.

Nền tảng này phục vụ không chỉ riêng dòng Spark. Bên cạnh muse-spark-*, nó còn cung cấp muse-wonder-1.0, muse-image-1.0, muse-voice-transcribe-1.0 và sam-3.1, nhờ đó một người đọc đang xây dựng pipeline hỗn hợp có thể truy cập tính năng tạo ảnh, phiên âm và phân đoạn chỉ với cùng một thông tin xác thực. Có một thành viên trong gia đình Muse hoàn toàn không thể gọi được: Muse Glimmer là một mô hình trọng số mở "được xây dựng để chạy trên phần cứng của chính bạn", được phân phối dưới dạng trọng số thay vì được phục vụ trên API, và Meta loại nó khỏi endpoint danh sách models. Nếu câu hỏi của bạn là "liệu tôi có thể gọi Glimmer không", thì câu trả lời là không — bạn tải nó về.

Hai thứ mà người ta thường gộp chung vào "Muse API" thực chất là những sản phẩm riêng biệt và thuộc về các trang khác. Muse Code là agent lập trình của Meta dành cho terminal và CI — một harness được bán theo dạng thuê bao, phát hành dưới dạng bản beta vào ngày 2026-08-05 và được đưa ra khỏi beta vào ngày 2026-08-31 — và nó không phải là API, không phải là model, cũng không bắt buộc phải có để gọi API. Trang muse-code của blog này đề cập đến harness, còn meta-muse-code-terminal-coding-agent đi sâu vào agent. Phần trình bày sau đây chỉ bàn về bề mặt lập trình.

Các mô hình bạn có thể gọi và mức giá đã công bố của Meta

Sáu ID đóng vai trò quan trọng đối với việc tạo văn bản, và các mức giá dưới đây là của chính Meta, được công bố trên trang định giá và giới hạn tốc độ của họ, tính bằng đô-la Mỹ trên mỗi triệu token. Đây là giá niêm yết của nhà cung cấp, không phải các số liệu được kiểm toán độc lập.

• muse-spark-1.3 — Meta gọi nó là "phiên bản mới nhất, được tinh chỉnh cho các quy trình làm việc tác nhân" và gắn nhãn nó là "Được đề xuất cho công việc mới." Ngữ cảnh 1.048.576 token. Chế độ Tiêu chuẩn: đầu vào $1,25, đầu ra $4,25, đầu vào được lưu vào bộ nhớ đệm $0,15.

• muse-spark-1.2 — Trang mô hình của Meta mô tả nó một cách đơn giản là "phiên bản trước đó." Vẫn ngữ cảnh 1.048.576 token, vẫn mức giá Tiêu chuẩn.

• muse-spark-1.1 — "phiên bản gốc", và chỉ ở chế độ Standard. Cùng cửa sổ ngữ cảnh, lại cùng mức giá Standard.

• muse-spark-1.3-contributor và muse-spark-1.2-contributor — gói được giảm giá: $0.10 cho đầu vào, $0.20 cho đầu ra, $0.002 cho đầu vào được lưu trong bộ nhớ đệm. Không có biến thể Contributor của 1.1.

• muse-wonder-1.0 — mô hình Muse có năng lực mạnh nhất của Meta, được định vị cho các tác vụ agentic dài hạn: 4,00 USD cho đầu vào, 20,00 USD cho đầu ra, 0,20 USD cho đầu vào được lưu trong bộ đệm, chỉ hỗ trợ chế độ Standard, và Meta nói rõ rằng "chế độ Contributor không khả dụng cho Muse Wonder trên Model API."

• Các mô hình Muse phi văn bản được tính giá theo đơn vị thay vì theo token: Muse Image ở mức $0,01 mỗi ảnh, Muse Voice Transcribe ở mức $0,18 mỗi giờ, và SAM 3.1 ở mức $2,50 mỗi 1.000 hình ảnh và $0,20 mỗi 1.000 khung hình. Grounding tìm kiếm web, nếu bạn bật tính năng này, có giá $2,50 mỗi 1.000 truy vấn tìm kiếm.

Hai nhận định chung nằm dưới bảng đó và đáng để biết trước khi bạn định cỡ một khối lượng công việc. Nhận định thứ nhất là "Đầu vào được lưu đệm có chi phí thấp hơn" — các lượt đọc được lưu đệm có chi phí chỉ khoảng một phần mười so với đầu vào trên Standard Spark, và một phần năm mươi trên Contributor. Nhận định thứ hai là "Không có phụ phí cho ngữ cảnh dài", điều này quan trọng ở đây hơn so với trên hầu hết các nền tảng vì cửa sổ của dòng Spark là 1.048.576 token; một tài liệu dài không đẩy bạn sang một mức giá khác.

Về câu hỏi mà bản tóm tắt cho trang này kỳ vọng sẽ là một sự đối chiếu: giữa meta/muse-spark-1.1 và meta/muse-spark-1.2 không có gì để chọn về cửa sổ hay về mức giá. Meta công bố một con số ngữ cảnh cho dòng này và một hàng giá bao trùm “muse-spark-1.3 / 1.2 / 1.1”. Điều phân biệt chúng là checkpoint — 1.2 là bản mới hơn — và, trên nền tảng của Meta, việc có một biến thể Contributor cho 1.2 còn 1.1 thì không. Bất cứ ai nói với bạn rằng hai bản khác nhau về độ dài ngữ cảnh hay về giá thì không phải đang đọc cùng những tấm thẻ.

Những gì bạn cần có trong tay để thực hiện cuộc gọi đầu tiên

Mọi nội dung trong phần này đều lấy từ tài liệu của chính Meta. Ở những chỗ mà đáng lẽ sẽ có điều Meta không nói, trang này để khoảng trống lộ rõ thay vì bịa ra một cấu trúc yêu cầu có vẻ hợp lý.

Nhận quyền truy cập

Quyền truy cập là một tài khoản Model API cộng với một khóa. Hướng dẫn nhanh của Meta chỉ bạn đến bảng điều khiển: “Lấy khóa từ bảng điều khiển Model API → API keys → Create API key.” Trang xác thực bổ sung phần mà mọi người thường bỏ sót: “Sao chép khóa ngay lập tức. Bạn chỉ nhìn thấy nó một lần.” Một khóa được hiển thị theo dạng LLM|607358788350350|nx9.....LJY, và Meta không bao giờ giải thích các phân đoạn đó có ý nghĩa gì. Bạn có thể thu hồi một khóa từ cùng bảng điều khiển đó — “Xóa một khóa không ảnh hưởng đến các khóa khác của nhóm” — đây là lập luận của Meta cho việc cấp một khóa cho mỗi ứng dụng thay vì dùng chung một khóa.

Lược đồ xác thực

Bearer token, trong tiêu đề Authorization:

• Tiêu đề — Authorization: Bearer $MODEL_API_KEY

• URL cơ sở — https://api.meta.ai/v1, với https://api.meta.ai được ghi tài liệu cho các harness định dạng Anthropic

• Biến môi trường — MODEL_API_KEY, mà Meta hướng dẫn bạn nên thiết lập thay vì hard-code, cùng với lời khuyên quen thuộc "đừng bao giờ commit khóa vào hệ thống quản lý phiên bản"

• Lưu ý dành cho client — Meta nói thẳng rằng "OpenAI SDK không tự động đọc MODEL_API_KEY," nên bạn hoặc truyền api_key một cách rõ ràng hoặc export OPENAI_API_KEY bằng khóa Meta của bạn

Các endpoint được nêu trong tài liệu tham chiếu của Meta bao gồm POST /v1/chat/completions và POST /v1/responses cho văn bản, /v1/images/generations và /v1/images/edits cho Muse Image, POST /v1/asr/transcribe cùng một websocket thời gian thực tại wss://api.meta.ai/v1/asr/realtime để phiên âm, và POST /v1/files để tải lên. Không có SDK nào do Meta công bố: trang SDK liệt kê các client OpenAI và Anthropic, và quan điểm của Meta là khả năng tương thích chứ không phải một thư viện bên thứ nhất. Nếu bạn đang chờ một gói meta để cài đặt, thì không có gói nào như vậy.

Giới hạn tần suất, và chúng được đo dựa trên cái gì

Đây là câu hỏi mà người tìm kiếm "muse code api key" thường thực sự muốn hỏi, và Meta trả lời nó chính xác hơn hầu hết các nhà cung cấp. Các giới hạn được công bố là theo team, chứ không phải theo từng key: "Các key trong cùng một team chia sẻ giới hạn tốc độ." Hai kỹ sư tạo hai key không nhân đôi mức trần — họ chia đôi nó.

• muse-spark-1.3, muse-spark-1.2, muse-spark-1.1 — 3.000 yêu cầu mỗi phút và 4.000.000 token mỗi phút

• Các biến thể Contributor — 150 yêu cầu mỗi phút và 3.000.000 token mỗi phút

• muse-wonder-1.0 — 3.000 RPM và 4.000.000 TPM; muse-image-1.0 — 150 RPM không giới hạn token

• Phản hồi chạy nền — mức trần riêng là 600 lượt gửi mỗi phút cho mỗi nhóm

• Khi vi phạm — HTTP 429 với tiêu đề Retry-After, và các phản hồi chứa x-ratelimit-limit-tokens, x-ratelimit-remaining-tokens, x-ratelimit-limit-requests và x-ratelimit-remaining-requests

Một khóa API Muse Code và một khóa API Model là cùng một loại thông tin xác thực. Lần chạy đầu tiên của Muse Code yêu cầu bạn chọn đăng nhập bằng trình duyệt hoặc dán khóa API — “Đối với script và CI, hãy dùng khóa API” — và thứ tự tra cứu được tài liệu hóa của nó là META_API_KEY trước, rồi đến khóa đã lưu, sau đó là phiên trình duyệt đã lưu, trong đó khóa API luôn được ưu tiên hơn đăng nhập bằng trình duyệt.

Mô hình tính phí: token theo mức sử dụng, không phải theo chỗ ngồi

Đây là phần mà người đọc hay hiểu sai, nên đáng để nói thẳng. Gói đăng ký Muse Code là một suất cố định hàng tháng kèm bảng giá; Model API là tiêu dùng được đo đếm trên một tài khoản. Trang xác thực của Meta nêu rõ mô hình này — “Việc tính phí Meta Model API dựa trên mức sử dụng: bạn được tính phí cho các token mà yêu cầu của bạn tiêu thụ” — với đầu vào và đầu ra được tính riêng, đầu ra thường tốn kém hơn, và mức giá thay đổi tùy theo mô hình. Tiền sẽ được trừ khi số dư của bạn đạt ngưỡng thanh toán, và phần còn lại sẽ được tính tự động vào ngày đầu tiên của tháng. Meta nói thêm rằng “không có mức tối thiểu hay cam kết trả trước.”

Một điểm bất đối xứng giữa hai sản phẩm rất dễ khiến người ta vấp. Meta nêu rõ rằng Muse Code “các gói đăng ký mặc định ở chế độ Contributor, và bạn có thể bật hoặc tắt nó trong phần cài đặt.” Trên API, mặc định lại ngược lại: bạn nhận mức giá Standard và điều khoản Standard trừ khi bạn chủ động chỉ định một model id -contributor. Vì vậy, một người đọc vốn đã chạy Muse Code theo điều khoản Contributor suốt thời gian qua rồi sau đó thay bằng một key tại muse-spark-1.2 sẽ rơi vào bảng giá Standard với mức giá đầu vào cao hơn khoảng mười hai lần, mà không thay đổi bất cứ thứ gì ngoại trừ client.

Điều Meta không nêu rõ là liệu một gói đăng ký có cho bạn quyền sử dụng API nào hay không. Không có gì trên trang xác thực, trang giá hoặc trang sản phẩm nói rằng một gói bao gồm token hay credit của Model API; trang API coi khóa thuần túy như một phương thức xác thực, còn các trang đăng ký là một chủ đề riêng. Đừng cho rằng hai thứ đó có thể hoán đổi cho nhau, và đừng lấy con số hàng tháng của gói đăng ký áp sang ngân sách token — chúng đang trả lời những câu hỏi khác nhau.

Về gói miễn phí: không có gói miễn phí nào được tài liệu hóa cho Model API, không có tín dụng dùng thử và không có hạn mức miễn phí. Trang sản phẩm của coding agent cũng không liệt kê gói miễn phí nào. Chế độ Contributor được giảm giá, không phải miễn phí — cách Meta diễn đạt là giá đã giảm “để đổi lấy quyền sử dụng nội dung của bạn nhằm huấn luyện các mô hình Meta trong tương lai”, bao gồm các prompt, mã, tệp và ngữ cảnh bạn gửi cùng các phản hồi bạn nhận về. Đó là một sự trao đổi, không phải cho không. Nếu một trang nói với bạn rằng Meta Muse API có gói miễn phí, thì trang đó không đọc trang định giá của Meta.

Thuộc tính này định tuyến những gì

Chúng tôi cung cấp hai mô hình từ dòng này và tuyên bố về tính khả dụng trên trang này được cố ý giới hạn hẹp. Cả hai hiện đều đang hoạt động trong danh mục: meta/muse-spark-1.1 và meta/muse-spark-1.2. Cả hai đều có cùng cửa sổ ngữ cảnh 1.048.576 token như Meta công bố và 1.2 là checkpoint muộn hơn. Mức giá đã công bố của chúng tôi cho chúng là giá niêm yết của Meta được chuyển tiếp với mức markup 0% — 1,25 USD mỗi triệu token đầu vào, 4,25 USD mỗi triệu token đầu ra và 0,15 USD mỗi triệu lượt đọc từ bộ nhớ đệm — đó chính là toàn bộ ý nghĩa của một thỏa thuận chuyển tiếp: thay đổi mức giá từ nhà cung cấp sẽ có hiệu lực ở đây ngay trong cùng ngày, mà không cần chúng tôi định giá lại.

Điều đó mang lại cho nhà phát triển không phải là một khoản giảm giá; mà là bớt đi một lần tích hợp. Muse Spark nằm phía sau một endpoint duy nhất bao phủ hơn 200 mô hình, nên việc thêm nó vào một pipeline không phải là hợp đồng thứ hai, khóa thứ hai hay quan hệ thanh toán thứ hai, và một yêu cầu thất bại với một nhà cung cấp sẽ tự động chuyển sang nhà cung cấp khác thay vì hiển thị lỗi 429 cho người dùng của bạn. Điều đó càng quan trọng hơn mức thông thường với một cuộc hoán đổi mô hình chưa được kiểm chứng: đó là cách đưa meta/muse-spark-1.2 vào một khối lượng công việc thực tế trước khi cam kết đi theo hướng đó.

Hai thứ không thể định tuyến ở đây và trang này sẽ không làm nhẹ điều đó. meta/muse-spark-1.3 không có trong danh mục của chúng tôi — nếu bạn cần 1.3, hãy liên hệ trực tiếp với Meta. Và meta/muse-code hoàn toàn không phải là ID mô hình, dù trên nền tảng của Meta hay của chúng tôi, vì Muse Code là một harness chứ không phải một mô hình; nó không thể là đích định tuyến. Các checkpoint thuộc cấp Contributor cũng không được định tuyến ở đây.

Những gì Meta không tài liệu hóa

Có một vài điều mà một lập trình viên hẳn sẽ mong đợi một cách hợp lý lại hoàn toàn vắng mặt trong tài liệu API của Meta, và phiên bản trung thực của trang này nói thẳng điều đó thay vì phác họa chúng ra.

• Tổ chức và dự án — không có khái niệm tổ chức hay dự án trên trang xác thực, không có phân cấp, và không có cách nào để giới hạn phạm vi một khóa cho một tổ chức hoặc dự án. Cách nhóm duy nhất mà Meta mô tả là một đội.

• Phạm vi của khóa — không có bộ quyền, không có giới hạn theo từng tài nguyên, không có khóa chỉ đọc. Mọi khóa đều là khóa toàn quyền, đó là lý do lời khuyên của chính Meta là dùng một khóa cho mỗi ứng dụng.

• Thời hạn của khóa và việc luân chuyển khóa — việc thu hồi đã được ghi tài liệu (xóa nó trong bảng điều khiển); việc luân chuyển chỉ là khuyến nghị ("thu hồi và luân chuyển ngay lập tức"), không có thời hạn hết hiệu lực, TTL hay quy trình chuyển khóa ở bất kỳ đâu.

• SDK bên thứ nhất — không có bản nào được phát hành; {{1}}tuyên bố về khả năng tương thích chính là câu chuyện tích hợp, và Meta không nói rằng sẽ có một bản như vậy.{{/1}}

• Sử dụng miễn phí — không có gói miễn phí, không có credit, không có bản dùng thử, như trên.

• Một API id cho Muse Glimmer — trang models không liệt kê id nào và Meta loại nó khỏi endpoint models, vì nó được phát hành dưới dạng trọng số.

Nếu lý do bạn tìm kiếm điều này là một trong những khoảng trống đó, thì câu trả lời là thông tin ấy không được công bố, và một trang kém hơn hẳn sẽ đoán bừa một cơ chế giới hạn phạm vi khóa hay một endpoint luân chuyển rồi để bạn tự phát hiện ra phỏng đoán đó lúc 2 giờ sáng. Với những gì đã được công bố, bức tranh đã đủ đầy đủ để xây dựng dựa trên đó: một base URL thông thường tại https://api.meta.ai/v1, một khóa Bearer do chính bạn tạo, khả năng tương thích thay thế trực tiếp với các client O​penAI và A​nthropic, giới hạn tốc độ theo từng nhóm được ghi trong tài liệu, và một bảng giá trong đó hai checkpoint Muse Spark mà trang này phục vụ giống hệt nhau cả về cửa sổ lẫn giá.

Trang muse-code của blog này bao quát harness một cách chuyên sâu; trang này chỉ là bề mặt lập trình.

Những khoảng trống như thế này cũng là nơi các dạng lỗi hỏng lộ diện: các sự cố AI và lỗi tác nhân đã được ghi nhận liên quan đến các mô hình thuộc lớp này được tập hợp trong Kho lưu trữ Sự cố AI OrcaRouter, nơi mỗi mục đều mang nguồn riêng, mức độ nghiêm trọng, xếp hạng độ tin cậy và cờ tranh chấp.