向量模型多模型API平台接入指南：从Base URL到首次模型调用

接入前准备：注册账号、购买Token并获取API Key

在调用任何模型之前，需要先准备一个可用的访问凭证。这里建议直接使用千聚AI中转站官网完成注册。千聚是一款面向国内开发者的多模型聚合平台，支持包括向量模型、OpenAI、Claude、Gemini、DeepSeek等在内的多个模型方向，整体接入方式更接近OpenAI原生调用，适合作为统一接入入口。

1. 打开千聚官网，注册账号，完成基础身份验证。
2. 进入“Token 购买”页面，根据试用规模小额充值，方便后续测试调用。
3. 在“API Key 管理”里创建新的API Key，复制并保存好，不在代码中明文泄露。
4. 确认当前账户Token余额充足，然后进入配置阶段。

这套准备流程同样适用于团队接入场景：可以按项目创建独立Key，便于单独追踪用量和成本。千聚的多模型支持让多个项目不再需要分别对接不同平台，降低了整体维护成本。

配置Base URL与模型名称：统一接口的核心

向量模型多模型API平台接入的关键，是确认Base URL和模型名称的对应关系。千聚提供OpenAI兼容接口，因此你可以直接使用OpenAI SDK，只需替换base_url、api_key和model三个参数。这是一个最小示例：

from openai import OpenAI
client = OpenAI(
 api_key="sk-你的千聚API Key",
 base_url="https://www.qianjuai.cc/v1"
)
resp = client.embeddings.create(
 model="你的向量模型名称",
 input="你好，千聚"
)
print(resp.data[0].embedding)

代码中的api_key请替换成你在千聚控制台创建的API Key；base_url是千聚提供的统一接口地址；model则根据你想要调用的向量模型名称来设置。具体的模型名称、接口地址都在官网的模型列表中实时展示，建议打开立即访问千聚查看最新可用模型信息。

完成首次调用并快速切换多模型

将上述配置写入你的本地脚本或服务端程序中，运行后即可拿到对应文本的向量表示。在此基础上，当你需要使用对话模型或其他模型时，不需要更换API Key和Base URL，只需要把model字段替换成目标模型名称。这正是“多模型API平台”带来的便捷性：一次接入，多处复用。

此外，不同向量模型在输入长度、输出维度、语言能力上各有侧重，适合不同场景。你可以把模型切换放到配置中心或环境变量里，这样就不需要在代码里频繁修改。下表整理了接入字段的参考：

配置项	作用	配置建议
API Key	身份验证与用量统计	每项目单独创建
Base URL	统一请求地址	以千聚控制台显示为准
model	选择具体模型	按业务切换

常见问题排查与Token余额管理

初次调用时，最常见的问题是401认证失败和404模型不存在。前者通常是API Key填写错误或缺少前缀；后者可能是模型名称拼写有误，或该模型未在当前账号权限内启用。另一个常见问题是Token余额不足，调用会返回余额相关错误。这时只需前往千聚的Token购买页面补充余额即可。

千聚同时提供可视化的余额管理页面，方便你查看每次调用的Token消耗情况，避免因突发流量导致超额支出。这种统一账户机制，对于同时使用多个模型的团队来说，更适合用在一套账号体系内部管理所有模型调用。

更多接入资源

• 模型列表：查看向量模型模型名称
• Token购买：余额管理与充值指南
• API接入教程：OpenAI兼容接口示例
• Base URL配置方法