MiniCPM-o-4.5入门：Python环境安装与第一个“Hello World”程序

你是不是也对最近火热的AI大模型充满好奇，想亲手试试调用一个模型，让它跟你对话？但一看到那些复杂的部署教程、陌生的命令行，是不是又有点打退堂鼓了？

别担心，今天这篇就是为你准备的。我们不谈复杂的理论，也不搞繁琐的配置，就从最最基础的Python环境安装开始，手把手带你跑通第一个与大模型对话的“Hello World”程序。整个过程就像搭积木，你只需要跟着步骤一步步来，就能亲眼看到AI是如何回应你的。我们的目标是：让你在今天结束前，就能和MiniCPM-o-4.5这个模型成功“对上话”，建立最初的信心。

1. 第一步：搭建你的Python“工作台”

想象一下，Python就像是你和AI模型沟通的“翻译官”和“传令兵”。你要告诉模型做什么，或者接收模型生成的结果，都需要通过Python这个中间人。所以，我们的第一步，就是把这个“翻译官”请到你的电脑上。

1.1 下载Python安装包

首先，你需要去Python的官方网站下载安装程序。直接打开浏览器，搜索“Python官网”或者访问 python.org，找到“Downloads”页面。

对于绝大多数新手，我强烈建议选择 Python 3.10 或 3.11 版本。这两个版本非常稳定，和我们要用的各种工具兼容性也最好。太老的版本可能缺少一些功能，太新的版本有时又会遇到一些奇怪的兼容性问题，所以3.10或3.11是当下的“甜点”选择。

在下载页面，你会看到两个大的按钮，一个是“Download Python 3.x.x”，另一个可能是“Download Python 3.x.x for Windows”（如果你的系统是Windows）。直接点击那个大大的下载按钮就行。安装程序不大，很快就能下好。

1.2 安装Python并记住关键一步

运行你刚下载的安装程序。这里有一个至关重要的步骤，请务必留意：

在安装向导的第一个界面，你会看到底部有一行小字 “Add python.exe to PATH”，前面有个复选框。请务必勾选它！ 这相当于告诉你的电脑：“以后无论在哪个文件夹，我都能直接找到Python这个命令。” 如果不勾选，后续操作会非常麻烦。

勾选之后，点击“Install Now”即可。安装过程很快，喝口水的时间就好了。

1.3 验证安装是否成功

安装完成后，我们需要确认一下“翻译官”是否真的就位了。

1. 按下键盘上的 Win + R 键（Windows系统），会弹出“运行”窗口。
2. 输入 cmd 然后按回车，这会打开一个黑底白字的“命令提示符”窗口。
3. 在这个窗口里，输入 python --version 然后按回车。

如果安装成功，你会看到类似 Python 3.10.11 这样的版本信息。恭喜你，Python环境已经准备就绪！

2. 第二步：准备与模型对话的“工具包”

光有“翻译官”还不够，我们还需要一些专门的“工具”来和MiniCPM-o-4.5模型进行通信。这些工具被打包成一个个“代码库”，在Python的世界里，我们管它们叫“包”或“库”。安装它们只需要一个简单的命令。

2.1 认识两个核心工具包

我们需要安装两个主要的包：

• requests：你可以把它想象成“邮差”。它的工作就是把你的话（请求）打包，发送给远方的模型服务器，然后再把模型的回信（响应）带回来给你。
• openai：这个包提供了一套非常方便、标准的“对话模板”。虽然MiniCPM-o-4.5不是OpenAI的模型，但很多国产模型都兼容这套模板，这让我们的调用代码写起来非常简洁、统一。

2.2 一键安装工具包

安装这些“工具包”同样在命令提示符里完成。请确保你已经在之前打开的cmd窗口里，或者新打开一个。

输入以下命令，然后按回车：

pip install requests openai

pip 是Python自带的“软件包管理器”，你可以理解为“App Store”。这条命令就是告诉pip：“去帮我把requests和openai这两个应用下载并安装好。”

等待它运行完成，出现“Successfully installed”的字样，就说明工具包也准备好了。

3. 第三步：编写你的第一个AI对话程序

环境齐备，现在可以写代码了。别怕，代码非常简单，只有十几行。我会逐行给你解释。

3.1 创建你的Python脚本文件

首先，在你电脑上找一个你喜欢的位置，比如桌面，新建一个文本文档。然后，把它的名字改成 hello_ai.py。注意，后缀名必须是 .py，这代表它是一个Python脚本文件。

你可以用系统自带的记事本打开它，但我更推荐使用 VS Code 或 Notepad++ 这类专门的代码编辑器，它们会有语法高亮，看起来更舒服。没有也没关系，记事本完全够用。

3.2 理解代码的每一部分

接下来，将下面的代码完整地复制到你的 hello_ai.py 文件中。然后，我们一起来看每一行是干什么的。

# 导入我们安装好的“工具包”
import openai

# 配置如何连接到模型服务器
client = openai.OpenAI(
    api_key="your-api-key-here",  # 这里是你的通行证，下一步会告诉你如何获取
    base_url="https://api.example.com/v1"  # 这里是模型服务器的地址，下一步会提供
)

