中文 ▾

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

一把正在锁中的钥匙,带有三个绿色指示灯,代表 API 密钥测试成功

以下是无需构建任何内容即可测试 AI API 密钥访问权限的方法:三次调用,约两分钟,你将知道密钥是否有效、是否有资金以及是否允许生成文本。

更新于

要点

  • 首先调用 GET /v1/models:它证明密钥被接受且未消耗额度。
  • 向模型 uncensored 发送一个简短的聊天请求,以确认生成工作正常。
  • 读取 X-Balance-USD 标头或 GET /v1/balance 以查看剩余余额。
  • 401 对应密钥,402 对应余额,429 对应请求频率。

三次调用测试

要正确测试 AI API 密钥,你需要证明三件独立的事情:服务器接受该密钥,密钥背后有额度,并且能返回真实的聊天补全结果。每个问题一次调用可使诊断保持简单。如果某项失败,你就知道哪一层出了问题。

  1. 模型列表。 验证密钥且不消耗额度。
  2. 聊天补全。 确认模型能回答且你的请求格式正确。
  3. 余额。 确认测试后剩余多少。

以下所有内容均使用基础 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。这就是全部设置。

获取 API 密钥