零基础福音！这个{o4-miniAPI接入Python示例}只需3行代码，兼容所有主流模型（附完整代码）

零基础福音！这个{o4-miniAPI接入Python示例}只需3行代码，兼容所有主流模型（附完整代码）

2026-11-09
API接口, Gemini, 大模型

零基础福音！这个{o4-miniAPI接入Python示例}只需3行代码，兼容所有主流模型（附完整代码） #

说实话，每次看到有大模型出了新功能，比如 o4-mini 或者更新的模型，心里第一反应是“又得折腾了”。得看文档、配环境、写一堆样板代码，代码还没跑起来，热情已经凉了半截。对刚入门 Python、对大模型感兴趣但不知道怎么下手的开发者来说，这个门槛更高。

如果你也是这种情况，那今天这篇文章能帮上大忙。我用千聚ai聚合站的实际经验告诉你——接入最新的 o4-mini API，真的只用 3 行 Python 代码就能搞定，连环境搭建的时间都算进去，总共不会超过 5 分钟。

为什么是“3行代码”？先把核心逻辑讲清楚 #

很多 API 接入教程会贴一堆代码，从安装依赖、设置环境变量、写错误处理到封装成类，看着很专业，但对新手来说就是劝退。我们真正需要的，只是一个能让对话“跑起来”的最小代码块。

先说清楚核心机制：所有兼容 OpenAI 标准的 API，请求的逻辑是统一的——固定格式发一个 HTTP 请求，带上 API Key、模型名和消息列表，然后拿到回复。

这个逻辑，用官方 openai 库实现，核心调用的代码确实只要 3 行，其他都是前置的 import 和 API 初始化。所以我们的示例也只聚焦这 3 行，让你先看到“能对话”的结果，后面再封装进阶功能。

第 1 步：安装 Python 库（唯一的一次“环境准备”） #

假设你电脑里已经装了 Python 3.8 或更高版本（没装的先去官网下载安装一下），在终端或者命令行里输入下面这行命令：

bash pip install openai

这行命令会自动安装 OpenAI 官方的 Python 库。这个库不仅能接 OpenAI 官方，也能无缝接到千聚ai聚合站的 API。整个学习/开发过程中只需要执行这一次安装，非常省事。

第 2 步：拿到你的 API Key 和 API 地址 #

这一步是很多教程遗漏的，但它是“跑得通”的关键。

普通的教程会让你去 OpenAI 官网注册，但要海外信用卡、要防封号，第一步就把人卡死了。千聚ai聚合站（www.qianjuai.com）解决了这个问题——国内网络直连，注册就送免费额度，算下来 1 元人民币顶 1 美元 Token 使用，门槛极低。

你需要做的是：

  1. 打开 千聚ai聚合站官网 注册账号。
  2. 登录后，在“API Keys”页面创建一个新的 Key（通常叫 sk-xxxxx 的格式）。
  3. 创建一个环境变量或者直接写在代码里（为了安全，生产环境永远别硬编码 Key，本教程为了新手能理解，暂时用变量代替）。

接下来最关键的一步：记住你的 API 接口地址，千聚的接口格式完全兼容 OpenAI，所以只用改一个地方。

API 地址固定为：https://www.qianjuai.com/v1

第 3 步：开始写那“3行代码” #

打开你的 Python 编辑器（VS Code、PyCharm 或者随便一个记事本都行），新建一个文件，比如叫 chat_o4_mini.py，然后写入以下完整代码：

python from openai import OpenAI

