Scalar Agent 定价与计费完全指南:本地免费额度、生产消息计费与 Token 计费实战解析

原创2026-09-13 23:26:421,829 阅读
文章标签:开发工具API 工具前端

Scalar Agent 定价与计费完全指南:本地免费额度、生产消息计费与 Token 计费实战解析

Scalar Agent 将 OpenAPI 文档转换为可供 LLM 调用的智能接口,其计费模型分为本地开发免费与生产环境按量计费两套体系。本篇指南以仓库中 Agent Pricing 文档 为主体,完整梳理免费层额度、Keys 消息计费、agent.scalar.com Token 计费、Seat 概念与 FAQ 常见问题,并结合 API Reference 的 agent 配置项与源码实现,帮助你精确预估成本、正确配置生产环境,并在不需要时彻底禁用 Agent 以避免扣费。

免费层:开箱即用的本地开发体验

Scalar Agent 在 localhost 上开箱即用,无需任何配置即可体验完整功能。免费层包含:

  • 每个会话(session)10 条免费消息
  • 完整的聊天功能(full chat functionality)
  • 无需任何 API Key

这一设计非常适合在提交生产环境之前,先对 Agent 进行测试和探索。从源码层面看,这一行为有明确的实现依据:API Reference 中的 use-agent.ts 通过 isLocalUrl(window.location.href) 判断当前页面是否运行在本地地址,从而默认启用 Agent 界面;而当页面不在本地地址时,Agent 默认不启用,需要显式配置才可开启。

对应地,在 Agent in Scalar API Reference 中给出了本地开发的最小示例:

Scalar.createApiReference('#app', {
  url: '/openapi.json',
})

本地运行时聊天图标(sparkle 图标)会出现在 API Reference 界面的左上角。

生产环境定价:以订阅为基础,按消息或 Token 计量

一旦进入生产部署,Agent 要求你持有 Scalar Pro 或 Business 订阅。具体费用取决于你使用 Agent 的方式:通过 Keys(在 API References 或 Docs 中嵌入聊天)按消息条数计费,通过 agent.scalar.com(托管聊天)则按 Token 用量计费。

Keys:按消息条数计费

当你在 API References 或 Docs 中使用 Agent 时,用量按消息条数(message count)计费:

套餐 价格 包含消息数 额外消息
Scalar Pro $150/月(含 5 个席位) 250 条 $0.02/条
Scalar Business $600/月(含 10 个席位) 1,000 条 $0.02/条

定价示例

以下是 Scalar Pro 套餐在不同消息量下的实际支出:

总消息数 包含消息数 额外消息数 总费用
250 250 0 $150(基础价格)
1,000 250 750 $150 + (750 × $0.02) = $165
5,000 250 4,750 $150 + (4,750 × $0.02) = $245

可以看到,只要控制在包含额度内,月费即为基础订阅价;超出部分按每条 $0.02 线性累加。

生产环境中通过 Keys 启用 Agent 的配置方式,在 Agent in Scalar API Reference 中有完整示例——Agent Key 与 Registry 中特定的 OpenAPI 文档绑定,配置到 sources 数组对应条目的 agent.key 字段即可:

Scalar.createApiReference('#app', {
  sources: [
    {
      url: 'https://registry.scalar.com/@your-namespace/apis/your-api/latest?format=json',
      agent: {
        key: 'your-agent-scalar-key',
      },
    },
  ],
})

关于如何获取 Agent Key,见 How to get an Agent key:在 dashboard.scalar.com/registry 让 Registry 与你的 OpenAPI 文档保持同步。

agent.scalar.com:按 Token 用量计费

agent.scalar.com 的托管聊天按 Token 用量计费,输入(input)与输出(output)Token 合并计量:

套餐 价格 包含 Token 数 额外输入 额外输出
Scalar Pro $150/月(含 5 个席位) 2,000,000 $2/百万 $10/百万
Scalar Business $600/月(含 10 个席位) 8,000,000 $2/百万 $10/百万

计费细则:

  • 包含额度: 每个计费周期包含 2,000,000 Token。
  • 超额费用: 每额外输入 Token $0.000002(即 $2/百万输入 Token),每额外输出 Token $0.00001(即 $10/百万输出 Token)。

输出 Token 的单价比输入高 5 倍,因此在设计 Agent 提示词与期望输出时,控制生成长度对控制成本有直接且显著的影响。

什么是 Seat(席位)?

Seat 指一位拥有编辑器访问权限的团队成员。Pro 套餐包含 5 个席位,Business 套餐包含 10 个席位。Seat 数量直接关系到团队协作规模,超出包含席位则产生额外的 Member fees(见下文)。

什么是 "Member、Usage 与 Service Fees"?

账单上可能出现三类费用,含义如下:

  • Member fees(成员费): 超出套餐包含最小席位数的额外席位费用。
  • Usage fees(用量费): 超额用量费用,基于消息条数(Keys)或 Token(agent.scalar.com)计算。
  • Service fees(服务费): 团队自行选择的可选附加项或服务。

什么算作一条消息(Message)?

当通过 Keys 在 References 或 Docs 中使用 Agent 时,一条消息定义为 Agent 生成的一次响应。你收到的每一条回答计为一条消息。而 Agent Web(即 agent.scalar.com)按 Token 计费,不按消息数计费——这是两种计费口径最容易混淆的地方。

结合 API Reference 的 agent 配置理解计费开关

在 Agent in Scalar API Reference 的配置参考表中,agent 配置项接受以下属性,它们直接决定了 Agent 的启用状态、计费起点与可取消的用量入口:

属性 类型 默认值 说明
key string undefined 你的 Agent Key
disabled boolean false 启用或禁用 Agent
hideAddApi boolean false 隐藏添加更多 API 的控件,仅展示预加载或 Registry 中的 API

在**多数据源(per-source)**场景下,每个 source 可配置独立的 Key:

Scalar.createApiReference('#app', {
  sources: [
    {
      url: 'https://registry.scalar.com/@your-namespace/apis/first-api/latest?format=json',
      agent: {
        key: 'key-for-first-api',
      },
    },
    {
      url: 'https://registry.scalar.com/@your-namespace/apis/second-api/latest?format=json',
      agent: {
        key: 'key-for-second-api',
      },
    },
  ],
})

在**全局(global)**场景下,可以一次性对所有数据源禁用 Agent:

Scalar.createApiReference('#app', {
  agent: {
    disabled: true,
  },
  sources: [
    { url: '/api/v1/openapi.json' },
    { url: '/api/v2/openapi.json' },
  ],
})

需要留意的是:没有 Key 时,生产环境中的聊天控件不会出现。这意味着生产页面不会意外产生消息计费——计费从你显式配置 Key 的那一刻才开始。

与其他 Agent 入口的计费口径

Agent 的计费并非只存在于 References/Docs 聊天与 agent.scalar.com 两处。在 MCP Servers 文档中,官方对两个 MCP 表面的计费口径做了明确区分,可作为理解整个 Agent 计费体系的补充:

  • Docs MCP(https://your-docs-domain/mcp):查询按 Agent 消息计费(对应 Keys 计费口径),与文档内 Ask AI 小组件的费率一致,可在 Dashboard 的账单用量页面查看明细。
  • Installation MCP(https://mcp.scalar.com/mcp/YOUR_INSTALL_ID):目前不计费;官方正在推进一套统一的 credits(积分)体系,未来将统一文档聊天、API 聊天与 MCP 工具的计费。

从仓库中的 Scalar 定价总览 可以看到,Agent Scalar 的积分体系在各套餐中的配额为:Free 50 credits、Pro 500 credits、Business 2,000 credits、Enterprise 自定义。1 credit 对应 200 次 MCP 工具调用、2 条 Docs 聊天消息或 50,000 Token——这为理解 Agent 的整体计费模型提供了一个统一的换算基准。

常见问题(FAQ)

未使用的消息或 Token 会结转吗?

不会。包含的消息与 Token 每个计费周期重置,未用完的部分不滚动累积。

超出限额会发生什么?

  • Keys: 额外消息按每条 $0.02 计费,Agent 会持续工作、不会中断。你无需担心服务被掐断,但需要留意超额费用的累积。
  • agent.scalar.com: 额外 Token 按 $2/百万输入、$10/百万输出计费,同样持续工作、不会中断。

如何彻底禁用 Agent 以避免费用?

可以完全禁用,包括在 localhost 上。在 Agent in Scalar API Reference 的 Disabling Agent 一节中提供了全局禁用配置:

Scalar.createApiReference('#app', {
  agent: {
    disabled: true,
  },
})

设置 disabled: true 后,Agent 的聊天控件不再渲染,自然也不会产生任何消息或 Token 计费。

成本控制要点小结

综合以上定价规则,在部署 Scalar Agent 到生产环境前,建议按以下清单做成本评估:

  1. 区分计费口径:References/Docs 中通过 Keys 嵌入的聊天按消息计费($0.02/条,Pro 含 250 条);agent.scalar.com 按 Token 计费(输入 $2/百万、输出 $10/百万,Pro 含 2,000,000 Token)。两者超额费率结构不同,选择入口前先估算你的典型对话规模。
  2. 控制输出 Token:输出 Token 单价是输入的 5 倍,精简 Agent 回复长度对降低超额费用最有效。
  3. 按需配置 Key:生产环境没有 Key 时不显示聊天控件、不会计费;只有显式配置 agent.key 后才开始产生消息用量。
  4. 关注每周期重置:包含消息与 Token 均不结转,适合按周期评估实际用量是否匹配套餐额度。
  5. 可随时全局禁用:agent.disabled: true 可彻底关闭 Agent(含 localhost),是预算管控的最后一道保险。

相关深入阅读:Agent 定价原文、Agent in Scalar API Reference、Agent Keys 获取指南、MCP 计费口径、Scalar 套餐总览。

登录后查看全文
scalar