# 开始和模型对话！
response = client.chat.completions.create(
    model="minicpm-o-4.5",  # 告诉服务器我们要调用哪个模型
    messages=[
        {"role": "user", "content": "你好，请用中文介绍一下你自己。"}  # 这是我们发送给模型的话
    ],
    stream=False  # 我们一次性等完整回复，而不是一个字一个字地接收
)

# 把模型的回复打印出来给我们看
print("AI的回复：")
print(response.choices[0].message.content)

代码解读：

1. import openai：这行代码把我们安装好的openai工具包“请”进来，这样我们才能使用它里面的功能。
2. client = openai.OpenAI(...)：这行代码是在创建一個“客户端”。想象一下，你要打电话给一个朋友，你得先知道他的电话号码（base_url）和通话密码（api_key）。这里就是在设置这两个信息。目前里面的值是占位符，我们稍后替换成真实的。
3. client.chat.completions.create(...)：这是最核心的一步，发起一次对话。我们通过model参数指定找“MiniCPM-o-4.5”这个模型聊天。messages里面是一个列表，记录着对话历史。现在我们只发了一条用户消息（role: “user”），内容就是“你好，请用中文介绍一下你自己。”
4. print(...)：模型回复后，它的回答会被包装在response这个对象里。response.choices[0].message.content 这个路径就像是一个地址，能精准地找到回复的文本内容，然后用print函数把它显示在屏幕上。

3.3 获取并填写关键信息

上面的代码还不能直接运行，因为 api_key 和 base_url 还是假的。这两个信息需要从提供MiniCPM-o-4.5模型服务的平台获取。

如何获取（通用思路）：

1. 寻找模型服务：你需要访问一个提供了MiniCPM-o-4.5在线API服务的平台。这可能是某个云服务商、AI模型社区或专门的API平台。
2. 注册与创建：通常需要注册账号，然后在平台上创建一个“应用”或“API密钥”。
3. 查看文档：在平台的文档或API使用指南里，你会找到：
   • API Key：一串像密码一样的字符（如 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx），这就是你的api_key。
   • API Base URL：一个网络地址（如 https://api.openai.com/v1 或平台自定义的地址），这就是你的base_url。
   • 模型名称：确认平台调用该模型时使用的准确名称，填入代码的 model 参数。

（请注意：由于模型服务提供商可能变动，此处无法提供固定的真实密钥和地址。请根据你实际使用的平台文档进行填写。）

假设你从某个平台获得了如下信息：

• API Key: sk-this-is-your-real-key-123456
• Base URL: https://api.aimlplatform.com/v1

那么，你就应该把代码中的那两行修改为：

    api_key="sk-this-is-your-real-key-123456",
    base_url="https://api.aimlplatform.com/v1"

4. 第四步：运行程序，见证奇迹

最激动人心的时刻到了！让我们运行这个脚本，看看AI会怎么回应。

1. 打开命令提示符（cmd）。
2. 使用 cd 命令，导航到你存放 hello_ai.py 文件的文件夹。例如，如果你的文件在桌面：

   cd Desktop
   

3. 输入运行命令：

   python hello_ai.py
   

4. 按下回车。

稍等几秒钟（时间长短取决于网络和服务器状态），你应该就能在屏幕上看到MiniCPM-o-4.5模型用中文发来的自我介绍了！它可能会说：“你好！我是MiniCPM-o-4.5，一个由XXX开发的大语言模型……” 至此，你的第一个AI“Hello World”程序就成功运行了！

5. 第五步：尝试更多对话

成功了一次，信心就来了。现在，你可以尝试修改代码中的对话内容，和模型进行更多互动。

打开 hello_ai.py 文件，找到这一行：

        {"role": "user", "content": "你好，请用中文介绍一下你自己。"}

把双引号里的文字改成任何你想问的问题，比如：

• "讲一个关于小猫的短故事"
• "用Python写一个计算斐波那契数列的函数"
• "今天天气真好，帮我写一首赞美春天的五言诗"

保存文件，然后重新在cmd里运行 python hello_ai.py。看看每次它都会给你什么不一样的惊喜。

6. 总结与后续探索

看，从零开始到成功调用一个大模型，并没有想象中那么复杂，对吧？整个过程就像是在完成一个简单的拼图：安装Python环境、准备好通信工具、写一段简短的“介绍信”、然后发送出去。最关键的一步，其实就是获取到正确的API访问信息。

这次我们用的是最基础的、一次一问一答的方式。当你熟悉了这个流程，就可以去探索更多有趣的功能，比如让模型记住上下文进行连续对话（在messages列表里追加历史记录），或者尝试不同的模型参数来控制回复的长度、创意性等等。

第一次运行成功带来的成就感是最强的。希望这个小小的“Hello World”能成为你探索AI世界的一块坚实跳板。接下来，你可以用同样的模式去尝试其他模型，或者用这个能力去构思一些解决实际生活、工作问题的小工具了。动手去试，遇到问题就搜索，这才是学习技术最快的方式。

---

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。