Cherry Studio 接入指南

Cherry Studio 是一款桌面 AI 客户端，支持多模型 Provider，并提供对话、代码生成和文本生成等能力。通过配置 Step API Key，Cherry Studio 可以直接接入 Step 模型，在桌面客户端中调用推理能力。

本文档介绍 Cherry Studio 接入 Step API 的准备条件、配置步骤与基础测试流程。

概述

Cherry Studio 适合在统一桌面工作台中完成多模型对话和开发辅助任务。完成 Provider 配置后，即可在客户端内直接调用 Step 模型。

前置条件

客户端环境

支持以下系统：

• macOS
• Windows
• Linux

建议使用最新版本 Cherry Studio。

安装 Cherry Studio

访问 Cherry Studio 官网 下载安装包。

安装完成后启动 Cherry Studio。

订阅 Step Plan

在开始配置前，请先确认当前账号已完成 Step Plan 订阅。只有在账号具备对应计划或调用权限后，后续模型调用与额度使用才会正常生效。

如需订阅或购买，请访问：platform.stepfun.com/step-plan 

获取 Step API Key

访问 Step 平台控制台 创建 API Key，并妥善保存。

配置步骤

添加 Provider

打开 Cherry Studio，进入模型配置界面：

1. 在 Provider 列表中选择 Step
2. 输入 Step API Key
3. 保存配置

选择模型

完成 API Key 配置后，在模型列表中选择 Step 模型。推荐模型：

step-3.5-flash

选择后即可开始使用。

测试接入

可以在 Cherry Studio 中输入一个简单任务进行验证，例如：

Create a hello world script in Python

若接入成功，模型通常会返回类似结果：

print("Hello, world!")

常见问题

API Key 错误

如果出现以下报错：

401 Incorrect API key

请检查：

• Key 是否复制完整
• Key 是否属于正确环境（.ai / .com）

模型调用失败

若模型无法返回结果，请检查：

1. API Key 是否有效。
2. 是否选择了正确模型。

推荐模型：

step-3.5-flash

无法找到 Step Provider

如果 Provider 列表中未出现 Step，请检查：

1. Cherry Studio 是否为最新版本。
2. 当前网络环境是否正常。
3. 是否已重启客户端。

总结

完成 Provider 和模型配置后，Cherry Studio 即可通过 Step API 执行对话、文本生成和代码相关任务。建议先完成最小示例验证，再逐步扩展到自己的桌面工作流中。