如何使用 curl 和 Python 测试 AI API 密钥

以下是无需构建任何内容即可测试 AI API 密钥访问权限的方法:三次调用,约两分钟,你将知道密钥是否有效、是否有资金以及是否允许生成文本。
要点
- 首先调用 GET /v1/models:它证明密钥被接受且未消耗额度。
- 向模型 uncensored 发送一个简短的聊天请求,以确认生成工作正常。
- 读取 X-Balance-USD 标头或 GET /v1/balance 以查看剩余余额。
- 401 对应密钥,402 对应余额,429 对应请求频率。
三次调用测试
要正确测试 AI API 密钥,你需要证明三件独立的事情:服务器接受该密钥,密钥背后有额度,并且能返回真实的聊天补全结果。每个问题一次调用可使诊断保持简单。如果某项失败,你就知道哪一层出了问题。
- 模型列表。 验证密钥且不消耗额度。
- 聊天补全。 确认模型能回答且你的请求格式正确。
- 余额。 确认测试后剩余多少。
以下所有内容均使用基础 URL https://api.aiapisource.com/v1 和模型 ID uncensored。将密钥放入环境变量中,以免其出现在 shell 历史记录或仓库中。
export AIAPI_KEY="paste-your-key-here"
如果你还没有密钥,API 密钥页面 展示了如何创建一个。新账户可以一键领取 $0.50 免费试用额度,这足以完成本文中的所有测试。
步骤 1:使用 curl 列出模型
最便宜的检查是只读请求。GET /v1/models 返回模型列表并需要有效的密钥,因此成功的响应证明了认证。
curl -s https://api.aiapisource.com/v1/models \
-H "Authorization: Bearer $AIAPI_KEY"
健康的响应是一个包含 data 数组的 JSON,其中包含 uncensored。如果你看到 HTML 页面、连接错误或空响应,问题出在 URL 上,而不是密钥。请确保保留了 /v1 后缀,且变量中的密钥后没有尾随空格。
在 curl 命令中添加 -i 以查看响应标头。API 在每次调用时都会发送 X-Request-Id。如果将来联系 技术支持,请保留该值,因为它标识了具体的请求。
步骤 2:发送一个聊天请求
现在检查生成能力。保持提示词极短并限制输出,以便测试成本不到一美分。
curl -s https://api.aiapisource.com/v1/chat/completions \
-H "Authorization: Bearer $AIAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Reply with the single word: ready"}],
"max_tokens": 10
}'
查找 choices[0].message.content 以及包含 prompt_tokens 和 completion_tokens 的 usage 对象。大约 20 个输入 token 和 5 个输出 token 的请求成本为 20 / 1,000,000 x $0.15 加上 5 / 1,000,000 x $0.50,即约 $0.0000055。你可以运行上百次此类测试,总成本远低于一美分。
同一接口也支持流式输出:添加 "stream": true,token 将以服务器发送事件的形式到达。在基本调用正常工作后,单独测试此功能。
步骤 3:使用 Python 进行相同测试
如果你的真实代码使用 OpenAI SDK,也通过 SDK 进行测试。它能捕获 curl 无法发现的问题,例如将基础 URL 传递给错误的参数。
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["AIAPI_KEY"],
base_url="https://api.aiapisource.com/v1",
)
print([m.id for m in client.models.list().data])
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Reply with the single word: ready"}],
max_tokens=10,
)
print(r.choices[0].message.content)
print(r.usage)
第一次打印应显示包含 uncensored 的列表。第二次显示模型回复。有关 SDK 设置的更详细指南,请参阅本站点的 OpenAI API Python 指南。
从导出密钥的同一 shell 运行 Python 版本。如果它在 AIAPI_KEY 上引发 KeyError,说明该会话中未设置变量,这是测试在到达网络之前失败的最常见原因。
Node 以相同方式工作:将 baseURL: "https://api.aiapisource.com/v1" 和密钥传递给 OpenAI 客户端构造函数。
检查余额
密钥可能有效但没有任何可用余额。有两种读取余额的方法:
curl -s https://api.aiapisource.com/v1/balance \
-H "Authorization: Bearer $AIAPI_KEY"
# OpenAI-style alternative
curl -s https://api.aiapisource.com/v1/dashboard/billing/credit_grants \
-H "Authorization: Bearer $AIAPI_KEY"
每个响应还包含 X-Balance-USD 标头,因此如果你在步骤 2 中使用 -i 运行聊天调用,它已经告诉你剩余额度。在 Python 中,OpenAI SDK 通过 client.chat.completions.with_raw_response.create(...) 暴露此功能,你可以读取 response.headers["X-Balance-USD"]。
失败或被拒绝的请求不会收费,因此出错的测试不会消耗额度。预付额度不会过期,这意味着未使用的余额下周仍然存在。
读取错误代码
当测试失败时,HTTP 状态码可以快速定位原因。
| 状态码 | 通常含义 | 该做什么 |
|---|---|---|
| 401 | 密钥缺失、拼写错误或已撤销 | 检查 Authorization: Bearer 标头,重新复制密钥,查找隐藏的空格或引号 |
| 402 | 没有剩余额度支付请求 | 读取余额,然后在 定价页面 充值 |
| 404 | 路径错误或模型 ID 错误 | 使用 /v1/chat/completions 和模型 uncensored |
| 429 | 速率或并发限制,或短暂过载 | 等待并重试;见下文 |
429 错误携带错误代码。rate_limited 表示每分钟请求过多,concurrency 表示同时请求过多。完整密钥允许每分钟 300 次请求和 8 个并发请求;试用密钥允许每分钟 60 次请求和 2 个并发请求。在短暂过载期间,API 会返回带有 Retry-After: 5 的 429,因此等待五秒后再次发送请求。流式请求会占用其并发槽位直到流结束,这是试用密钥在并行测试中达到限制的常见原因。
401、402 和 404 状态码遵循正常的 API 约定,因此将表格视为初步猜测,并阅读 JSON 错误正文以获取确切消息。
可重复使用的冒烟测试脚本
一旦手动测试通过,保留一个脚本,以便在轮换密钥或更改环境后运行。
import os, sys
import requests
BASE = "https://api.aiapisource.com/v1"
H = {"Authorization": "Bearer " + os.environ["AIAPI_KEY"]}
m = requests.get(BASE + "/models", headers=H, timeout=15)
print("models", m.status_code)
c = requests.post(
BASE + "/chat/completions",
headers=H,
json={"model": "uncensored",
"messages": [{"role": "user", "content": "ping"}],
"max_tokens": 5},
timeout=60,
)
print("chat", c.status_code, "balance", c.headers.get("X-Balance-USD"))
sys.exit(0 if m.ok and c.ok else 1)
退出代码使其易于集成到部署检查中。对于超出此最小值的参数,API 文档 列出了该接口接受的所有内容。
更多指南
问答
测试 API 密钥需要花钱吗?
调用模型列表接口免费。一次低 max_tokens 的简短对话请求,按输入 token $0.15/1M 和输出 token $0.50/1M 计费,仅需几百万分之一美元。失败的请求不收费。
如何在不绑定银行卡的情况下测试密钥?
注册后在 API 密钥页面领取 $0.50 免费试用额度。无需绑定银行卡,有效期 7 天,每人限领一次。
为什么有效的密钥会立即返回 429 错误?
你可能触发了并发或每分钟请求数限制。试用密钥允许 2 个并发请求和每分钟 60 次请求;完整密钥允许 8 个并发请求和每分钟 300 次请求。请查看错误代码,然后降低频率或几秒后重试。
我可以在 Postman 或应用程序中测试密钥,而不是使用 curl 吗?
可以。任何 OpenAI 兼容的客户端均可使用:将 base URL 设置为 https://api.aiapisource.com/v1,将密钥作为 Bearer token 粘贴,并使用模型 uncensored。
只差一张表单,即可获得密钥
创建账户,复制密钥,更改基础 URL。这就是全部设置。