AI API网关文档接入指南：从配置Key到完成调用

准备工作：注册账号与获取API Key

访问千聚AI中转站官网完成注册，登录后进入控制台。在“API Key管理”页面创建新密钥，你会得到一个以sk-开头的唯一凭证。建议将其保存为环境变量，便于后续代码调用：

export QIANJU_API_KEY=sk-xxxx

千聚的API Key管理页面还支持多密钥创建和额度控制，方便团队协作时分配不同使用权限。初次使用，建议先创建一个测试Key，熟悉流程后再生成正式环境密钥。

掌握AI API网关文档的核心配置

千聚作为统一的AI API网关，其接入方式与OpenAI官方接口完全兼容。你只需要关注三个配置点：API Key、Base URL和模型名称。其中Base URL由千聚统一提供，所有模型共享同一个入口地址，无需针对不同模型分别配置。千聚的AI API网关文档中详细列出了每个模型的名称格式、上下文长度以及参数限制，建议调用前先查阅确认。

以下是Python环境下的标准配置示例：

from openai import OpenAI
client = OpenAI(
base_url="https://www.qianjuai.cc/v1", // 千聚统一Base URL
api_key="sk-xxxx"
)

只需修改这一处Base URL，即可将原本连接OpenAI的代码切换至千聚网关，调用成本更低，模型选择更丰富。

选择模型并发送首次调用

千聚支持包括GPT-5系列、Claude、Gemini、DeepSeek、Grok、Qwen、Kimi、豆包、GLM在内的主流模型。在控制台查看完整模型列表后，选择你需要的模型并直接发起请求：

response = client.chat.completions.create(
model="gpt-5-turbo", // 模型名称需与官网一致
messages=[{"role": "user", "content": "用千聚测试AI API网关"}]
)
print(response.choices[0].message.content)

如果返回正常结果，说明你的API Key、Base URL和模型名称三项配置全部正确，千聚AI API网关已成功打通。如需切换模型，只需修改model参数的值，无需改动Base URL或API Key，极大降低了多模型接入的维护成本。

Token管理与费用控制

千聚采用按量计费模式，所有模型的调用消耗统一以Token计费。你可以在控制台实时查看余额、历史消耗以及各模型的使用统计。对于团队项目，千聚支持为每个API Key设置使用上限，避免单密钥超支。这种统一的Token管理方式，相比在多个平台分别充值、分别监控，更适合需要集中管理多个模型调用的开发团队。

与传统AI平台接入方式相比，千聚有以下几个明显的优势：

对比维度	传统多平台接入	千聚AI API网关
API Key数量	每个平台一个Key	一个Key调用全模型
Base URL	多个地址，容易混淆	统一地址，配置简单
模型切换	需修改SDK和网络配置	仅改模型名称参数
Token管理	多平台分开充值	一站式统一充值消费

这种统一网关模式尤其适合需要快速迭代、频繁切换模型进行测试的开发者。

快速排查常见问题

如果首次调用失败，建议按以下顺序排查：

• API Key是否有效：确认Key没有过期，且未被限制额度。可在控制台测试Key状态。
• Base URL是否正确：千聚的Base URL以https://www.qianjuai.cc/v1开头，注意不要漏掉末尾的/v1。
• 模型名称是否匹配：不同模型名称有严格格式，例如gpt-5-turbo和claude-3-opus，请以官网模型列表为准。
• 余额是否充足：账户余额不足时请求会被拒绝，请先确认Token余额是否足够调用目标模型。

千聚的AI API网关文档还提供了详细的错误码说明和排查步骤，遇到问题时可优先查阅。

参考资源

以下资源可以帮助你更深入地了解千聚的使用方式：

• 千聚AI中转站官网 – 注册与登录入口，获取最新信息。
• 模型列表与API文档 – 查看所有支持模型和调用参数。
• Token购买与余额充值 – 按需购买，透明管理。
• OpenAI兼容接口接入教程 – 详细配置与代码示例。

• AI API网关文档接入指南：从配置Key到完成调用
• 千聚Token购买与余额管理操作教程
• 千聚AI中转站模型列表与调用参数详解