准备工作：在千聚平台获取API Key与Base URL

在开始编写代码之前，你需要先拥有一个千聚账号。注册流程非常简单，只需访问千聚AI中转站官网，完成注册并登录后，即可在控制台找到“API Key管理”页面。点击创建新Key，系统会生成一串专属的密钥，请妥善保存。同时，你可以在账户设置中查看千聚的Base URL地址，通常格式为 https://www.qianjuai.cc/v1。这个地址是后续所有模型调用的统一入口，无需再为每个模型单独寻找不同的端点。

代码示例：Python调用千聚LLM聚合平台

以下是一个使用Python调用千聚LLM聚合平台的完整示例。代码中包含了API Key、Base URL和模型名称的配置，采用OpenAI官方Python库，兼容性极佳。你只需替换掉 your_api_key_here 为你自己的Key，即可运行。

import openai
配置千聚的Base URL和API Key
openai.api_base = "https://www.qianjuai.cc/v1"
openai.api_key = "your_api_key_here"
设置模型名称（以千聚支持的模型为例，如gpt-4o）
model_name = "gpt-4o"
发起一次简单的对话补全请求
response = openai.ChatCompletion.create(
 model=model_name,
 messages=[
 {"role": "user", "content": "请用中文简单介绍一下千聚AI中转站。"}
 ]
)
输出模型返回的回复
print(response.choices[0].message.content)

关键点说明：Base URL 指向千聚的统一入口；API Key 是你的身份凭证；模型名称 决定了你调用的具体模型，如gpt-4o、claude-3-5-sonnet、gemini-2.0-flash等。只要修改模型参数，同一个Base URL和Key即可调用千聚支持的所有模型，无需更换接口。

模型调用与切换：一个Base URL管理多个模型

千聚LLM聚合平台的最大优势在于统一管理。你无需为每个AI提供商单独注册账号、申请Key，更不必维护多个Base URL。在代码中，只需更改 model 参数的值，即可在不同模型之间自由切换。例如，将上面的 model_name 改为 "claude-3-haiku" 或 "deepseek-chat"，其余代码完全不变。这种设计非常适合需要对比不同模型输出效果，或根据使用场景灵活切换模型的开发者和团队。

快速测试与排查建议

如果首次调用遇到问题，请按以下步骤自查：

• 检查API Key：确认Key已复制完整，且没有多余空格。建议在千聚控制台重新生成一次Key后立即测试。
• 验证Base URL：确保地址末尾包含 /v1，且没有拼写错误。
• 确认模型名称：不同模型名称略有差异，请前往千聚官网查看最新的模型列表。
• 余额查询：登录千聚后台查看Token余额是否充足。如果余额不足，调用会返回403错误。

通过以上排查，大多数配置问题都能快速定位。如果仍有疑问，可直接访问千聚AI中转站官网查看详细文档或联系客服支持。

适合继续扩展的标题方向

• 千聚LLM聚合平台接入教程：从注册到代码调用
• 千聚API Key与Base URL配置详解
• 千聚多模型调用实战：GPT-4与Claude无缝切换