返回博客

快速开始指南

使用 CheapTokens 发出你的第一个 API 请求

大约五分钟，从新账户到成功发起请求——余额、API 密钥、模型 ID，以及可直接运行的 curl、Python 和 JavaScript 示例。

作者：CheapTokens Team发布于 3 分钟阅读

终端窗口，其中包含发往 api.cheaptokens.dev/v1/chat/completions 的 curl 请求和 JSON 响应
本页内容
  1. 你需要准备什么
  2. 第 1 步：创建账户并充值
  3. 第 2 步：复制 API 密钥
  4. 第 3 步：选择模型
  5. 第 4 步：发送请求
  6. curl
  7. Python
  8. JavaScript
  9. Anthropic 风格的客户端
  10. 如果出了问题
  11. 费用是多少

本指南将带你从新账户走到成功发起请求。你需要一个邮箱地址、少量余额和一个终端。该 API 与 OpenAI 兼容，所以如果你之前调用过 OpenAI，只有两处不同：基础 URL 和密钥。

你需要准备什么#

  • 一个账户。 通过邮箱注册——无需密码，我们会向你发送登录链接。
  • 余额。 没有订阅制：你充值美元余额，每个请求按 token 以模型的固定费率计费。
  • 一个 API 密钥，从你的控制台获取。

第 1 步：创建账户并充值#

打开注册页面，输入你的邮箱并点击邮件中的链接。在控制台中点击 Top up 并选择支付方式：

  • 加密货币 —— 最低 $5；收取 5% 的充值手续费。
  • 银行卡 —— 通过合作方支付，合作方会收取自己的费用。

第 2 步：复制 API 密钥#

一旦余额大于零（充值或获得推荐奖励之后），控制台会自动创建你的 API 密钥并只显示一次。请立即复制，并让它远离你的代码，例如放在环境变量中：

bash
export CHEAPTOKENS_API_KEY="paste-your-key-here"

如果密钥泄露，点击 Rotate：你会获得一个新密钥，旧密钥随即失效。

第 3 步：选择模型#

请求需要完整的模型 ID——包含斜杠前的前缀，与 API 列出的完全一致。撰写本文时（2026 年 10 月）的目录：

模型 API 模型 ID 上下文 最大输出
GLM-5.3-Flash zai-org/GLM-5.3-Flash 390K tokens 8,192 tokens
DeepSeek-V4-Flash deepseek-ai/DeepSeek-V4-Flash-0731 380K tokens 32,768 tokens
MiniMax-M2.7 MiniMaxAI/MiniMax-M2.7 200K tokens 8,192 tokens

目录可能会变化，所以以 API 本身为准。这个请求无需密钥：

bash
curl https://api.cheaptokens.dev/v1/models

第 4 步：发送请求#

curl#

bash
curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Say hello in three languages"}]
  }'

成功的响应会以标准 Chat Completions 格式返回。以下是一个简化的示例——你的文本、ID 和数字会有所不同，响应中可能还带有额外的服务字段：

json
{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Hello! Hola! Bonjour!" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 14, "completion_tokens": 9, "total_tokens": 23 }
}
  • 文本在 choices[0].message.content 中。
  • Token 用量在 usage 中：prompt_tokens —— 输入，completion_tokens —— 输出。请求正是按这两个数字计费。

Python#

用 pip install openai 安装官方 SDK，并将其指向我们的基础 URL：

python
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
)
resp = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4-Flash-0731",
    messages=[{"role": "user", "content": "Say hello in three languages"}],
)
print(resp.choices[0].message.content)
print("tokens in/out:", resp.usage.prompt_tokens, resp.usage.completion_tokens)

JavaScript#

用 npm install openai 安装 SDK：

javascript
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: "deepseek-ai/DeepSeek-V4-Flash-0731",
  messages: [{ role: "user", content: "Say hello in three languages" }],
});
console.log(resp.choices[0].message.content);

Anthropic 风格的客户端#

为 Anthropic Messages API 构建的客户端使用不带 /v1 的根地址——https://api.cheaptokens.dev——并在 x-api-key 请求头中发送密钥。Anthropic SDK 会自行添加路径和请求头；你只需设置基础 URL 和密钥。

如果出了问题#

  • 401 Invalid API key —— 密钥输入错误或已被轮换。检查你是否完整粘贴了它；控制台只显示一次密钥，所以如果丢失了，点击 Rotate 获取新密钥。
  • 402 —— 余额已用尽，或者请求发出时没有带 Authorization 请求头。
  • 400 Model "…" not found —— 使用 /v1/models 中的完整模型 ID，包括斜杠前的前缀。
  • 404 —— 检查地址：OpenAI 风格的客户端需要在基础 URL 末尾加上 /v1。

更多情况和修复方法：常见连接错误及其修复方法。

费用是多少#

每个请求的输入和输出 token 分别按模型每百万 token 的费率计费。当前价格——与定价页面上的数据相同：

模型 上下文 输入 $/1M 输出 $/1M OpenRouter 输入 OpenRouter 输出
GLM-5.3-Flash reasoning 390K $0.027 $0.08 $0.048 $0.20
DeepSeek-V4-Flash 380K $0.0221 $0.10 $0.016 $0.64
MiniMax-M2.7 200K $0.05 $0.15 $0.30 $1.20

价格以每 100 万 token 的美元金额计算。OpenRouter 数据仅供参考，可能会有变动。

下一步：接入一个编码代理，例如 Cline，或者学习估算 AI 代理的成本。

向其他开发者推荐 CheapTokens？通过推荐计划，你可以获得他们充值金额的一定比例。

标签: