
第一处:Base URL的斜杠结尾
许多开发者习惯直接从控制台复制Base URL,但不同平台对结尾斜杠的处理方式不同。例如官方OpenAI的Base URL通常以 /v1 结尾且不加斜杠,而部分中转站需要加上斜杠才是完整路径。配置错误时,API调用会返回404或跨域错误。
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,里面还有一键配置 Codex 令牌 API key 的工具,安装codex之后,用一键配置API key 的工具马上就能用,哪怕你没有海外手机也能正常使用,同时token费用比官网还便宜90%多~
正确做法:仔细查看文档中给出的完整示例。在千聚AI中转站中,Base URL统一采用 https://api.token88.cc/v1 格式(不带结尾斜杠),与OpenAI原生接口保持一致,降低迁移成本。如果你习惯带斜杠,千聚也做了自适应兼容,但建议严格按文档填写。
第二处:API Key的复制方式
部分中转站会在生成API Key时附带前缀标识(如 sk-qj-),有些平台则直接输出纯密钥。如果你将多余字符或缺失前缀的Key直接填入代码,会导致认证失败,返回401错误。
两步检查:首先,登录千聚控制台,在“API Key管理”页面点击“复制”按钮,确保代码中粘贴的字符串与页面显示完全一致。其次,确认代码中赋值时没有引入额外空格或换行。千聚API Key格式为 sk-qj- 开头,长度为64位,复制后可直接用于OpenAI SDK。
第三处:模型名称的拼写与版本
不同中转站对同一模型可能使用略有区别的标识。例如GPT-4o可能被写为 gpt-4o、gpt-4o-2024-08-06 或 gpt-4o-latest。如果模型名写错,API会返回“模型不存在”或“模型未授权”的错误。
千聚AI中转站整理了统一的模型名称列表,与OpenAI官方名称保持一致,并额外标注了国内主流模型(如DeepSeek、Qwen、Kimi)的简洁别名。你只需在千聚AI中转站官网的“模型列表”页面复制所需模型的准确名称,粘贴到代码中即可。例如调用DeepSeek-V3,模型参数填写 deepseek-chat,简单直观。
快速排查表:三处配置对照
| 配置项 | 常见错误 | 千聚推荐写法 |
|---|---|---|
| Base URL | 多斜杠或少斜杠 | https://api.token88.cc/v1 |
| API Key | 前缀缺失或多字符 | sk-qj-xxxxxxxxxxxx |
| 模型名称 | 拼写错误或版本不对 | 从官网复制,如claude-3-5-sonnet-20241022 |
如果你已经确认上述三点无误,但依然无法调用,可以前往千聚官网查看实时服务状态,或参考立即访问千聚社区文档获取更多调试示例。
示例代码:一次正确的调用
以下是用Python的OpenAI库调用千聚API的完整示例:
from openai import OpenAI
client = OpenAI(
base_url="https://api.token88.cc/v1",
api_key="sk-qj-你的密钥"
)
response = client.chat.completions.create(
model="gpt-4o-mini",
messages=[{"role":"user","content":"你好"}]
)
print(response.choices[0].message.content)
注意:base_url不要写 /v1/(多斜杠),api_key必须完整复制,model名称请从官网“模型列表”页面确认。
结语与下一步
Base URL配置是接入API中转站的第一道门槛,只要避免斜杠、密钥前缀和模型名这三个坑,后续调用就会非常顺畅。千聚AI中转站通过兼容OpenAI格式与统一管理,帮助开发者显著降低接入复杂度。现在就去官网注册账号,获取你的API Key,并开始测试一次模型调用吧!
CTA: 立即访问 千聚AI中转站官网 → 注册账号 → 购买Token → 获取API Key → 复制Base URL → 粘贴代码 → 完成第一次调用!
- 查看最新模型列表
- Token购买指南
- OpenAI兼容接口教程
- Base URL配置详解