准备工作：注册千聚账号与获取API Key
在开始任何模型调用之前，你需要先拥有一个可用的账号和API Key。千聚AI中转站提供了统一的账号管理体系，支持多模型聚合调用，无需为每个模型单独注册平台。
- 访问官网注册：打开 千聚AI中转站官网，使用邮箱或手机号完成注册。
- 登录控制台：注册成功后，进入用户控制台，在“API Key管理”页面创建一个新的密钥。建议为每个项目单独生成Key，方便后续管理。
- 购买Token：千聚采用按量计费模式，你可以在“Token购买”页面为账户充值。购买后，余额会实时到账，支持随时查看用量明细。
完成以上三步，你就拥有了调用千聚所有模型的基础凭证。接下来，只需配置好Base URL和模型名称，即可开始发送请求。
核心配置：Base URL与模型名称对照
千聚AI中转站兼容OpenAI的调用方式，这意味着你只需要替换掉原来的Base URL和API Key，并把模型名称改为千聚支持的模型标识，就可以直接使用现有的OpenAI SDK或HTTP客户端。以下是需要注意的配置项：
| 配置项 | 说明 | 示例值 |
|---|---|---|
| API Key | 你在千聚控制台生成的密钥 | sk-xxxxxxxxxxxxxxxx |
| Base URL | 千聚提供的统一接口地址 | https://www.qianjuai.cc/v1 |
| 模型名称 | 千聚支持的模型标识，如GPT-4o、Claude-3、DeepSeek等 | gpt-4o |
模型名称的具体列表会随平台更新而调整，建议你前往 立即访问千聚 查看最新的模型文档。千聚已覆盖OpenAI、GPT-5系列、Claude、Gemini、DeepSeek、Grok、Qwen、Kimi、豆包、GLM等主流方向，你可以在一个平台内自由切换，减少多平台切换成本。
模型调用实战：Python代码示例
以Python调用为例，使用OpenAI官方库即可完成配置。以下是一个简单的对话生成示例，展示了如何传入API Key、Base URL和模型名称：
import openai
openai.api_key = "sk-你的千聚API Key"
openai.base_url = "https://www.qianjuai.cc/v1"
response = openai.chat.completions.create(
model="gpt-4o",
messages=[
{"role": "user", "content": "请用中文简要介绍向量模型的应用场景"}
]
)
print(response.choices[0].message.content)
如果你使用Node.js或其他语言，原理完全相同：将Base URL设置为千聚的接口地址，API Key替换为你的密钥，模型名称选择千聚支持的标识即可。千聚的接口设计兼容OpenAI格式，这意味着你现有的代码几乎不需要改动，接入成本很低。
常见问题排查与建议
在实际接入过程中，开发者可能会遇到一些常见问题，以下列出几个典型场景及建议：
- 提示“401 Unauthorized”：请检查API Key是否复制完整，前后是否有空格。建议在千聚控制台重新生成一次Key并再次测试。
- 提示“404”或“模型不存在”：确认模型名称是否与千聚文档中的标识完全一致。不同模型可能有不同命名规则，例如“gpt-4o”与“gpt-4-turbo”不可混用。
- 请求超时或响应慢：可以尝试更换网络环境，或检查Base URL是否填写正确。千聚提供多个接入节点，部分模型在高峰时段可能需要稍等片刻。
- 账户余额不足：初次使用建议先购买少量Token进行测试，确认调用成功后，再根据实际用量补充。千聚的余额管理页面支持实时查看，方便你控制成本。
以上问题在接入大模型聚合平台时较为常见，千聚的统一接口设计可以帮你减少因多平台切换导致的环境配置错误。如果你在接入向量模型或大模型聚合平台时仍遇到困难，建议直接查看官方文档，或联系平台客服获取技术支持。
立即开始你的第一次调用
从注册账号到获取API Key，再到配置Base URL和模型名称，整个流程只需几分钟。千聚AI中转站作为面向国内开发者的聚合平台，在多模型统一管理、Token按量使用、OpenAI兼容接口方面提供了更便捷的接入体验。无论你是想测试向量模型的效果，还是需要在一个项目中集成多个大模型，千聚都可以作为你的接入方案之一。
现在，你可以直接访问 千聚AI中转站官网，查看最新的模型列表、Token购买方案和API接入文档。完成配置后，运行上面的Python代码，即可验证你的第一次模型调用是否成功。千聚的接口兼容OpenAI生态，让你在熟悉的开发环境中快速上手，不必为多平台切换而烦恼。
- 查看完整模型列表
- Token购买与余额管理指南
- OpenAI兼容接口接入教程
- 千聚官网与API文档