小白3分钟上手:模型中转站Python调用保姆级图文教程,无海外信用卡也能轻松调用
2026-09-30
小白3分钟上手:模型中转站Python调用保姆级图文教程,无海外信用卡也能轻松调用 #
说实话,你只是想调用一下 GPT-4o 或者 Claude 来写段代码、做个翻译,结果发现要准备海外信用卡、折腾 VPN、还得担心账号被封——这套组合拳打下来,不少人直接放弃了。
但如果你接入了千聚API聚合平台,这事就变得特别简单:不用翻墙、不用绑海外信用卡、不用注册一堆麻烦的海外账号。今天这篇教程,我就手把手教你,从 0 到 1,用 Python 调用千聚API聚合平台的中转站接口,3 分钟跑通你的第一个 AI 对话程序。
👉 立即注册千聚API聚合平台,新用户送 $0.2 消费额度
第一步:注册并获取你的 API Key #
无论你想用哪个模型,第一步都是先拿到属于你自己的 “钥匙”(也就是 API Key)。
- 打开千聚API聚合平台官网:www.qianjuai.com
- 点击页面右上角的 「注册」 按钮。
- 用你的手机号或邮箱完成注册,然后登录。
- 登录后,在控制台左侧菜单找到 「API Keys」 或 「令牌管理」。
- 点击 「创建新令牌」,为你的 Key 起个名字(比如"我的第一个Key"),然后复制这个 Key 并保存好。
注意:这个 Key 只会在创建时显示一次,请务必妥善保管。如果丢失,可以在后台重新生成。
第二步:安装 Python 环境并配置 openai 库 #
千聚API聚合平台完全兼容 OpenAI 的 API 格式,所以我们可以直接用 Python 的 openai 库来调用。
打开你的终端(CMD、PowerShell 或终端),执行以下命令安装最新版库:
bash pip install openai
安装成功后,我们就可以开始写代码了。核心只需要修改两处:base_url 和 api_key。
第三步:写你的第一段调用代码(有手就行) #
创建一个新的 Python 文件,比如叫 test_qianju.py,然后把下面的代码复制进去。你需要做的就是把第 3 行和第 4 行换成你自己的信息。
注意:本文中所有的 API 接口链接都使用
https://www.qianjuai.com/v1,请勿修改。
python from openai import OpenAI
========== 你需要修改的只有这两行 ========== #
client = OpenAI( base_url=“https://www.qianjuai.com/v1", # 关键:换成千聚的统一地址 api_key=“sk-xxxxx” # 替换成你上一步复制的 API Key )
========================================== #
发起一次对话请求 #
response = client.chat.completions.create( model=“gpt-4o-mini”, # 这是性价比最高的模型,你也可以换成 claude-sonnet-4-20250514 等其他模型 messages=[ {“role”: “user”, “content”: “用一句中文总结:千聚API聚合平台是什么?”} ] )
打印返回结果 #
print(response.choices[0].message.content)
代码逐行解读(不怕你看不懂) #
client = OpenAI(...): 创建一个客户端对象,告诉程序我们要连接谁。base_url: 把默认的 OpenAI 地址,改成千聚API聚合平台的中转地址https://www.qianjuai.com/v1。api_key: 填上你在千聚后台生成的 Key。client.chat.completions.create(...): 发起聊天请求。model: 指定你想用的模型。比如用gpt-4o-mini、claude-sonnet-4-20250514、deepseek-chat等。支持超过500个模型,你可以去后台查看完整列表。messages: 聊天的历史记录,这里只有一条用户的提问。print(...): 把模型回答的内容打印出来。
第四步:运行代码,看看效果 #
在终端中输入以下命令并回车:
bash python test_qianju.py
如果一切正常,你会看到类似这样的输出:
千聚API聚合平台是一个国内直连的AI大模型API中转站,无需翻墙和海外信用卡,即可轻松调用GPT-4、Claude、DeepSeek等主流模型。
整个流程跑下来,可能都用不了 3 分钟。
进阶操作:支持流式输出和连续对话 #
如果你想让模型像 ChatGPT 一样一个字一个字地“蹦”出来,而不是一次性输出完,可以开启流式输出。
python from openai import OpenAI
client = OpenAI( base_url=“https://www.qianjuai.com/v1", api_key=“sk-xxxxx” )
流式输出 #
stream = client.chat.completions.create( model=“gpt-4o-mini”, messages=[{“role”: “user”, “content”: “用10个字描述一下编程”}], stream=True )
for chunk in stream: if chunk.choices[0].delta.content is not None: print(chunk.choices[0].delta.content, end=””)
这串代码会让模型一个字一个字地在你的终端里打印出来,效果很炫酷。
支持哪些模型?(一张表说清楚) #
千聚API聚合平台支持超过 500 个模型,下面是大家用得最多的几个系列:
| 模型系列 | 代表模型 | 适合场景 |
|---|---|---|
| OpenAI 系列 | gpt-4o, gpt-4o-mini, o1, o3 | 通用对话、代码生成、文本分析 |
| Anthropic 系列 | claude-sonnet-4-20250514, claude-3-opus | 长文写作、复杂推理、代码审查 |
| DeepSeek 系列 | deepseek-chat, deepseek-reasoner | 推理任务、超高性价比 |
| Google 系列 | gemini-2.5-pro, gemini-2.5-flash | 多模态理解、图像识别 |
| 其他系列 | qwen-max, glm-4, midjourney, suno | 图像生成、音乐生成、视频生成 |
所有这些模型,你用同一套代码,只需要改 model 参数的名字就可以了。
常见问题排查(遇到报错看这里) #
问:报错 AuthenticationError(认证错误)?
答:检查你的 api_key 是否写对了,并且确保 Key 没有过期或被删除。可以去控制台重新生成一个。
问:报错 NotFound 或模型不存在?
答:检查你的 model 名字是否正确。模型名字五花八门,建议先去千聚API聚合平台后台的「模型列表」里复制要用模型的名字。
问:网络连接超时?
答:千聚API聚合平台在国内可以直接访问。如果你用的是企业内网,请确认没有防火墙拦截 https://www.qianjuai.com/v1 这个地址。
问:调用 Claude 或者其他贵模型报错额度不足?
答:检查你的账户余额。新用户有 $0.2 免费额度,用完了需要最低充值 1 元。不同模型费率不同,claude-sonnet-4-20250514 这种高性能模型消耗额度会快一些。
总结:从今天开始,调用大模型可以这么简单 #
千聚API聚合平台真正做到了“不折腾,不绑卡,国内直连”。从你看到这篇文章,到成功跑通第一个 Python 程序,如果一切顺利,真的只需要 3 分钟。
没有海外信用卡的烦恼,没有翻墙的繁琐,没有封号的风险。你只需要:
- 注册千聚API聚合平台账号并拿到 Key。
- 安装
openai库。 - 把
base_url改成https://www.qianjuai.com/v1。
剩下的,就是发挥你的想象力,把 GPT-4o、Claude、DeepSeek 这些顶级模型接入你的项目里了。