> ## Documentation Index
> Fetch the complete documentation index at: https://glasser.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 工作原理

> 了解 Glasser 如何获取数据、为 Run 计费，以及控制访问权限。

无论通过 Agent、MCP、CLI 还是 HTTP 使用 Glasser，均适用相同规则。

## 从请求到数据

Glasser 让你访问专业**数据提供商**的付费数据。一个**接口** 对应数据提供商的一项操作，有各自的输入 Schema、版本和价格。使用 Glasser API Key 即可访问，无需单独注册各家数据提供商账号。

1. **搜索**符合需求的接口。
2. **检查**输入 Schema 和当前价格。
3. **运行**接口以获取数据。Glasser 将结果和费用记录在一个 **Run** 中。

搜索和检查均免费。对于预定义任务， [Solutions](https://glasser.ai/docs/zh/api-reference/solutions/overview.md) 可以为你选择接口并转换输入。两种方式使用相同的 Run 和工作空间余额。

## 理解价格

检查接口时，可以看到以下计费规则：

* \*\*成功结果：\*\*固定费用，或按结果数、token 等用量计费，并设有上限。
* \*\*其他结果：\*\*无结果、数据提供商错误、超时和内部失败分别适用各自的规则，对应 `NO_RESULT`、`PROVIDER_ERROR`、`TIMED_OUT`、`INTERNAL`。

新 Run 使用受理时的价格，直至结算完成。接口版本不会锁定未来 Run 的价格。

金额为精确的美元十进制字符串，例如 `"0.005"`。相加时请使用十进制运算，避免浮点运算。

## Run 状态

创建 Run 前，Glasser 会检查权限和可用余额，并按最高费用 **预留余额**。被拒绝的请求不会创建 Run，也不会产生费用。 Run 完成后，Glasser 会结清预留余额并记录最终费用。

| 状态 | 含义 |
| - | - |
| `QUEUED` | 已受理，等待分派。 |
| `RUNNING` | 正在执行。 |
| `COMPLETED` | 已收到数据提供商响应并完成结算，响应中可能包含错误。 |
| `FAILED` | 未获得可用的数据提供商响应。原因见 `failure`。 |
| `STOPPED` | 已在分派前停止，不收费。 |

分派后请求停止，不会取消数据提供商正在执行的操作。请检查返回状态和最终费用，详见[停止 Run](https://glasser.ai/docs/zh/api-reference/runs/stop.md)。

## 检查结果与费用

请分别检查以下字段：

| 字段 | 说明 |
| - | - |
| `status` | Run 仍在运行，还是已经结束。 |
| `provider_response` | 数据提供商返回的是数据还是错误。返回 404 或 500 的 Run 也可能为 `COMPLETED`。 |
| `charge_usd` | Run 的费用。`FAILED` 状态的 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 的允许。搜索会排除无权访问的接口；检查这些接口时返回未找到。

## 充值与赠送余额

在[余额页面](https://app.glasser.ai/balance?utm_source=docs\&utm_medium=how-it-works\&locale=zh-CN)充值。 API、CLI 和 MCP 均不能充值。

| 方式 | 说明 |
| - | - |
| 充值 | 使用银行卡付款，也可配置自动充值。 |
| 邀请 | 分享邀请链接。新用户注册后，双方工作空间均获得赠送余额；新用户充值并运行后，邀请方还可获得一笔奖励。 |
| 分享 Run | 将 `COMPLETED` 状态的 Run 分享到 X 或 LinkedIn，再提交帖子链接领取赠送余额。需曾经充值。 |

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

## 四种入口，同一套规则

[HTTP API](https://glasser.ai/docs/zh/api-reference/endpoints/search.md)、[CLI](https://glasser.ai/docs/zh/cli.md)、 [MCP 服务器](https://glasser.ai/docs/zh/mcp-server.md)和 Agent Skill 使用相同的执行、计费和 Policy 规则。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.