# Cherry Studio 接入 Agnes Image 2.1 Flash 完整教程：免费实现 AI 图片识别与多模态对话 最近在体验各类 AI 模型时，发现许多支持图片识别的模型都需要付费额度，对于个人开发者而言使用成本确实不低。这次为大家分享一个非常实用的方案——**Agnes Image 2.1 Flash 多模态大模型**，它提供了免费且强大的视觉识别能力，并且可以直接接入 **Cherry Studio** 使用。 整个配置过程只需几分钟，完成后即可在 Cherry Studio 中轻松实现以下功能： - 图片识别 - 图片内容分析 - OCR 文字提取 - 图表理解 - 截图问答 - 多模态对话 下面将详细记录完整的接入流程。 ## 一、Agnes Image 2.1 Flash 是什么 **Agnes Image 2.1 Flash** 是一款专注于视觉理解的多模态大模型，其核心功能可通过下表清晰了解： | 功能 | 支持情况 | |--------------|----------| | 文本对话 | ✓ | | 图片识别 | ✓ | | OCR 文字识别 | ✓ | | 图表分析 | ✓ | | 多轮对话 | ✓ | | 免费使用 | ✓ | 相比市场上许多需要付费的视觉模型，这款模型对于日常体验和开发测试来说，确实更加便捷、零成本。 ## 二、下载 Cherry Studio 客户端 首先下载 Cherry Studio 最新版。 官方下载地址： ``` https://cherry-studio-ai.com/ ``` 进入官网后根据操作系统选择对应版本安装，支持 Windows、macOS、Linux 三大平台。 安装完成后先不要急于配置模型，接下来需要获取 Agnes AI 的 API Key。 ## 三、获取 Agnes AI API Key 访问 Agnes AI 开发者平台： ``` https://platform.agnes-ai.com/ ``` 登录成功后，进入 API 密钥管理页面： ``` https://platform.agnes-ai.com/settings/apiKeys ``` 也可以直接点击上方链接进入。在页面中点击“创建新密钥”，输入一个名称（例如 `CherryStudio`），点击创建后系统将自动生成 API Key，格式类似： ``` sk-xxxxxxxxxxxxxxxx ``` 此时点击右侧的“复制”按钮即可保存 API Key。 ## 四、在 Cherry Studio 中配置 Agnes AI 打开 Cherry Studio，点击左下角的“设置”，进入配置页面。找到“模型服务”模块，下拉至最底部，点击“添加”按钮。 ### 创建服务商 在弹出的窗口中填写以下信息： - **名称**：Agnes AI - **供应商类型**：选择 **OpenAI**（保持默认） 然后点击“确定”。 ### 填写接口信息 创建完成后，在配置表单中填写： - **API 密钥**：粘贴刚才复制的 Key（`sk-xxxxxxxxxxxxxxxx`） - **API 地址**： ``` https://apihub.agnes-ai.com/v1 ``` 配置示例： ``` API Key：sk-xxxxxxxxxxxxxxxx Base URL：https://apihub.agnes-ai.com/v1 ``` ## 五、获取模型列表 配置完成后，点击“获取模型列表”按钮，系统会自动拉取平台支持的模型。然后选择模型： ``` agnes-2.0-flash ``` 勾选并确认即可。 ## 六、检测接口是否正常 在 API 密钥右侧找到“检测”按钮，点击后进行连通性测试。如果弹出“连接成功”提示，说明配置已完全正确。 此时 Agnes AI 已经成功接入 Cherry Studio。 ## 七、开始对话测试 返回“助手”页面，创建新的会话。选择 `agnes-2.0-flash` 模型，然后直接输入问题即可开始聊天。 例如： - 介绍一下 Vue3 响应式原理 - 帮我分析这段代码 都能快速得到回复。实际测试中响应速度非常快，基本达到秒级返回。 ## 八、开启图片识别功能 很多朋友配置完成后会遇到一个问题：为什么上传图片无法识别？原因在于 Cherry Studio 默认没有开启视觉能力，需要手动开启。 ### 进入模型设置 返回“设置”页面，找到 `agnes-2.0-flash` 模型，点击模型右侧的“设置”按钮。 ### 更多设置 进入“更多设置”，找到“模型类型”选项。你会看到多个选项，默认状态是： ``` ✓ Chat □ Vision ``` 需要手动勾选 **Vision** 视觉能力，最终状态为： ``` ✓ Chat ✓ Vision ``` 即同时开启文本对话和图像识别能力。保存配置即可。 ## 九、测试图片识别效果 再次回到会话页面，上传一张图片（例如网页截图、文档、图表、商品图片等），然后输入： - 请分析图片内容 - 提取图片中的文字 即可获得精准识别结果。例如上传一张网页截图后，可以返回： - 页面结构分析 - 文本内容提取 - 按钮功能说明 - 页面布局描述 对于开发者快速分析页面结构来说，确实非常实用。 ## 十、完整配置参数汇总 为了方便一键配置，这里整理一份完整参数表： | 配置项 | 内容 | |--------------|------------------------------------| | 服务名称 | Agnes AI | | 供应商类型 | OpenAI | | API 地址 | https://apihub.agnes-ai.com/v1 | | 模型名称 | agnes-2.0-flash | | API Key | 在 Agnes 平台生成 | | 图片识别 | 开启 Vision | | 是否免费 | 是 | ## 总结 通过 OpenAI 兼容接口，**Agnes AI** 可以非常方便地接入 **Cherry Studio**。整个流程主要分为四步： 1. 下载 Cherry Studio 2. 创建 Agnes API Key 3. 配置 OpenAI 接口 4. 开启 Vision 视觉能力 配置完成后，即可获得 AI 聊天、图片识别、OCR 文字提取、图表分析、多模态问答等一系列功能。对于平时需要体验视觉模型、分析截图、识别图片内容的开发者来说，这是一个完全免费且极为实用的方案。使用门槛低，配置过程简单，只需几分钟即可完成接入。