OminiApi 文档

Cherry Studio

在 Cherry Studio 中添加 OminiApi

OminiApi Team客户端接入约 6 分钟

Cherry Studio 是一款桌面 AI 客户端,支持 OpenAI、Anthropic、Gemini 等多种接口格式。

软件下载

到 Cherry Studio 官网 下载对应系统的安装包并安装。

选择提供商类型

OminiApi 的不同模型走不同的接口格式,在 Cherry Studio 里对应不同的「提供商类型」:

模型提供商类型API 地址
GPT 系列(gpt-6、gpt-5.6、gpt-5.5 等)OpenAIhttps://omini.ominiapi.top
DeepSeek / GLM / Kimi(deepseek-v4-pro、glm-5.3、kimi-k3 等)OpenAIhttps://omini.ominiapi.top
Claude 系列(claude-opus-5-5、claude-sonnet-5 等)Anthropichttps://omini.ominiapi.top
Gemini 系列(gemini-3.8-flash、gemini-3.1-pro-preview 等)Gemini 或 OpenAIhttps://omini.ominiapi.top

Claude 模型要用 Anthropic 类型

Claude 模型只支持 Anthropic 原生接口。在 OpenAI 类型的提供商里,模型列表虽然能看到 Claude 模型,但对话会报 No eligible upstream supports the requested interface or model。用 Claude 请单独添加一个 Anthropic 类型的提供商。

最终能用哪些模型,取决于你密钥的分组,以 模型广场 为准。

配置步骤

打开 Cherry Studio,点击左下角「设置」,进入「模型服务」。

在提供商列表底部点击「添加」:

  • 提供商名称:OminiApi(Claude 用的可以叫 OminiApi Claude)
  • 提供商类型:按上表选择

进入刚创建的提供商,填写:

字段值
API 密钥你的 API Key(见 API 密钥)
API 地址https://omini.ominiapi.top

OpenAI 类型填完后,输入框下方会预览完整地址 https://omini.ominiapi.top/v1/chat/completions,说明地址正确。

点击「管理」(或「获取模型列表」),勾选你要用的模型添加。列表里是这个 Key 能用的全部模型。

打开右上角的提供商开关,回到对话页,在顶部模型选择器里选择 模型名 | OminiApi,发一句话测试。

常见问题

  • 获取模型列表失败:检查 API 密钥和 API 地址,地址末尾不要多加 /v1。
  • 模型列表为空或缺模型:检查密钥的分组和模型白名单,见 模型列表。
  • Claude 模型能添加但聊天报错:提供商类型要选 Anthropic,见上面的说明。
  • 其他聊天报错:到控制台 使用日志 找到这次请求看错误原因,对照 错误码。

本页目录