我们能帮您什么?
搜索解答、配置指南和文档——或给我们写信。
服务状态 正在检查模型状态… 模型与状态
入门
从注册到您的第一个请求。
如何获取 API 密钥?
注册——新账户可获得 1.3M+ 个免费 token。账户有余额后,您的 API 密钥会立即显示在仪表盘中。请立即复制:它只显示一次。
我应该使用哪个基础 URL?
OpenAI 兼容的 SDK 和工具使用 https://api.cheaptokens.dev/v1。Anthropic 兼容的客户端(包括 Claude Code)使用根地址 https://api.cheaptokens.dev 并自行添加路径。如果您的客户端自行添加 /v1,也请给它根地址。
如何发出我的第一个请求?
将您的密钥放入 CHEAPTOKENS_API_KEY 环境变量,然后运行下面的请求。快速入门会为 Python、Node 和 Anthropic SDK 构建相同的代码片段,并使用您选择的模型。
curl https://api.cheaptokens.dev/v1/chat/completions \
-H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "zai-org/GLM-5.3-Flash",
"messages": [{"role": "user", "content": "Hello"}]
}' 如何连接 Cursor、Cline、Claude Code 或其他工具?
任何支持 OpenAI 或 Anthropic API 的工具都可以使用:设置基础 URL、粘贴您的密钥并添加模型 ID。每份指南都会展示这些设置在工具中的位置。
我应该选择哪个模型?
所有模型都使用相同的密钥和相同的地址——要切换,只需更改模型 ID。模型页面上的每张卡片都会列出上下文窗口、最大输出和价格。
- GLM-5.3-Flash 适合复杂编程与推理
- DeepSeek-V4-Flash 适合日常任务,经济实惠
- MiniMax-M2.7 适合智能体与工作流自动化
还有问题? 向我们提问
连接工具
选择你的工具或 SDK,仅查看其所需的设置。示例中的密钥为占位符——请在工具中粘贴你自己的密钥。
Cursor 兼容 OpenAI
Cursor — 在 Cursor Settings → Models 中,将您的密钥粘贴到 OpenAI API Key,开启 Override OpenAI Base URL 并将模型 ID 添加为自定义模型。根据 Cursor 的文档,自有密钥仅适用于聊天模型;Tab 补全功能将继续使用 Cursor 的模型。
- 基础 URL
-
https://api.cheaptokens.dev/v1 - API 密钥
-
YOUR_CHEAPTOKENS_KEY以Authorization: Bearer <key>形式发送。 - 模型 ID
-
zai-org/GLM-5.3-Flash
请使用带 /v1 的地址:SDK 或工具会自行添加 /chat/completions。
# Cursor Settings → Models → API Keys
OpenAI API Key: YOUR_CHEAPTOKENS_KEY
Override OpenAI Base URL: https://api.cheaptokens.dev/v1
# Models list → add this ID as a custom model:
Model: zai-org/GLM-5.3-Flash Cline 兼容 OpenAI
Cline — 选择一个兼容 OpenAI 的提供商,设置基础 URL 和密钥。
- 基础 URL
-
https://api.cheaptokens.dev/v1 - API 密钥
-
YOUR_CHEAPTOKENS_KEY以Authorization: Bearer <key>形式发送。 - 模型 ID
-
zai-org/GLM-5.3-Flash
请使用带 /v1 的地址:SDK 或工具会自行添加 /chat/completions。
# Cline → Settings → API Provider: OpenAI Compatible
Base URL: https://api.cheaptokens.dev/v1
API Key: YOUR_CHEAPTOKENS_KEY
Model ID: zai-org/GLM-5.3-Flash 在哪里找到这些设置
Claude Code 兼容 Anthropic
Claude Code — 导出以下变量(地址不含 /v1)并运行 claude。
- 基础 URL
-
https://api.cheaptokens.dev - API 密钥
-
YOUR_CHEAPTOKENS_KEY以x-api-key: <key>形式发送;Authorization: Bearer <key>同样可用。 - 模型 ID
-
zai-org/GLM-5.3-Flash
使用不带 /v1 的根地址:客户端会自行添加 /v1/messages。
# Claude Code → cheaptokens (Anthropic-compatible)
export ANTHROPIC_BASE_URL="https://api.cheaptokens.dev"
export ANTHROPIC_API_KEY="YOUR_CHEAPTOKENS_KEY"
export ANTHROPIC_MODEL="zai-org/GLM-5.3-Flash"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="zai-org/GLM-5.3-Flash" OpenClaw 兼容 OpenAI 或 Anthropic
OpenClaw — 将下方的提供商条目添加到 ~/.openclaw/openclaw.json。在全新安装时,使用 Custom provider 选项运行 openclaw onboard 即可写入相同的条目。
- 基础 URL · 兼容 OpenAI
-
https://api.cheaptokens.dev/v1 - 基础 URL · 兼容 Anthropic
-
https://api.cheaptokens.dev - API 密钥
-
YOUR_CHEAPTOKENS_KEY以Authorization: Bearer <key>形式发送。以x-api-key: <key>形式发送;Authorization: Bearer <key>同样可用。 - 模型 ID
-
zai-org/GLM-5.3-Flash
OpenAI 风格请求使用带 /v1 的地址;Anthropic 风格请求使用根地址。
// ~/.openclaw/openclaw.json — add cheaptokens as a provider
{
models: {
providers: {
cheaptokens: {
baseUrl: "https://api.cheaptokens.dev/v1",
apiKey: "YOUR_CHEAPTOKENS_KEY",
api: "openai-completions",
models: [{ id: "zai-org/GLM-5.3-Flash", name: "GLM-5.3-Flash" }],
},
},
},
agents: {
defaults: { model: { primary: "cheaptokens/zai-org/GLM-5.3-Flash" } },
},
}
// Anthropic-style requests instead? In the provider entry use:
// api: "anthropic-messages", baseUrl: "https://api.cheaptokens.dev" Aider 兼容 OpenAI
Aider — 传入 --openai-api-base 和 --openai-api-key(或使用环境变量)。
- 基础 URL
-
https://api.cheaptokens.dev/v1 - API 密钥
-
YOUR_CHEAPTOKENS_KEY以Authorization: Bearer <key>形式发送。 - 模型 ID
-
zai-org/GLM-5.3-Flash
请使用带 /v1 的地址:SDK 或工具会自行添加 /chat/completions。
export OPENAI_API_BASE="https://api.cheaptokens.dev/v1"
export OPENAI_API_KEY="YOUR_CHEAPTOKENS_KEY"
aider --model openai/zai-org/GLM-5.3-Flash Kilo Code 兼容 OpenAI
Kilo Code — 选择兼容 OpenAI 的提供商,设置基础 URL、密钥和模型 ID。
- 基础 URL
-
https://api.cheaptokens.dev/v1 - API 密钥
-
YOUR_CHEAPTOKENS_KEY以Authorization: Bearer <key>形式发送。 - 模型 ID
-
zai-org/GLM-5.3-Flash
请使用带 /v1 的地址:SDK 或工具会自行添加 /chat/completions。
# Kilo Code → Settings → API Provider: OpenAI Compatible
Base URL: https://api.cheaptokens.dev/v1
API Key: YOUR_CHEAPTOKENS_KEY
Model ID: zai-org/GLM-5.3-Flash Python · OpenAI 兼容 OpenAI
- 基础 URL
-
https://api.cheaptokens.dev/v1 - API 密钥
-
YOUR_CHEAPTOKENS_KEY以Authorization: Bearer <key>形式发送。 - 模型 ID
-
zai-org/GLM-5.3-Flash
请使用带 /v1 的地址:SDK 或工具会自行添加 /chat/completions。
from openai import OpenAI
client = OpenAI(
base_url="https://api.cheaptokens.dev/v1",
api_key="YOUR_CHEAPTOKENS_KEY",
)
resp = client.chat.completions.create(
model="zai-org/GLM-5.3-Flash",
messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content) Node · OpenAI 兼容 OpenAI
- 基础 URL
-
https://api.cheaptokens.dev/v1 - API 密钥
-
YOUR_CHEAPTOKENS_KEY以Authorization: Bearer <key>形式发送。 - 模型 ID
-
zai-org/GLM-5.3-Flash
请使用带 /v1 的地址:SDK 或工具会自行添加 /chat/completions。
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.cheaptokens.dev/v1",
apiKey: process.env.CHEAPTOKENS_API_KEY,
});
const resp = await client.chat.completions.create({
model: "zai-org/GLM-5.3-Flash",
messages: [{ role: "user", content: "Hello" }],
});
console.log(resp.choices[0].message.content); Python · Anthropic 兼容 Anthropic
- 基础 URL
-
https://api.cheaptokens.dev - API 密钥
-
YOUR_CHEAPTOKENS_KEY以x-api-key: <key>形式发送;Authorization: Bearer <key>同样可用。 - 模型 ID
-
zai-org/GLM-5.3-Flash
使用不带 /v1 的根地址:客户端会自行添加 /v1/messages。
from anthropic import Anthropic
client = Anthropic(
base_url="https://api.cheaptokens.dev",
api_key="YOUR_CHEAPTOKENS_KEY",
)
msg = client.messages.create(
model="zai-org/GLM-5.3-Flash",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello"}],
)
print(msg.content[0].text) curl 兼容 OpenAI
- 基础 URL
-
https://api.cheaptokens.dev/v1 - API 密钥
-
YOUR_CHEAPTOKENS_KEY以Authorization: Bearer <key>形式发送。 - 模型 ID
-
zai-org/GLM-5.3-Flash
请使用带 /v1 的地址:SDK 或工具会自行添加 /chat/completions。
curl https://api.cheaptokens.dev/v1/chat/completions \
-H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "zai-org/GLM-5.3-Flash",
"messages": [{"role": "user", "content": "Hello"}]
}' 快速参考:地址、密钥请求头、模型 ID、限额
- OpenAI 兼容基础 URL
https://api.cheaptokens.dev/v1- Anthropic 兼容基础 URL
https://api.cheaptokens.dev- API 密钥请求头
Authorization: Bearer <key>Anthropic 客户端:x-api-key- 模型 ID
zai-org/GLM-5.3-Flashdeepseek-ai/DeepSeek-V4-Flash-0731MiniMaxAI/MiniMax-M2.7
- 速率限制
- 每个密钥每分钟 120 次请求
余额和支付
按量付费,使用同一个美元余额。
付款是如何运作的?
没有订阅。您充值美元余额,每次请求按该模型每百万输入和输出 token 的固定费率扣费。一个余额即可覆盖所有模型。
如何充值?
在仪表盘中点击 充值,选择以美元计价的金额。使用加密货币支付(无需 KYC)或通过合作伙伴使用银行卡支付——资金会自动计入您的余额。
我的付款仍在处理中
我付款了,但余额没有变化
充值失败并出现错误
余额用完后会怎样?
还有问题? 向我们提问
API 与错误
状态码的含义以及如何修复。
401 API 密钥无效
API 无法识别该密钥:可能是输入错误、属于其他服务,或已被替换——在 轮换密钥 之后,旧密钥将停止工作。
- 检查
- 你的工具中的密钥是当前密钥,不含空格、引号或换行,且请求头完全为
Authorization: Bearer <key>(Anthropic 客户端:x-api-key)。 - 修复
- 重新粘贴当前密钥。丢失了?在仪表盘中按 轮换密钥,并在所有使用该密钥的地方更新。
- 确认可以正常工作
- 发送一个简短请求:返回答案而非 401 即表示密钥有效。
- 仍然失败?请发送给我们
- 请求时间、工具或 SDK 以及错误文本——切勿发送密钥本身。
402 请求被拒绝:余额不足或没有密钥
请求在到达模型之前就被拒绝,原因有两种。错误文本可以区分它们:Total limit exceeded——余额已用完或不足以完成此请求;no active billing account——请求未携带 API 密钥。
- 检查
- 检查仪表盘中的余额,并确认请求以
Authorization: Bearer <key>形式发送密钥——“Bearer”首字母大写且密钥前有一个空格——或以x-api-key形式发送。小写的bearer或不带“Bearer”的密钥会被视为没有密钥。 - 修复
- 余额已用完:在仪表盘中按 充值——充值到账后同一密钥即可再次使用。没有密钥:将其添加到你的工具或环境变量中,然后重启工具或终端。
- 确认可以正常工作
- 仪表盘中该密钥显示为 已激活,且简短请求能返回答案。
- 仍然失败?请发送给我们
- 如果余额为正且密钥已发送但仍返回 402:请提供请求时间、模型和完整错误文本。
429 请求过多
请求速度超过了允许值。限制为每个 API 密钥每分钟 120 次请求,按一分钟窗口计算。429 也可能表示服务或某个模型暂时繁忙。
- 检查
- 错误文本:
Rate limit exceeded——你的密钥触发了每分钟限额;at capacity、waiting for an available upstream slot或overloaded——服务或模型繁忙。 - 修复
- 等待
Retry-After请求头中的秒数后重试——官方 OpenAI 和 Anthropic SDK 会自动重试 429,默认重试两次。对于智能体,限制并行运行的请求数量;如果某个模型持续繁忙,请切换model字段。 - 确认可以正常工作
- 请求重新返回答案,且在低于限额的稳定速率下 429 不再出现。
- 仍然失败?请发送给我们
- 如果在低请求速率下仍出现 429:请提供时间、模型、你每分钟发送的请求数以及错误文本。
404 · 400 地址错误或找不到模型
404 表示地址错误。提示“not found”的 400 表示 API 不认识该模型 ID。
- 检查
- OpenAI 风格客户端需要带
/v1的地址:确保它没有缺失,也没有因客户端自行添加/v1而重复。模型 ID 必须完整,包含斜杠前的前缀,例如zai-org/GLM-5.3-Flash。 - 修复
- 从本页你的工具的设置中复制地址和模型 ID,或从
GET /v1/models获取 ID。 - 确认可以正常工作
- 一个短请求返回了答案,并且
GET /v1/models列出了相同的 ID。 - 仍然失败?请发送给我们
- 你调用的完整地址、模型 ID 和错误文本。
503 模型暂时不可用
该模型目前无法接受请求。本页顶部的服务状态和模型卡片显示相同的状态。
- 检查
- 查看上方的服务状态:该模型是否被标记为暂时不可用?
- 修复
- 过一分钟再重试请求,并逐渐延长间隔——503 响应没有
Retry-After头;官方 SDK 会自动重试两次。或者将model字段换成另一个模型——密钥和地址保持不变。 - 确认可以正常工作
- 该模型显示为可用,并且一个短请求返回了答案。
- 仍然失败?请发送给我们
- 如果状态显示该模型可用但 503 持续出现:请提供时间、模型和错误文本。
length 回答在句子中间停止
回答达到了长度限制:finish_reason 为 length。未设置 max_tokens 时,非流式回答会在模型的默认长度处停止。
- 检查
finish_reason字段和你发送的max_tokens——文档中列出了每个模型的默认值和最大输出。- 修复
- 设置更大的
max_tokens以获得更长的回答,最大可至该模型的上限,或者流式传输响应:不设置max_tokens时,流式回答最长可达到最大值。 - 确认可以正常工作
- 回答以
finish_reason为stop结束。 - 仍然失败?请发送给我们
- 如果回答以
length结束且远低于你的max_tokens,说明流被中断了——请重试请求,如果问题持续出现,请向我们提供时间、模型和你的max_tokens。
timeout 回答耗时较长或超时
推理模型在回答前会先思考,因此首个 token 可能需要等待一段时间,长回答则需要数分钟。API 最多等待 150 秒,让模型开始回答。
- 检查
- 你是否流式传输响应,以及客户端的超时设置:它应长于 150 秒。
- 修复
- 流式传输响应(
stream: true):token 会在生成时即时到达,keep-alive 消息会保持连接打开。如果不使用流式传输,请将客户端超时保持在 150 秒以上——官方 OpenAI 和 Anthropic SDK 默认等待 10 分钟;在 Claude Code 中是API_TIMEOUT_MS,在 Aider 中是--timeout,在 OpenClaw 中是提供商的timeoutSeconds。如果流式回答中断,请重试请求:中断回答的输出不会计费。 - 确认可以正常工作
- 首批 token 出现在流中,或者完整回答在超时时间内到达。
- 仍然失败?请发送给我们
- 时间、模型、你是否使用流式传输、客户端超时以及回答停止的位置;如果你的工具显示
x-request-id响应头,也请提供。
还有问题? 向我们提问
账户与登录
登录并妥善保管您的密钥。
登录邮件没有收到
我的 API 密钥丢失了
还有问题? 向我们提问
推荐计划
从您邀请的用户充值中赚取收益。
推荐计划如何运作?
分享你的推荐链接。通过该链接注册的用户每次充值余额,你都能获得 10% 的奖励——只要他们一直使用 CheapTokens。
我在哪里可以找到我的推荐链接?
还有问题? 向我们提问
没有找到答案?
给我们发消息——消息会直接送达团队,我们会通过电子邮件回复。
切勿发送您的 API 密钥——我们不需要它来提供帮助。
更倾向于邮件?请写信至 support@cheaptokens.dev。