第一步：注册账号并获取API Key
所有接入操作的第一步，都是在平台上注册账号并生成专属的API Key。以千聚为例，完成注册后进入控制台，可以在API管理页面找到创建Key的入口。建议为每个项目或应用单独生成Key，便于后期管理和统计用量。
API Key是调用接口的身份凭证，务必将其保存在安全位置。如果你此前使用过OpenAI的API，会发现千聚的生成逻辑与之一致，迁移学习成本很低。获取Key后，即可进入下一步配置。
第二步：确认Base URL与调用端点
很多开发者迁移时最容易卡在Base URL这一项。聚合平台通常提供统一的访问入口，千聚使用了兼容OpenAI格式的端点，你只需要在客户端将原有的 https://api.openai.com 替换为千聚提供的Base URL即可。
以下是一个最简单的Python调用示例：
import openai
openai.api_key = "你的API_Key"
openai.api_base = "https://www.qianjuai.cc/v1"
response = openai.ChatCompletion.create(
model="gpt-4",
messages=[{"role": "user", "content": "Hello"}]
)
只需修改两个变量——API Key和Base URL，无需改动原有业务逻辑，即可完成接入。这也是千聚作为AI聚合平台，在配置上更适合降低迁移复杂度的体现。
第三步：选择模型名称并购买Token
配置好Key和地址后，选择要调用的模型名称即可。千聚支持包括GPT系列、Claude、Gemini、DeepSeek、Kimi、豆包、GLM等在内的多种模型，命名规则与官方保持一致，比如 gpt-4、claude-3-opus。
你可以在控制台查看当前可用模型的列表，并了解各自的Token计费模式。购买Token后，系统会实时更新余额，方便按量使用。相较于逐一去各厂商官网充值，这种统一购买、统一管理的方式对于开发者来说更为高效。
| 配置项 | 注意事项 |
|---|---|
| API Key | 每个项目建议独立生成，便于后期用量排查 |
| Base URL | 格式通常为 https://api.xxx.com/v1，注意末尾斜杠 |
| 模型名称 | 与官方名称一致，可通过平台文档查询完整列表 |
第四步：测试调用与常见问题排查
完成上述配置后，使用简单的Python或Node.js脚本发送一次请求即可验证是否联通。如果遇到401错误，首先检查API Key是否正确复制；如果遇到404，确认模型名称是否写错；如果遇到超时，可尝试切换网络或更换端点。
千聚的官方文档中提供了详细的错误码说明和常见问题的排查方法，对于初次使用AI聚合平台的团队来说，能减少很多试错成本。如果仍然无法解决，也可以直接联系平台技术支持。