3分钟搞定!o3-mini兼容接入Python示例的图文配置流程,新手也能一次成功
2026-09-20
3分钟搞定!o3-mini兼容接入Python示例的图文配置流程,新手也能一次成功 #
说实话,国内开发者想接入 OpenAI 最新的 o3-mini 这件事,本来也挺折腾的——得科学上网、绑海外信用卡、还要应付账号封禁风险。OpenAI 官方 API 门槛高,很多新手连第一步都迈不出去。
最近用千聚api聚合平台(www.qianjuai.com)接入 o3-mini,算是让我省了不少事。不是因为它有多神奇,就是接入流程简单到离谱,改一行代码就能跑起来,用着踏实。
它到底是干什么的 #
一句话说清楚:千聚api聚合平台 是一个国内可直连的 AI 大模型 API 中转聚合平台,专门为国内开发者解决“用上最新模型”的最后一公里问题。
你不用翻墙,不用绑海外信用卡,不用注册一堆麻烦账号,在国内网络环境下就能直接调用 o3-mini、GPT-4o、Claude、Gemini、DeepSeek 等主流模型的 API。接口格式完全兼容 OpenAI 标准——你用 OpenAI API 写的任何代码,只需要把 base_url 那一行改一改,就能直接用上 o3-mini。
对在国内做开发的人来说,“不用代理”这四个字本身就比很多功能更值钱。尤其是 OpenAI 每次新模型发布,很多人第一反应是“能用上吗?”有了千聚,你只需要想“要不要用”。
价格怎么算——核心就一句话 #
千聚的定价策略特别清晰,没有什么奇怪倍率、没有复杂套餐:
1 元人民币 = 1 美元 Token 额度,按 OpenAI 官方价格 1:1 计费。
官方 o3-mini 多少钱,换算一下就是千聚的价格。而且最低 1 元就能充进去用,不用一次性压几百块在里面试错。
限时特价分组折扣力度更大,可用于 DeepSeek、Qwen、Gemini 等模型,费率低至官方价格的 0.6 倍。虽然 o3-mini 目前主要在默认分组,但性价比已经非常透明,你用多少花多少,没有任何隐藏费用。
各分组费率对比 #
千聚按使用渠道分了多个分组,适合不同场景和预算。下面是主要分组的对比:
| 分组名称 | 渠道类型 | 费率倍数 | 支持模型 | 操作 |
|---|---|---|---|---|
| 默认(混合) | AZ + 逆向 + 国产模型 | 官方 ×1 | OpenAI、Claude、国产模型,含 o3-mini | 注册即用 |
| 限时特价 | DeepSeek + Qwen + Gemini + AZ | 官方 ×0.6 | Gemini、国产模型 | 注册享折扣 |
| 优质 Gemini | Google 官方渠道 | 官方 ×1 | Gemini 全系 | 注册使用 |
| 纯 AZ | 微软 Azure 渠道 | 官方 ×1.5 | OpenAI、国产模型 | 注册使用 |
| 官转 OpenAI | OpenAI 官转 + AZ 兜底 | 官方 ×3 | OpenAI 全系 | 注册使用 |
| 官转克劳德 2 | AWS Claude 官转 | 官方 ×6 | Claude 全系 | 注册使用 |
| 直连克劳德 | Anthropic 官方直连 | 官方 ×16 | Claude 全系 | 注册使用 |
| Claude Code 专属 | Claude Code 渠道 | 官方 ×1.5 | Claude Code | 注册使用 |
大多数普通开发者接入 o3-mini,用默认分组就够了——性价比最高,稳定性也不差。如果你的项目对 Claude 原生渠道有明确要求,再考虑官转或直连分组。
支持哪些模型 #
这是千聚另一个让人放心的地方:支持 500+ 模型,还在持续更新。
OpenAI 系列覆盖了 o3-mini、GPT-3.5-turbo、GPT-4、GPT-4o、GPT-4o-mini、o1、o3 系列,连 text-embedding 向量模型和 DALL·E 图像生成也在里面。o3-mini 作为最新推出的轻量推理模型,在千聚上是第一时间上线的,你不需要等任何排期。
Anthropic 系列有 Claude 3 Opus、Claude 3.5 Sonnet、Claude Haiku,视觉识别也支持。
Google 系列包括 Gemini 2.5 Pro、Gemini 2.5 Flash 等。
DeepSeek 系列是现在很多人关注的重点——DeepSeek-R1 满血版和 DeepSeek-V3 都支持,价格非常低。
其他还有 Midjourney、FLUX 图像生成、Suno 文生音乐、Sora 视频生成,以及可灵、海螺、豆包等国产视频模型,覆盖面相当广。
o3-mini Python 接入示例——图文配置流程 #
现在进入最核心的部分:如何用 Python 接入 o3-mini。整个过程真的只需要 3 分钟,新手也能一次成功。
第一步:注册并获取 API Key #
打开 千聚api聚合平台注册页面 ,填写邮箱和密码完成注册。注册成功后,进入控制台,在“API 密钥”页面复制你的专属 API Key。
注意保管好这个 Key,它是你调用模型的唯一凭证。
第二步:安装 OpenAI Python 库 #
如果你的环境还没有安装 openai 库,在终端运行:
bash pip install openai
如果你用的是国内 pip 源,建议使用清华源加速:
bash pip install openai -i https://pypi.tuna.tsinghua.edu.cn/simple
安装完成后,你的 Python 环境就具备了调用 OpenAI 兼容接口的能力。
第三步:写 Python 代码,调用 o3-mini #
这是最重要的一步。你只需要改动 base_url 和 api_key 两条配置,其余代码完全复用 OpenAI API 的标准写法。
python from openai import OpenAI
配置千聚api聚合平台的 API 地址和 Key #
client = OpenAI( base_url=“https://www.qianjuai.com/v1", # 关键:换成千聚的接口地址 api_key=“sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx” # 替换成你在千聚获取的 API Key )
调用 o3-mini 模型 #
response = client.chat.completions.create( model=“o3-mini”, messages=[ {“role”: “user”, “content”: “用 Python 写一个快速排序的代码”} ], temperature=0.7 # o3-mini 支持调节温度参数 )
打印结果 #
print(response.choices[0].message.content)
这段代码跑通后,你就能在国内网络环境下直接使用 o3-mini 的全部能力。流式输出同样支持,只需加上 stream=True 参数。
第四步:验证结果 #
运行上面的 Python 文件,如果看到模型返回的内容,说明接入成功了。整个过程不超过 3 分钟。
图文配置要点 #
- base_url 一定要写完整地址:
https://www.qianjuai.com/v1,不要遗漏协议头和路径。 - api_key 是千聚控制台里复制的那一串,开头是
sk-。 - model 名称填写
o3-mini,千聚完全兼容 OpenAI 的模型命名规则。 - 如果遇到网络超时,可以尝试增加
timeout参数:OpenAI(timeout=30)。
所有第三方工具(Cursor、LobeChat、ChatGPT Next Web、沉浸式翻译、Cline 等)也支持配置自定义 API 地址,接上千聚直接用。在工具设置页找到“自定义 API 地址”或“Base URL”输入框,填写 https://www.qianjuai.com/v1,然后填入 API Key,保存即可。
新用户先白嫖,觉得好再充钱 #
这个流程设计得挺聪明的:
注册主站账号,新用户直接送 $0.2 消费额度,不需要充钱就能试用主要模型,包括 o3-mini。
另外还有个免费子站 free.yunwu.ai,用 GitHub 账号登录就能拿到 API key,每天有 GPT-4o 和 GPT-4o-mini 的免费调用额度。先跑通接入流程、验证代码能不能正常跑——这些都不需要花钱。
觉得没问题了,最低充 1 块钱就能继续用。中转站里这样“先免费试,再决定是否充值”的设计不算常见,但对新用户来说确实友好。
稳定性和安全性怎么样 #
平台官方标称可用性 99.9%,覆盖全球七大地区节点(美国、日本、韩国、英国、香港、菲律宾、俄罗斯)。o3-mini 调用响应速度稳定,流式输出无卡顿,并发无限制,国内网络直连不需要挂代理。
有一点可以放心:千聚采用了企业高速链,无路由二次数据留存,API key 余额永不过期(官方明确说明),还支持 100% 保值换绑。服务已有 20 万+ 用户和 800+ 中转代理合作伙伴,跑路风险相对较低。
适合哪些人用 #
用一句话分类:
个人开发者——想快速试验 o3-mini 的能力,不想折腾海外账号和绑卡,千聚是最省事的路子。
小型 AI 应用团队——国内直连 + OpenAI 兼容接口 + 多模型支持,上手快,不用自己维护翻墙方案。团队每个人注册一个账号就能独立使用。
做研究和模型对比的人——同一套代码切换模型,跑 benchmark 效率高。o3-mini 和其他模型可以随时切换对比。
AI 工具重度用户——Cursor 写代码、LobeChat 聊天、沉浸式翻译,只要支持自定义 API 地址的工具,接上千聚就能用上 o3-mini。
总结 #
3 分钟配置,改一行代码,零代理零绑卡——接入 o3-mini 就是这么简单。千聚api聚合平台提供的 1 元换 1 美元 Token、500+ 模型、国内直连、OpenAI 兼容接口、最低 1 元起充、新用户免费额度,让每个国内开发者都能零门槛用上最新的 AI 模型。
不是说它完美无缺,但该有的都有,用起来不折腾,定价透明,对绝大多数开发者来说够用而且实惠。