免费模型

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

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

模型 ID

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

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

谁能调用

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

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

限额

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

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

{
  "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 给出的秒数后重试。见错误码。

与付费模型的区别

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

试一个

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." }]
}'

图片和视频

没有免费的图片或视频模型。这些模型按任务计费，见快速指南。