从请求到数据
Glasser 让你访问专业数据提供商的付费数据。一个接口 对应数据提供商的一项操作,有各自的输入 Schema、版本和价格。使用 Glasser API Key 即可访问,无需单独注册各家数据提供商账号。- 搜索符合需求的接口。
- 检查输入 Schema 和当前价格。
- 运行接口以获取数据。Glasser 将结果和费用记录在一个 Run 中。
理解价格
检查接口时,可以看到以下计费规则:- **成功结果:**固定费用,或按结果数、token 等用量计费,并设有上限。
- **其他结果:**无结果、数据提供商错误、超时和内部失败分别适用各自的规则,对应
NO_RESULT、PROVIDER_ERROR、TIMED_OUT、INTERNAL。
"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。