怎么测试 API 能不能用？3 个方法验证配置（2026 实测）

配置好 Base URL、API Key 和模型后，先测试一下再用。测试方法很简单：发一条"你好"给 AI，看能不能正常回复。

本文介绍 3 种测试方法，选一个最适合你的。

方法 1：用在线工具测试（最简单）

不用安装软件，打开网页就能测。

用 Hoppscotch 测试

网址：https://hoppscotch.io/

步骤：

打开网站，选择 POST 请求
填写地址：
```
https://你的中转站域名/v1/chat/completions
```
例如：https://api.openai-hk.com/v1/chat/completions
点 Headers 标签，添加 2 行：
- Content-Type 填 application/json
- Authorization 填 Bearer 你的API密钥（Bearer 后面有空格）

点 Body 标签，选 Raw，粘贴测试代码：

{
  "model": "gpt-4o-mini",
  "messages": [{"role": "user", "content": "你好"}],
  "max_tokens": 20
}

点 Send 发送

Hoppscotch 测试界面 Hoppscotch 测试配置示例

成功的样子：

返回一段 JSON，里面有 "content" 字段，内容是 AI 的回复：

{
  "choices": [
    {
      "message": {
        "content": "你好！有什么我可以帮助你的吗？"
      }
    }
  ],
  "usage": {
    "total_tokens": 18
  }
}

看到这个就说明配置对了。

失败的样子：

错误提示	原因	怎么改
401 Unauthorized	API Key 错误	重新复制 Key，确保没有多余空格
404 Not Found	地址写错了	检查域名和 `/v1/chat/completions`
Invalid model	模型名写错了	改成 `gpt-4o-mini` 试试

方法 2：用客户端测试（推荐）

如果你装了 Chatbox 或 Cherry Studio，直接在软件里测。

用 Chatbox 测试

打开 Chatbox，点右上角 齿轮图标（设置）
左侧选 AI 服务商
点 + 添加自定义服务商
填写配置：
- 名称：随便填，比如"测试"
- API 域名：https://你的中转站域名/v1
- API Key：粘贴你的密钥
- 模型：选 gpt-4o-mini
点保存

Chatbox 配置界面 Chatbox 添加自定义服务商

关闭设置，在对话框输入"你好"，发送

成功：几秒内收到 AI 回复失败：显示错误提示，根据提示检查配置

用 Cherry Studio 测试

Cherry Studio 有一键验证功能：

添加服务商配置（步骤和 Chatbox 类似）
点验证按钮
自动测试并显示结果

成功会显示绿色 ✓，失败会显示具体错误。

Cherry Studio 验证结果 Cherry Studio 的验证功能

方法 3：用命令行测试（开发者用）

适合会用命令行的人。

Windows（PowerShell）：

curl -X POST "https://你的域名/v1/chat/completions" `
  -H "Content-Type: application/json" `
  -H "Authorization: Bearer 你的Key" `
  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"你好"}],"max_tokens":20}'

macOS/Linux：

curl -X POST "https://你的域名/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 你的Key" \
  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"你好"}],"max_tokens":20}'

返回 JSON 就是成功，返回错误信息就是失败。

测试检查清单

测试时确认这些：

Base URL 格式：https://域名/v1（注意 https:// 和 /v1）
API Key 完整：从 sk- 开头到结尾全部复制
模型名称：gpt-4o-mini（注意连字符 -）
能正常回复：发"你好"能收到回复
Token 计数：响应里有 usage 字段

常见问题

Q：测试成功但实际用不了？

可能是客户端的 Base URL 格式不同。有些客户端需要去掉 /v1，单独填在其他地方。查看客户端的帮助文档。

Q：显示"模型不存在"？

检查拼写：gpt-4o-mini 不能写成 gpt4o-mini
查服务商官网，看支持哪些模型
换个最基础的模型试试

Q：测试成功但扣费不对？

记下测试的 Token 数（total_tokens），对比账单。如果单价明显高于官方价格，问客服或换服务商。

参考：AI API 价格怎么比？算出真实成本的方法

费用说明

测试会消耗少量 Token，成本很低：

用 gpt-4o-mini 测试
设置 max_tokens: 20
一次测试约 0.0001-0.0005 元
测试 10 次也不到 1 分钱

安全提醒

不要在公共电脑的网页工具里输入 API Key
测试完及时关闭浏览器标签
API Key 不要分享给别人
测试用完整 Key，不要用部分 Key 猜测

参考：API Key 安全指南

测试成功后做什么

保存配置：记下成功的 Base URL 和模型名称
设置预算：避免超支，参考 API 密钥和预算管理
准备备用：防止服务商故障，参考如何准备 API 备用线路

测试信息：本文测试日期 2026 年 8 月，使用 Hoppscotch、Chatbox 1.5.0 和 Cherry Studio 0.8.5。