跳转到主要内容
无论通过 Agent、MCP、CLI 还是 HTTP 使用 Glasser,均适用相同规则。

从请求到数据

Glasser 让你访问专业数据提供商的付费数据。一个接口 对应数据提供商的一项操作,有各自的输入 Schema、版本和价格。使用 Glasser API Key 即可访问,无需单独注册各家数据提供商账号。
  1. 搜索符合需求的接口。
  2. 检查输入 Schema 和当前价格。
  3. 运行接口以获取数据。Glasser 将结果和费用记录在一个 Run 中。
搜索和检查均免费。对于预定义任务, Solutions 可以为你选择接口并转换输入。两种方式使用相同的 Run 和工作空间余额。

理解价格

检查接口时,可以看到以下计费规则:
  • **成功结果:**固定费用,或按结果数、token 等用量计费,并设有上限。
  • **其他结果:**无结果、数据提供商错误、超时和内部失败分别适用各自的规则,对应 NO_RESULT、PROVIDER_ERROR、TIMED_OUT、INTERNAL。
新 Run 使用受理时的价格,直至结算完成。接口版本不会锁定未来 Run 的价格。 金额为精确的美元十进制字符串,例如 "0.005"。相加时请使用十进制运算,避免浮点运算。

Run 状态

创建 Run 前,Glasser 会检查权限和可用余额,并按最高费用 预留余额。被拒绝的请求不会创建 Run,也不会产生费用。 Run 完成后,Glasser 会结清预留余额并记录最终费用。 分派后请求停止,不会取消数据提供商正在执行的操作。请检查返回状态和最终费用,详见停止 Run。

检查结果与费用

请分别检查以下字段:

重试时避免再次扣费

发生超时或连接中断后,使用同一个幂等键重试,即可获取原 Run,而不会启动新的 Run 或再次扣费。
  • 保持 provider、endpoint、input 和 endpoint_version 不变。
  • 使用同一个键但修改上述执行参数,会返回冲突。
  • 只有准备启动新 Run 时,才使用新键。
修改 task_id 或 metadata 不会创建新 Run,也不会更新原 Run。重试时,MCP 响应还会包含 replayed: true;HTTP API 和 CLI 返回的 Run 不包含此字段。

API Key 与 Policy

API Key 属于一个工作空间。Run 使用该工作空间的余额。 接口必须同时获得工作空间 Policy 和 API Key Policy 的允许。搜索会排除无权访问的接口;检查这些接口时返回未找到。

充值与赠送余额

在余额页面充值。 API、CLI 和 MCP 均不能充值。 赠送余额不会过期,使用方式与其他余额相同。每个新建工作空间都会获得注册赠送余额。邀请和分享奖励按工作空间设有累计上限;控制台会显示当前金额和上限。这类余额在余额记录中的 kind 为 grant。

四种入口,同一套规则

HTTP API、CLI、 MCP 服务器和 Agent Skill 使用相同的执行、计费和 Policy 规则。