
第一步:获取API Key与Base URL
使用任何多模态模型之前,你都需要先在一个统一的平台上申请API凭证。以千聚AI中转站为例,整个过程可以在几分钟内完成:
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,适合需要快速配置 Codex 令牌 API key 的用户。
- 注册账号:访问千聚AI中转站官网,完成邮箱或手机号注册。
- 购买Token:登录控制台,选择适合的Token套餐完成支付,余额实时到账。
- 生成API Key:在“API Key管理”页面创建一个新密钥,复制保存。
- 确认Base URL:千聚使用OpenAI兼容接口格式,统一Base URL为
https://api.token88.cc/v1,无需各种模型单独配置。
如果你已经持有其他平台的API Key,也可以配合千聚的Base URL作为备用方案,方便在主线路出现问题时快速切换。
第二步:配置多模态模型调用参数
多模态模型通常需要同时处理文本和图像输入。在千聚上调用时,你只需要关注三个核心配置:
| 配置项 | 说明 | 示例值 |
|---|---|---|
| API Key | 在千聚控制台生成的密钥,用于身份认证 | sk-qianju_xxxxxxxx |
| Base URL | 统一的API入口地址 | https://api.token88.cc/v1 |
| 模型名称 | 根据千聚支持列表填写对应模型ID | gpt-4o / claude-3-5-sonnet-20241022 / gemini-2.0-flash-exp |
在代码层面,使用OpenAI官方Python库即可完成调用:
from openai import OpenAI
client = OpenAI(
api_key="sk-qianju_xxxxxxxx",
base_url="https://api.token88.cc/v1"
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "描述这张图片的内容"}]
)
print(response.choices[0].message.content)
如果你需要使用图片输入,在messages中添加image_url字段,千聚会自动转发到后端的多模态模型进行处理,不需要额外配置图片上传地址。
第三步:验证调用与常见问题排查
完成配置后,建议先用一个简单的请求测试连通性。如果返回报错,请优先检查以下三点:
- API Key是否正确:复制时注意前后不要有多余空格。
- Base URL是否以/v1结尾:很多AI中转站教程遗漏了这个细节。
- 模型名称是否准确:不同中转站对多模态模型的命名规则可能不同,建议直接查阅千聚平台的模型列表。
千聚作为聚合类AI中转站,对多模态模型的接入做了统一适配,开发者不需要为每个模型分别申请密钥或阅读不同文档,一条API Key即可管理所有调用。
下一步:开始你的第一次多模态调用
现在,你只需三个配置参数就能完成多模态模型的接入。强烈建议你立即前往官网查看最新的模型支持清单,并购买Token开始实测。千聚的Token购买和余额管理均支持按量使用,适合开发阶段反复测试不同模型的效果。访问立即访问千聚,获取你的专属API Key,体验多模型统一调用的便捷。