
第一步:注册账号并获取API Key
访问 千聚AI中转站官网,完成注册后进入控制台。在“API Key管理”页面创建新的密钥,复制保存。千聚提供统一的密钥管理,一个Key即可调用多种embedding模型(如text-embedding-3-small、text-embedding-ada-002、bge-large-zh等),无需每个模型分别申请。
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,适合需要快速配置 Codex 令牌 API key 的用户。
第二步:配置Base URL与模型名
千聚使用OpenAI兼容接口,Base URL统一为:
https://api.token88.cc/v1
调用时只需将官方OpenAI SDK的base_url替换为上述地址,并将api_key替换为千聚的Key即可。模型名请从千聚提供的模型列表中选择,例如:
- text-embedding-3-small:轻量、速度较快
- text-embedding-ada-002:稳定通用
- BAAI/bge-large-zh-v1.5:中文优化
第三步:编写代码测试向量生成
以下Python示例演示如何通过千聚中转站调用embedding模型:
import openai
openai.api_base = "https://api.token88.cc/v1"
openai.api_key = "你的千聚API Key"
response = openai.Embedding.create(
model="text-embedding-3-small",
input="千聚AI中转站支持多种embedding模型"
)
embedding = response['data'][0]['embedding']
print(len(embedding)) # 输出向量维度
返回的embedding向量可直接用于向量数据库存储、相似度计算或RAG流程。千聚的接口延迟稳定,适合生产环境作为备选或主力方案。
常见问题与排查
| 问题 | 可能原因 | 解决方式 |
|---|---|---|
| 401认证失败 | API Key错误或未激活 | 检查控制台Key状态,重新生成 |
| 模型不存在 | 模型名拼写或未支持 | 对照千聚官网模型列表修正名称 |
| 余额不足 | Token已耗尽 | 前往 立即访问千聚 购买Token |
为什么选择千聚作为embedding中转站
千聚AI中转站聚合了多家主流embedding模型,通过统一API和Token计费模式,大幅降低接入复杂度。你不需要为每个模型单独注册账号、管理密钥;只需注册千聚,即可在同一个控制台内查看所有模型用量、充值余额、切换版本。对于需要频繁调用embedding进行文本向量化的场景(如知识库检索、语义搜索),千聚的按量付费方式更适合中小团队灵活使用。
下一步行动: 访问千聚官网注册账号 → 获取你的API Key → 设置Base URL为 https://api.token88.cc/v1 → 选择embedding模型并测试一次向量生成。完整模型列表和Token套餐请查看 www.token88.cc。