在 Postman 中向 OpenAI 兼容 API 发出第一个请求

在 Postman 中发送 chat/completions 请求，Bearer key 保存在变量中，并读取回答和 usage 字段。

作者：CheapTokens Team发布于 2026年11月1日4 分钟阅读

Postman 请求 body，包含 model id 和一条 message，用于 CheapTokens API

本页内容

四步完成设置
点击 Send 并读取响应
第一次请求的费用
如果它不工作

你有一个 API key，想在写一行代码之前先看看实际发送和接收的内容。Postman 正好适合做这件事：填入 URL、key 和 JSON body，点击 Send，响应就会出现在下方。对于 CheapTokens，请求是 POST https://api.cheaptokens.dev/v1/chat/completions，使用 Authorization: Bearer key 和一个指定模型的 JSON body。

以下步骤遵循 Postman 官方文档（v12，文档站上的最新版本，检查于 2026 年 10 月 31 日）。如果你更喜欢终端，同样的请求见 Your first API request with CheapTokens。

The request body in Postman: model id, one user message, max_tokens — The raw JSON body of the first request

四步完成设置#

你只需要几样东西：base URL、你的 key、一个 model id 和一条 message。Postman 把前两项保存在变量中，因此 key 永远不会被直接粘贴到请求里。

排序

Put the Postman setup in order

Define the variables base_url and api_key
Create an HTTP request: POST to {{base_url}}/chat/completions
On the Authorization tab choose Bearer Token and enter {{api_key}}
On the Body tab choose raw > JSON, paste the body, press Send

每一步都有几个细节。

创建请求。 点击左侧边栏的 Add 图标，选择 HTTP。方法下拉框默认是 GET，所以把它切换为 POST 并输入 URL。Postman 变量写作 {{variable_name}}；文档用 {{base_url}} 作为示例。把 base_url 定义为 https://api.cheaptokens.dev/v1，URL 字段就变成 {{base_url}}/chat/completions。Postman 把变量存储为字符串，这在这里没问题。

添加 key。 打开 Authorization 标签页，在 Auth Type 下拉框中选择 Bearer Token，并在 Token 字段中填入 {{api_key}}。Postman 会以 Bearer 格式把它作为 Authorization 头发送。文档正是这样建议的：把 token 保存在变量中，并通过名称引用它。为什么这个习惯很重要，见 Store an API key safely。

编写 body。 在 Body 标签页选择 raw，然后在下拉框中选择 JSON。对于 raw body，Postman 会自己设置匹配的 Content-Type，所以你不需要添加该头。粘贴以下内容：

json

{
  "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
  "messages": [
    { "role": "user", "content": "Explain in one sentence what a token is." }
  ],
  "max_tokens": 200
}

model id 是 CheapTokens 文档中的完整 gateway_id；像 deepseek-flash 这样的短名称不会被接受。max_tokens 限制回答的长度，因此首次测试不会运行太久。还有一个 Postman 细节：JSON body 中的 // 和 /* */ 注释会在发送前被剥离，所以你可以为队友在 body 中加注释。

点击 Send 并读取响应#

如果一切正确，响应面板会显示一个 OpenAI Chat Completions 格式的 JSON 对象。有两个地方很重要：

choices[0].message.content 是回答文本。
usage 包含 prompt_tokens（你发送的内容）和 completion_tokens（模型写出的内容）。这是你付费的依据，所以在第一次请求时就要查看它。

还要检查 choices[0].finish_reason。stop 表示模型自行结束；length 表示回答达到了 max_tokens 并被截断。如果你看到这种情况，请提高限制或阅读 AI answer cut off? Fix finish_reason "length"。

在打开答案之前先试一试：

自己试试Try it: you set max_tokens to 5 and press Send. What do you expect in finish_reason?显示答案

你会得到 length：五个 token 不足以构成完整句子，所以回答被截断。把 200 放回去，它就会变成 stop。

第一次请求的费用#

假设上面的请求使用约 30 个输入 token，回答约 100 个输出 token（这是示例，不是实测；你的 usage 字段显示真实数字）。在 DeepSeek-V4-Flash 上，按当前价格计算是 $0.00001，而且价格在任何时段都相同。每 1M token 的价格见 the pricing page 上的实时表格。

同一个 Postman 请求可以尝试另一个模型。只替换 model 行，例如换成 zai-org/GLM-5.3-Flash（390K 上下文，最多 8,192 个输出 token），然后再次点击 Send。一个余额覆盖所有模型，所以其他都不用改：相同的 URL，相同的 key。

如果它不工作#

Postman 会在响应旁边显示状态码。以下是常见嫌疑：

配对

Match the symptom to its cause

401 UnauthorizedThe key is missing, mistyped, or {{api_key}} is empty because the variable isn't defined
404 Not FoundThe URL is wrong: check that base_url ends with /v1 and the path is /chat/completions
An error that mentions the modelThe model id is shortened; use the full id such as deepseek-ai/DeepSeek-V4-Flash-0731

有两个 Postman 特有的地方值得检查。如果你收到 401 或 URL 看起来不对，请检查 base_url 和 api_key 是否在你所选的环境中定义。如果 key 看起来正确但仍然收到 401，请再次打开 Authorization 标签页：Auth Type 必须是 Bearer Token，而不是 No Auth。关于这些状态码的更多信息：API 401 or 404 error。不确定该用哪个 id？List models with GET /v1/models 会返回所有模型。

当你满意时，点击 Save，给请求起个名字并选择一个 collection。下次你只需编辑 content 字段，或编辑 model 行来比较回答。完整的 API 参考见 the CheapTokens docs。

标签: