获取API Key与Base URL的步骤
在使用任何API聚合平台之前，你需要先获取一对凭证：API Key和Base URL。以千聚AI中转站为例，操作流程非常直观。
- 注册账号：访问千聚AI中转站官网，完成注册并登录。
- 生成API Key：在控制台的“API Key管理”页面，点击创建新密钥。系统会生成一串唯一的密钥，请妥善保存。
- 查看Base URL：在同一个页面，找到“Base URL”或“接入地址”字段。千聚提供的统一入口地址格式通常为
https://www.qianjuai.cc/v1，这个地址将用于所有模型的调用。 - 选择模型：在模型列表中选择你需要的模型，例如gpt-4o、claude-3-5-sonnet或deepseek-chat。千聚支持多模型聚合，无需为每个模型单独申请密钥。
完成以上步骤，你就拥有了调用千聚平台所需的所有信息。接下来，我们进入配置环节。
配置环境变量，统一调用入口
配置Base URL是聚合调用的核心步骤。大多数AI SDK（如OpenAI的Python库）都支持通过环境变量或参数设置Base URL。以下是一个典型的Python配置示例：
import os
from openai import OpenAI
client = OpenAI(
api_key="你的千聚API Key",
base_url="https://www.qianjuai.cc/v1" # 千聚统一Base URL
)
通过这种方式，你只需修改一处配置，就可以切换调用不同模型。千聚平台兼容OpenAI的调用格式，这意味着你现有的代码几乎不需要改动，只需替换Base URL和API Key即可。下表展示了几个常见模型在千聚上的配置参数：
| 模型名称 | Base URL（统一） | 模型ID示例 | 备注 |
|---|---|---|---|
| GPT-4o | https://www.qianjuai.cc/v1 | gpt-4o | OpenAI系列 |
| Claude 3.5 Sonnet | https://www.qianjuai.cc/v1 | claude-3-5-sonnet | Anthropic系列 |
| DeepSeek V3 | https://www.qianjuai.cc/v1 | deepseek-chat | 国产模型 |
| Gemini 2.0 Flash | https://www.qianjuai.cc/v1 | gemini-2.0-flash | Google系列 |
所有模型共享同一个Base URL，这大大降低了多模型接入的复杂度。你只需在调用时修改模型ID参数，即可让请求路由到不同的模型后端。
实战调用：用Python测试一次模型对话
配置完成后，就可以开始第一次调用。以下是一个完整的调用示例，演示如何通过千聚的API聚合平台发送聊天请求：
from openai import OpenAI
client = OpenAI(
api_key="sk-你的千聚密钥",
base_url="https://www.qianjuai.cc/v1" # 关键：聚合Base URL
)
response = client.chat.completions.create(
model="gpt-4o", # 可替换为其他模型ID
messages=[
{"role": "user", "content": "告诉我API聚合平台如何简化开发流程？"}
]
)
print(response.choices[0].message.content)
运行这段代码，你会收到模型返回的响应。如果配置正确，你将看到完整的输出内容。千聚的Base URL设计为统一入口，因此你可以在后续开发中随意切换模型，只需修改model参数即可，不需要改变Base URL或API Key。
如果在调用过程中遇到问题，常见的排查点包括：
- Base URL拼写错误：请确认是否包含
/v1路径，以及是否使用了正确的协议（https）。 - API Key无效：检查密钥是否复制完整，或在控制台重新生成后重试。
- 模型ID不匹配：前往千聚模型列表确认模型名称的准确写法。
以上步骤可以帮助你快速定位问题，确保调用链路畅通。