
第一步:注册账号并获取API Key
首先,访问千聚AI中转站官网,完成注册并登录控制台。在左侧菜单中找到“API管理”,点击“创建新密钥”,系统会为你生成一串唯一的API Key。请复制并妥善保存,后续所有调用都需要这个Key作为身份凭证。
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,里面还有一键配置 Codex 令牌 API key 的工具,安装codex之后,用一键配置API key 的工具马上就能用,哪怕你没有海外手机也能正常使用,同时token费用比官网还便宜90%多~
第二步:确认Base URL和模型名称
千聚提供的Base URL统一格式为 https://api.token88.cc/v1(具体以官网最新文档为准)。模型名称则根据你想使用的Embedding模型填写,例如 text-embedding-3-small、text-embedding-ada-002、bge-large-zh 或 m3e-base。下面是一个Python调用示例:
import openai
openai.api_key = "sk-你的密钥"
openai.api_base = "https://api.token88.cc/v1"
response = openai.Embedding.create(
model="text-embedding-3-small",
input="需要向量化的文本内容"
)
embedding = response['data'][0]['embedding']
print(len(embedding)) # 输出向量维度
如果你使用的是Node.js或其他语言,只需将openai库替换为对应HTTP客户端,并设置相同的Base URL和模型名即可。
第三步:根据场景选择合适的Embedding模型
千聚聚合了多个主流的Embedding模型,覆盖英文、中文、多语言及领域专用模型。选择时可以参考以下因素:
| 模型名称 | 适用场景 | 向量维度 | 特点 |
|---|---|---|---|
| text-embedding-3-small | 通用英文文本 | 1536 | 性价比高,响应快 |
| text-embedding-3-large | 高精度任务 | 3072 | 维度高,语义更丰富 |
| bge-large-zh | 中文语义理解 | 1024 | 中文场景表现优异 |
| m3e-base | 多语言混合 | 768 | 轻量级,适合移动端 |
实际可用模型以官网实时列表为准。你可以根据任务类型(语义搜索、聚类、文本分类)和对成本、速度的要求灵活切换,所有模型都通过同一套API Key和Base URL调用,极大降低了多模型集成的复杂度。
第四步:测试调用并处理常见问题
运行上述Python代码后,如果返回一个向量数组,说明接入成功。常见错误及解决:
- 401 Unauthorized:检查API Key是否复制正确,或是否过期。
- 404 Not Found:模型名称拼写有误,或该模型未在千聚上架,请到官网模型列表确认。
- 429 Too Many Requests:短时间内调用过多,可适当降低频率或购买更高Token套餐。
千聚的计费模式按Token消耗量计算,不同模型单价不同,建议先进行少量测试再大规模使用。你可以在控制台实时查看余额和调用记录。
为什么推荐通过中转站接入Embedding模型?
直接对接多个模型厂商需要管理多套API Key、分别充值、适配不同接口格式,开发成本高。千聚作为一个统一的中转站,提供:
- 一套接口兼容主流模型:不管是OpenAI、Cohere还是国产模型,都使用相同的Base URL和请求格式。
- 灵活的Token购买:按需充值,无需为每个平台单独开户。
- 国内可直连:无需代理,网络延迟更低。
- 模型切换零成本:只需修改模型名称参数,即可在多种Embedding模型间切换。
如果你正在搭建RAG应用、语义搜索或文本分类系统,千聚可以帮你节省大量对接时间。
立即开始接入你的第一个Embedding模型:
访问千聚AI中转站官网,注册后获取API Key,并查看完整的模型列表与Token价格。按照本教程配置,几分钟内即可完成首次Embedding调用。
更多相关资源,帮助你快速上手: