CherryIN Docs

账户额度足够为什么提示额度不足？

这是因为令牌额度和账户额度是分开的：

令牌额度仅用于设置最大使用量限制
用户可以自由设置令牌额度
请检查您的令牌额度是否充足

为什么我的请求提示次数过于频繁？

这是因为我们为了保障所有用户的体验，目前设置了一个 30 分钟 495 次成功请求的限制（次数随时可能会变）。

请合理使用服务。若发现异常使用（如异常高频请求、账号共享等），我们可能会对账号进行 7 天限制，以保障服务稳定。

使用过程中如有问题，可前往关于页面添加微信交流群，我们将及时为您解答。

为什么标记为 free 的模型，我账号没有充值之前无法使用或者 CherryStudio 里面测试连接报错？

我们的服务都是正规渠道，保障质量的同时提供了一系列方便用户快速体验的模型，因此只针对付费用户提供免费模型，用户在没有付费前无法使用。

为什么 DeepSeek V4 Flash / Pro 在 CherryStudio Agent 中无法使用 Web Search？

CherryStudio Agent 中的 Web Search 是由云服务提供的服务端工具，其可用性取决于对应云服务是否稳定支持这项能力。

为了保障模型服务的整体稳定性，CherryIN 会使用不同的云服务提供 DeepSeek V4 Flash / Pro。由于不同云服务对 Web Search 的支持存在差异，目前 CherryIN 暂时无法为这两个模型稳定提供该工具。

这通常不是 API Key 或 CherryStudio 配置错误。如果需要联网搜索能力，建议在 CherryStudio 中配置 Exa MCP 使用。

为什么模型回答自己的版本号不准确？

如果你询问模型「你是什么版本？」或「你是什么模型？」，得到的回答与实际 API 配置不一致，通常属于正常现象，并不代表模型接入错误。

模型的回答主要来自训练数据、上下文和系统提示。默认情况下，它无法直接读取当前请求实际使用的模型名称或版本信息。此外，模型的正式名称和版本号可能在训练期间或训练完成后才最终确定。因此，当模型被问到自己的版本时，它只能根据已有知识进行推断，可能回答旧版本、相近版本或不准确的名称。

Gemini、GPT、Claude、Qwen 等主流大模型都可能出现这种情况。

为什么官方 App 中的模型通常能正确回答版本号？

官方 App 或网页通常会通过系统提示（System Prompt）或其他运行时信息，把当前模型名称明确告诉模型。

因此，模型看起来像是「知道」自己的版本，实际上是应用向它提供了身份信息，并不是模型自行识别出了运行版本。第三方客户端和普通 API 请求通常不会注入这些信息，所以模型的自我介绍可能与实际配置不一致。

如何确认自己调用的是哪个模型？

请以 CherryIN 控制台中选择的模型为准，不要以模型的自我介绍作为判断依据。模型回答错误的版本号，不会影响实际调用的模型和使用效果。

如果希望进一步了解模型的实际能力，可以使用 ToolCall-15 等第三方基准进行测试。相比直接询问模型版本号，统一的能力测试结果更客观，也更有参考价值。

中国大陆地区API充值可以开发票吗？

目前暂时不行，我们的支付渠道目前不支持这项功能。

API Key 在哪里创建，Base URL 应该填写什么？

在 CherryIN 控制台的「令牌管理」页面创建 API Key。大多数支持 OpenAI 兼容协议的客户端应填写：

https://open.cherryin.net/v1

使用 CherryStudio 内置的 CherryIN 供应商时，通常只需要填写 API Key。如果具体工具的接入指南给出了不同配置，请以对应指南为准。更多信息请参阅 OpenAI 兼容工具通用接入指南。

为什么提示 `401 Unauthorized`？

401 通常表示身份验证失败，请依次检查：

API Key 是否复制完整
Key 前后是否包含空格或换行
请求是否通过 Authorization: Bearer <API_KEY> 传递密钥
客户端中是否误填了其他平台的 Key

请勿在聊天、截图或公开代码仓库中发送完整 API Key。

为什么提示 `404` 或找不到模型？

首先确认 Base URL 和模型名称：

大多数 OpenAI 兼容客户端使用 https://open.cherryin.net/v1
模型名称需要使用完整的 厂商/模型名，例如 anthropic/claude-sonnet-4.5
登录 CherryIN 控制台，在「模型列表」页面确认当前可用的模型 ID

不同客户端可能会自动追加 /v1，请避免最终请求地址出现重复路径。

CherryIN 可以直接使用 OpenAI SDK 或兼容工具吗？

可以。将 SDK 或工具的 API Key 替换为 CherryIN Key，并将 Base URL 设置为 https://open.cherryin.net/v1。模型支持情况和参数可能有所不同，请使用控制台展示的完整模型 ID。代码示例请参阅 API 调用教程。

应该如何安全保存 API Key？

本地开发使用环境变量或已加入 .gitignore 的 .env 文件
生产环境使用云平台 Secret 或专用密钥管理服务
不要把 Key 写入前端代码、公开仓库、日志或截图
如果怀疑 Key 已泄露，请立即停用并创建新 Key

怎么处理 CherryStudio 对话 Gemini Banana Pro 模型，会出现较高概率不出图问题？

有几个建议：

在供应商 CherryIN 模型端点，把 google/gemini-3-pro-image-preview 改成 Gemini 端点

对话页设置：出图场景关闭流式，对话上下文限制 1-2

常见问题