
一、准备工作:注册千聚账号并获取API Key
第一步是获取有效的访问凭证。前往千聚AI中转站官网完成注册,登录后在后台创建API Key。每个API Key都关联你的账户余额,用于按量计费。
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,适合需要快速配置 Codex 令牌 API key 的用户。
- 访问 千聚AI中转站官网 并注册
- 在“API Key管理”页面生成新的密钥
- 建议先购买少量Token用于测试,官网支持实时余额查看
二、配置Base URL与模型名称
千聚中转站提供统一的OpenAI兼容接口Base URL,你无需记忆各模型的不同接入地址。所有图片理解模型都可以通过同一个入口调用。
重要配置参数:
以下代码示例使用Python OpenAI SDK,展示了三个核心字段:
import openai
openai.api_key = "你的API Key" # 从千聚后台获取
openai.api_base = "https://api.token88.cc/v1" # 千聚Base URL
model = "gpt-4o" # 选择支持图片理解的模型
配置完成后,就可以像调用标准OpenAI接口一样处理图像分析请求,真正实现“一个中转站,多模型统一接入”。
三、测试图片理解调用
下面是一个完整的图片理解调用示例,将本地图片发送给模型并获取描述:
response = openai.ChatCompletion.create(
model=model,
messages=[
{
"role": "user",
"content": [
{"type": "text", "text": "请描述这张图片中的场景"},
{"type": "image_url", "image_url": {"url": "https://example.com/photo.jpg"}}
]
}
]
)
print(response.choices[0].message.content)
通过千聚中转站,你可以轻松切换至其他视觉模型,如Claude 3 Opus、Gemini Pro Vision、Qwen-VL等,只需修改model字段即可。这种灵活性非常适合开发者同时测试多个图片理解模型的效果。
四、为什么选择千聚AI中转站接入图片理解模型?
- 统一接口:完全兼容OpenAI调用方式,现有代码几乎零改动
- 多模型覆盖:涵盖GPT-5系列、Claude、Gemini、DeepSeek、Qwen、Kimi等多种支持图片理解的模型
- 国内友好:无需额外网络配置,Base URL可直接使用,降低接入复杂度
- 按需付费:支持Token购买和余额管理,用多少充多少,更适合开发测试阶段
五、常见问题与排查
| 问题 | 可能原因 | 解决措施 |
|---|---|---|
| 401认证失败 | API Key错误或未启用 | 检查Key是否复制完整,并在千聚后台确认状态 |
| 模型返回不支持图片 | 所选模型不具备视觉能力 | 更换为明确支持图片理解的模型 |
| 连接超时 | 网络环境或Base URL错误 | 确认使用正确的千聚Base URL |
需要快速开始? 立即访问 千聚AI中转站官网 查看支持的所有图片理解模型列表,购买Token,获取你的专属API Key,体验统一接入的便捷。