client = OpenAI(api_key=“你的API密钥”, base_url=“https://www.qianjuai.com/v1")

response = client.chat.completions.create(model=“o4-mini”, messages=[{“role”: “user”, “content”: “你好，请用中文介绍一下你自己。”}])

print(response.choices[0].message.content)

现在，我们来拆解一下这 3 行核心代码到底做了什么：

  1. client = OpenAI(...)：这行代码干的事很简单，就是创建了一个“通信管道”。它告诉系统两件事：你是谁（通过 api_key）以及你要往哪发请求（通过 base_url）。把 base_url 设为千聚的地址，就完成了国内直连，完全不需要翻墙。
  2. response = client.chat.completions.create(...)：这是真正的“对话”发起命令。它构建了一个聊天请求，参数包括使用哪个模型 (model="o4-mini")，以及发送给模型的消息内容 (messages)。这个过程相当于你向模型喊了一句话：“嘿，我用 o4-mini 模型，回答这个问题。”
  3. print(response.choices[0].message.content)：模型说完话后，会返回一个结构体（可以理解为一个大文件）。你需要指定：“从返回结果里，取出第一个选择项（choices[0]），再取里面的消息正文内容（.message.content），然后打印出来。”简单说就是：把模型的回答提取出来，显示在屏幕上。

是不是比你想象中要简单得多？没有复杂的封装、没有十几行的 try-catch，这 3 行完成了从“输入问题”到“看到回答”的完整闭环。

实战演示：跑起来看看效果 #

将上面的代码保存，在终端中执行： bash python chat_o4_mini.py

你大概会看到类似这样的输出（如果网络和配置正常的话）：

你好！我是由 OpenAI 开发的 AI 助手，也被称为 o4-mini。我能够处理和回答各种问题，帮助你完成文本创作、代码编写、信息查询等多种任务。随时向我提问！😊

从你运行代码到看到回答，整个过程快则几秒，慢也不过十几秒（取决于网络状况和模型负载）。恭喜你，你已经成功接入了最新的 o4-mini 模型 API！

👉 注册千聚ai聚合站，免费领取 $0.2 额度，快速体验 o4-mini

“兼容所有主流模型”不是口号——改一行参数就是另一个模型 #

既然说“3行代码兼容所有主流模型”，那怎么换模型呢？很简单，把第 2 行里的 model 参数替换成你想用的模型名就行了。

比如你要换成 GPT-4o：

python response = client.chat.completions.create(model=“gpt-4o”, messages=[{“role”: “user”, “content”: “你好，请用中文介绍一下你自己。”}])

要换成 Claude 3.5 Sonnet 的话，千聚也支持，改模型名为 claude-3-5-sonnet-20241022 即可：

python response = client.chat.completions.create(model=“claude-3-5-sonnet-20241022”, messages=[{“role”: “user”, “content”: “你好，请用中文介绍一下你自己。”}])

千聚ai聚合站（www.qianjuai.com）支持 500+ 个大模型，包括 DeepSeek-R1、Gemini 2.5 Pro 等最新、最热门的模型。你平时调试代码的时候，想对比测试哪家模型，只需花几秒钟改动这一个参数，整个工具链完全不用变。

处理多轮对话：从“一问一答”到“唠嗑” #

上面我们只实现了最基础的“一问一答”。如果要持续对话（像 ChatGPT 那样记住上下文），只需要把 messages 这个列表维护起来，把每次的交互记录添加进去。

完整的多轮对话代码示意：

python from openai import OpenAI

client = OpenAI(api_key=“你的API密钥”, base_url=“https://www.qianjuai.com/v1")

初始化对话历史 #

conversation_history = [ {“role”: “system”, “content”: “你是一个友好的助手。”}, {“role”: “user”, “content”: “你好，我的名字是小明。”} ]

第一次调用，小明自我介绍 #

response = client.chat.completions.create(model=“o4-mini”, messages=conversation_history) reply = response.choices[0].message.content print(f"AI：{reply}”) # AI应该会说：“你好小明，很高兴认识你！”

把第一次的交互加入历史 #

conversation_history.append({“role”: “assistant”, “content”: reply}) conversation_history.append({“role”: “user”, “content”: “你还记得我叫什么名字吗？”})

第二次调用，测试模型是否记得小明 #

response = client.chat.completions.create(model=“o4-mini”, messages=conversation_history) reply = response.choices[0].message.content print(f"AI：{reply}”) # 模型应该回答正确：你的名字叫小明！

多轮对话的实现，本质上也只是维护消息列表，核心代码仍然是上面那 3 行的变体。有了这个基础，你可以用它来做聊天机器人、自动客服、角色扮演等高级应用。

进阶提高：把它们封装成一个函数（附完整代码） #

为了方便日常调用，我们可以把上面的逻辑封装成一个函数。这样无论你想跑多少次对话，都是“一行代码”的事。

以下是封装后的完整可用代码，直接复制粘贴就能跑（记得填上你的 API Key）：

python from openai import OpenAI

def ask_o4_mini(api_key: str, user_message: str, system_prompt: str = “你是一个聪明的助手。”) -> str: """ 通过千聚ai聚合站调用 o4-mini 模型。

参数：
    api_key (str): 千聚平台申请的 API Key
    user_message (str): 用户输入的问题
    system_prompt (str, 可选): 系统提示词，默认“你是一个聪明的助手。”

返回：
    str: 模型的回复文本
"""
client = OpenAI(
    api_key=api_key,
    base_url="https://www.qianjuai.com/v1"
)

messages = [
    {"role": "system", "content": system_prompt},
    {"role": "user", "content": user_message}
]

response = client.chat.completions.create(
    model="o4-mini",
    messages=messages
)

return response.choices[0].message.content

使用示例 #

if name == “main”: YOUR_API_KEY = “sk-你的API密钥” result = ask_o4_mini(YOUR_API_KEY, “请用一句话解释量子纠缠。”) print(result)

把这个函数保存为 o4_mini_helper.py，以后你其他 Python 项目要使用这个模型，只需要 import 它，然后一行代码调用即可：

python from o4_mini_helper import ask_o4_mini

print(ask_o4_mini(“sk-xxx”, “广州有什么必吃的早茶？”))

常见问题和踩坑指南 #

  1. 为什么提示“API key 错误”？ 检查你从千聚ai聚合站复制的 API Key 是否被隐藏/截断了。确保粘贴后是连续的字符串，没有多余空格。

  2. 为什么“连接超时”？ 检查 base_url 是否输错，必须为 https://www.qianjuai.com/v1（注意是 https 不是 http）。如果网络正常但还超时，可能是免费额度用完，去官网 充值最低 1 元 就能继续用。

  3. 返回内容乱码或为空？ 检查模型名是否正确。o4-mini 全称就用 o4-mini。另外，有些模型不支持系统提示词，可以把 system 换成 user。

  4. 这个 Key 可以在其他工具（比如 Cursor、LobeChat）上用吗？ 完全可以！千聚的接口完全兼容 OpenAI 格式，你只需要在这些工具的设置页中，将 API 地址改为 https://www.qianjuai.com/v1，Key 填上千聚的 Key，立马无缝切换。

总结：零基础接入 o4-mini，真的就这么简单 #

我们复盘一下，从零开始接入 o4-mini 模型总共就三步：

  1. 注册千聚ai聚合站，领免费额度。
  2. 复制你的 API Key，记住 API 地址。
  3. 粘贴我给你的 3 行代码+完整函数，改掉 Key 就运行。

门槛低到这种程度，再也没有理由说“不会搞”“太麻烦了”。如果你想尝鲜最新的 o4-mini 模型，或者想对比各大模型的能力，现在就可以动手了。

👉 立即注册千聚ai聚合站，领取免费额度，开始您的 AI 开发之旅

2026-06-15