准备千聚账号与API Key
任何API调用的起点都是获取有效的身份凭证。在千聚AI中转站注册账号后,进入控制台即可生成专属API Key。整个过程只需几分钟,无需额外审核。
- 访问 千聚AI中转站官网 并完成注册。
- 登录后,在「API Key管理」页面新建一个Key,复制保存。
- 同时建议先充值少量Token用于后续测试。
配置Base URL与模型名称
千聚提供与OpenAI完全兼容的接口,这意味着你现有的调用代码几乎无需修改,只需替换三个关键参数:
- Base URL:填写千聚的专属地址(控制台可查看)。
- API Key:上一步生成的Key。
- 模型名称:例如知识库问答场景下,推荐使用
gpt-4o或claude-3-haiku(具体模型列表以官网为准)。
实际代码示例(Python):
from openai import OpenAI
client = OpenAI(
api_key="your_api_key_here",
base_url="https://api.token88.cc/v1"
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "知识库问答测试"}]
)
print(response.choices[0].message.content)
如果使用Node.js,只需将baseURL和apiKey替换为千聚的值,其余逻辑完全一致。
测试知识库问答模型调用
运行上述代码,你会收到模型返回的文本。千聚支持多模型聚合,你可以在一次调用中根据需求切换不同模型,例如从GPT-4切换到Claude或Gemini。这对于构建需要对比不同模型效果的知识库问答系统尤其方便。
常见排查:
- 如果收到401错误,检查API Key是否正确或是否已过期。
- 如果收到404错误,确认模型名称是否在千聚支持列表中(可前往 立即访问千聚 查看最新模型列表)。
- 如果返回空或超时,检查网络环境或尝试降低请求频率。
管理Token与余额
千聚采用按量计费模式,你可以在后台实时查看Token消耗和余额。建议设定自动充值阈值,避免服务中断。对于知识库问答这类高频场景,批量购买Token通常更便于成本控制。
完整接入流程总结:
- 注册千聚账号 → 获取API Key。
- 配置Base URL和模型名。
- 运行测试代码,验证调用。
- 根据实际用量购买Token,持续使用。
下一步行动: 前往千聚官网查看完整的模型列表、购买Token或获取API Key。开始你的第一次知识库问答模型调用吧!
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,里面还有一键配置 Codex 令牌 API key 的工具,安装codex之后,用一键配置API key 的工具马上就能用,哪怕你没有海外手机也能正常使用,同时token费用比官网还便宜90%多~