首页 / API 开发 / Muse Spark API 教程：开发者入门

Muse Spark API 教程：开发者入门

更新于 2026-09-10 · API 开发 · 阅读约 4 分钟

Muse 背后的 Muse Spark 模型，开发者可以通过 Meta Model API 直接调用：OpenAI 兼容接口、每百万 token 输入 1.25 美元 / 输出 4.25 美元，还有 20 美元免费额度。这篇是开发者上手的最短路径。

先搞清三个名字

Muse：给普通人用的个人 Agent 产品（App / 网页 / WhatsApp）。
Muse Spark：底层的模型系列，Agent 任务专用，有 1M token 超长上下文。
Meta Model API：在 dev.meta.ai 上开放的开发者 API，按量付费，OpenAI 接口兼容。

上手四步

注册：打开 dev.meta.ai，用 Meta 账号注册开发者账号。
领免费额度：公开预览期提供 20 美元免费额度，够跑不少实验。额度直接打到你的开发者账户，可在控制台查看余额。
创建 API Key：在控制台生成 Key，妥善保管，别进代码仓库。
发起第一次调用：接口兼容 OpenAI 格式，用你熟悉的 OpenAI SDK 就能调，把 base_url 换成官方文档中的地址即可：

```python from openai import OpenAI client = OpenAI( api_key="你的 Meta Model API Key", base_url="〈见 dev.meta.ai 官方文档中的 API 地址〉", ) resp = client.chat.completions.create( model="muse-spark", messages=[{"role": "user", "content": "用一句话介绍你自己"}], ) print(resp.choices[0].message.content) ```

价格与规格速览

输入 $1.25 / 百万 token，输出 $4.25 / 百万 token，免费额度 $20。
上下文窗口 100 万 token，适合整仓库代码分析、长文档处理。
原生支持并行 subagent 与 computer use，Agent 类应用不用自己造轮子。
据第三方实测介绍，早期合作方包括 Replit、Cline、Box 等（报道口径）。
公开预览期政策可能调整，动手前以 dev.meta.ai 控制台的最新说明为准。

Muse Spark 1.1 的关键能力

100 万 token 上下文：整仓库代码、几百页文档一次读完。
多模态输入：文本、图像、音频都能吃，输出为文本。
并行 subagent：长任务自动拆分子任务并行跑，上下文跨会话保持。
Computer use：内置的计算机操作能力，Agent 场景不用自己造轮子。
Thinking 模式：在 Meta AI App / meta.ai 里切到 Thinking 模式就能免费体验，不花钱先验货。

进阶：从调用到 Agent

调通第一次调用后，下一步建议：

试长上下文：扔一份几十页的 PDF 进去做问答，感受 1M 窗口的差异。
试 subagent：给它一个多步骤任务（如"分析这个仓库并输出重构建议"），观察它如何拆解和并行。
看 cookbook：Meta 官方的 meta-model-cookbook 里有各模型的实战 recipe，是很好的起手模板。
算成本：按你的输入输出比例，用 $1.25 / $4.25 的单价估算月成本，再决定生产环境怎么配。

适合做什么

长文档问答、代码库级分析、多步骤 Agent 任务是对口场景。图像理解、语音转写也有专门的模型与文档（如 Muse Image、Voice Transcribe）。刚起步的话，先从 cookbook 里的 recipe 改起，比从零写快得多。纯聊天的轻量需求，用 Meta AI App 里免费的 Thinking 模式就行，不必走 API。

常见问题

免费额度怎么领？

和直接用 Muse App 有什么区别？

App 是开箱即用的产品；API 是给你自己做产品的原材料，按调用量计费。

支持中文吗？

模型本身多语言，中文任务可用；复杂 Agent 流程建议自己实测验证。

100 万上下文有什么用？

一次塞进整个代码仓库或几百页文档做问答，这是短上下文模型做不到的。

价格和 GPT 系列比怎么样？

$1.25 / $4.25 的定价主打"够强且便宜"，具体划算与否看你的输入输出配比，跑个基准测试最实在。

参考文献

本文更新于 2026 年 9 月；Muse 仍在快速迭代，功能与价格以 Meta 官方最新说明为准。