> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# 免费模型

> 不按 token 收费的文本模型：如何识别、谁能调用，以及限额是多少。

# 免费模型

ID 以 `-free` 结尾的模型是免费的：没有每 token 的价格。每个免费模型都是与其付费同系模型相互独立的 ID，所以请发送带 `-free` 的准确 ID。

* 下面列出五个免费文本模型，另外[决策 API](/decisions) 上的 `jev-1.14-free` 也是免费的。图片和视频模型没有免费 ID。
* 只要密钥所在分组能访问免费分组，包括默认的 `auto` 分组，任何密钥都可以调用，余额为零、尚未首次充值也行。
* 每个账户首次充值前每分钟限 1 次成功请求，充值后最多每分钟 10 次。
* 免费模型随时可能被限流或下线。不要搭建依赖它们的生产链路。

## 模型 ID

这是公开目录（`GET /v1/text/models`，系列 `free`）中的列表。

| 免费模型 ID                                                                   | 付费同系模型                   | 系列页面                                            |
| ------------------------------------------------------------------------- | ------------------------ | ----------------------------------------------- |
| [`glm-5.3-free`](/text-api/glm/chat-completions)                          | `glm-5.3`                | [GLM](/text-api/glm/chat-completions)           |
| [`glm-5.3-flash-free`](/text-api/glm/chat-completions)                    | `glm-5.3-flash`          | [GLM](/text-api/glm/chat-completions)           |
| [`deepseek-v4.1-flash-free`](/text-api/deepseek/chat-completions)         | `deepseek-v4.1-flash`    | [DeepSeek](/text-api/deepseek/chat-completions) |
| [`deepseek-v4-flash-0731-free`](/text-api/deepseek/chat-completions)      | `deepseek-v4-flash-0731` | [DeepSeek](/text-api/deepseek/chat-completions) |
| `gemini-3.8-flash-free`（见 [Gemini](/text-api/gemini/chat-completions) 页面） | `gemini-3.8-flash`       | [Gemini](/text-api/gemini/chat-completions)     |

发送付费同系模型的 ID 是另一笔独立的计费请求。

## 谁能调用

* 任何有效的、所在分组能访问免费分组的密钥。默认 `auto` 分组中的密钥可以。
* 余额为零没有问题，从未充值的账户也可以。
* 响应中的 `model` 字段带 `-free` 名称。

使用免费额度的账户只能调用免费档列表中的模型，免费 ID 都在该列表内。`GET /v1/free-tier` 无需密钥即可返回该列表。充值后限制解除。

## 限额

| 账户状态    | 每分钟成功请求数 |
| ------- | -------- |
| 首次充值前   | 1        |
| 任意一次充值后 | 最多 10    |

* 限额统计成功的请求。失败的请求，或失败的流，会归还名额。它限制的是你调用的频率，而不是同时运行的调用数。
* 免费调用与你的付费限额分开计数，所以不会消耗付费限额，付费限额也不会消耗它们。
* 当你账户当前这一分钟的常规限额已用完时，免费模型仍可能被拒绝。

触达限额时，返回 `429 rate_limit_exceeded`，带 `Retry-After` 响应头和 `retry_after_seconds`。请等待相应秒数后再重试。错误信息会写明限额；以下是从未充值的账户收到的原文：

```json
{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded: this model allows at most 1 successful requests per minute per account. Retry after 60 seconds. Accounts that have topped up get a higher per-minute limit.",
    "retryable": true,
    "request_id": "req_abc123",
    "retry_after_seconds": 60
  }
}
```

充值后，错误信息变为 `at most 10 successful requests per minute`，并去掉最后一句。错误码与普通账户限额使用的相同，所以请读错误信息来区分。等待 `Retry-After` / `retry_after_seconds` 给出的秒数后重试。见[错误码](/errors#text-endpoints)。

## 与付费模型的区别

* **不公布上下文和输出上限。** 目录中的免费条目省略了上下文窗口、输出上限和价格。付费同系模型的上下文窗口和输出上限不对免费 ID 作承诺。
* **不保证推理能力。** `thinking` 和 `reasoning_effort` 等仅付费模型可用的选项，行为可能与付费模型不同。
* **格式可能不同。** 例如 `glm-5.3-free` 不支持 `/v1/responses`。使用 Chat Completions 之外的格式前，请先看系列页面。
* **速度和可用性可能不同。** 免费模型可能更慢、被限流或不经通知下线，也不承诺每日额度。
* **没有缓存输入价格。** 免费 ID 完全不按 token 计费。

## 试一个

**`cURL`**

```bash title="cURL"
curl --request POST \
  --url https://api.beatapi.io/v1/chat/completions \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "glm-5.3-flash-free",
  "messages": [{ "role": "user", "content": "Say hello in one sentence." }]
}'
```

## 图片和视频

没有免费的图片或视频模型。这些模型按任务计费，见[快速指南](/quick-guide)。