第一步：注册千聚并获取API Key
使用任何AI中转站都需要先有一个账号。前往千聚AI中转站官网完成注册，登录后进入控制台，在“API Key管理”页面创建新的密钥。千聚支持一次性生成多个Key，方便按项目或环境隔离权限。生成的API Key请妥善保存，后续所有请求都需要用它做身份验证。
第二步：确认Base URL与模型名
千聚采用OpenAI兼容接口格式，因此Base URL固定为 https://www.qianjuai.cc/v1（具体以官网最新文档为准）。embedding模型名可以在“模型列表”中查看，例如千聚上可能提供 text-embedding-3-small、text-embedding-ada-002 或国产开源模型 bge-large-zh 等。你只需要在调用时把 model 参数设为对应的模型ID，即可使用。
| 配置项 | 说明 | 示例值 |
|---|---|---|
| API Key | 在千聚控制台创建 | sk-xxxxxxxxx |
| Base URL | 千聚API入口地址 | https://www.qianjuai.cc/v1 |
| 模型名 | 根据所选的embedding模型 | text-embedding-3-small |
第三步：使用Python代码完成第一次embedding调用
以下示例展示如何用OpenAI Python SDK调用千聚的embedding接口：
import openai
openai.api_key = "你的API Key"
openai.api_base = "https://www.qianjuai.cc/v1"
response = openai.Embedding.create(
model="text-embedding-3-small",
input="千聚AI中转站支持哪些embedding模型？"
)
embedding = response['data'][0]['embedding']
print(len(embedding)) # 输出向量维度
调用成功后你会得到一个浮点数向量，后续可以直接存入向量数据库或用于相似度计算。整个流程与官方OpenAI完全一致，只是改了API Key和Base URL。如果你用其他语言（如Node.js、curl），同理只需修改这两个参数。
第四步：常见问题排查
- 401认证失败：检查API Key是否复制正确，注意不要有多余空格。
- 404模型不存在：确认模型名是否与千聚列表中的ID一致，部分模型可能需在“模型市场”单独开通。
- 速率限制：千聚对免费额度有每分钟请求限制，如遇限速可升级套餐或降低并发。
- 计费问题：embedding模型按Token数量计费，具体单价请到立即访问千聚查看实时价格。
为什么选择千聚管理embedding模型
千聚AI中转站聚合了国内外数十种embedding模型，包括OpenAI、Cohere、智源、BGE等系列。你只需一个API Key和统一Base URL，就能在多模型之间自由切换，无需为每个平台单独注册和维护。这对于需要测试不同embedding效果、或想降低接入成本的团队来说，是一种更便捷的方案。同时千聚支持Token按量购买，余额实时显示，方便控制预算。
立即开始使用千聚embedding模型中转站：
- 访问 千聚AI中转站官网 注册账号
- 在控制台创建API Key
- 在模型列表中选择你需要的embedding模型
- 购买适量Token（首次注册通常赠送体验额度）
- 复制Base URL和模型名，按本文代码完成调用测试
一旦你掌握了这个流程，后续切换其他模型（如Claude、Gemini、DeepSeek）也只需要修改模型名字段，API Key和Base URL保持不变，真正实现“一次接入，多模型复用”。千聚还提供详细的调用日志和用量统计，方便你调试和优化应用。