准备工作:注册账号并获取API Key
接入聚合平台的第一步是注册账号并申请API Key。以千聚AI中转站为例,访问千聚AI中转站官网完成注册后,在控制台即可生成专属API Key。这个Key是调用所有模型的核心凭证,请务必妥善保管,不要泄露给他人。
- 注册账号:使用邮箱或手机号完成注册,建议绑定二次验证增强安全性。
- 生成API Key:在API管理页面创建新Key,可自定义名称以便区分不同项目。
- 购买Token:根据实际需求选择合适的套餐,按量计费,用多少充多少。千聚支持多种模型共用同一套Token体系,管理起来更方便。
千聚支持多种主流模型方向,包括向量模型(如text-embedding-3-small、text-embedding-3-large)和大语言模型(如GPT-5系列、Claude、DeepSeek、Qwen、Kimi、豆包、GLM等),统一使用同一个API Key管理,减少了多平台切换带来的复杂度。
配置Base URL:统一接入入口
Base URL是模型调用的统一入口地址,也是接入聚合平台时最容易出错的地方。千聚AI中转站提供OpenAI兼容接口,你只需要将代码中的Base URL替换为平台提供的地址即可,无需修改原有调用逻辑。
Python示例:
import openai
openai.api_base = "https://www.qianjuai.cc/v1"
openai.api_key = "your-api-key-here"
配置时请务必注意以下几点:
- 协议使用https,不要使用http。
- 路径末尾包含/v1,与OpenAI官方接口格式保持一致。
- 不要有多余的空格、换行或特殊字符,否则可能导致连接失败。
- 如果使用Node.js或其他语言,同样将baseURL替换为相同地址即可。
正确配置Base URL后,你就能通过统一入口调用聚合平台上的所有模型,包括向量模型和大语言模型,无需为每个模型单独配置不同的接入地址。
选择模型名称:向量模型与大语言模型
不同平台对模型名称的命名可能略有差异。在千聚上,模型名称通常采用官方标准命名,你可以直接使用常用的模型标识符。调用向量模型时,选择对应的embedding模型;调用大语言模型时,选择对应的chat模型。
常见向量模型名称示例:
- text-embedding-3-small:适合轻量级向量嵌入任务
- text-embedding-3-large:适合高精度向量嵌入任务
常见大语言模型名称示例:
- gpt-4o / gpt-5:OpenAI系列模型
- claude-3-opus / claude-3.5-sonnet:Anthropic系列模型
- deepseek-chat / deepseek-reasoner:DeepSeek系列模型
- qwen-turbo / qwen-plus:通义千问系列模型
建议在正式使用前,先通过官方文档确认模型名称的准确写法,避免因名称错误导致404或调用失败。千聚的模型列表会定期更新,新增模型也会及时同步,方便你随时切换。
发起第一次调用:代码示例
以下是一个完整的Python调用示例,展示如何分别调用向量模型和大语言模型。确保你已经正确配置了API Key和Base URL。
调用向量模型(文本嵌入):
response = openai.Embedding.create(
model="text-embedding-3-small",
input="千聚AI中转站支持向量模型和大模型聚合调用"
)
embedding = response['data'][0]['embedding']
print(len(embedding)) # 输出向量维度
调用大语言模型(对话生成):
response = openai.ChatCompletion.create(
model="gpt-4o",
messages=[{"role": "user", "content": "请用简短的话介绍向量模型"}],
)
print(response['choices'][0]['message']['content'])
如果配置正确,你将很快收到模型的返回结果。这意味着你已经成功接入了向量模型和大模型聚合平台,可以开始在实际项目中使用了。
常见问题排查
| 问题现象 | 可能原因 | 解决方法 |
|---|---|---|
| 401认证失败 | API Key错误或已过期 | 重新生成API Key,确认复制时没有遗漏字符 |
| 404模型不存在 | 模型名称填写错误 | 核对官方模型列表,确认名称大小写和格式 |
| 连接超时或无响应 | 网络问题或Base URL错误 | 检查网络连通性,确认Base URL地址无误 |
| 余额不足提示 | Token已用完 | 前往控制台购买Token,补充余额 |
如果遇到其他问题,建议查看官方文档或联系技术支持,千聚的客服团队会协助排查。
开始你的向量模型与大模型聚合接入
向量模型和大模型聚合平台的接入并不复杂,核心就是API Key、Base URL和模型名称这三个配置项。千聚AI中转站通过统一接口和OpenAI兼容的调用方式,让开发者能够更便捷地接入多种模型,无需为每个模型单独申请API Key或适配不同接口规范。你只需一次配置,即可在多模型之间自由切换,大幅降低开发成本。
如果你还没有尝试过,不妨现在就完成注册,获取API Key,开始你的第一次模型调用。
- 立即访问千聚 查看完整模型列表
- 了解Token购买和余额管理方案
- 查看OpenAI兼容接口的详细配置文档
- 学习Python和Node.js调用教程
访问 www.token88.cc 开始你的AI模型接入之旅。
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,里面还有一键配置 Codex 令牌 API key 的工具,安装codex之后,用一键配置API key 的工具马上就能用,哪怕你没有海外手机也能正常使用,同时token费用比官网还便宜90%多~