CherryIN Docs

适用于 Cline、Dify、n8n、Chatbox、CherryStudio 等支持 OpenAI 兼容协议的工具

这篇文档适合谁？

如果你正在使用的工具支持以下任意一种配置方式，这篇文档就可以直接套用：

OpenAI
OpenAI Compatible
Custom OpenAI
自定义 OpenAI 提供商
允许你手动填写 Base URL 和 API Key

典型工具包括：Cline、Dify、n8n、CherryStudio、Chatbox，以及大部分支持 OpenAI 协议的 AI 客户端和工作流工具。

你只需要准备 3 个值

字段	填什么	示例
`Base URL`	CherryIN 的 OpenAI 兼容地址	`https://open.cherryin.net/v1`
`API Key`	你在 CherryIN 控制台创建的令牌	`sk-xxxxxxxx`
`Model ID`	完整模型名，格式是 `厂商/模型名`	`anthropic/claude-sonnet-4.5`

令牌分组建议

新手默认建议使用 default 分组的 Key，它可以直接调用更多模型。若你要使用活动分组的折扣模型，请确保 Key 和模型分组匹配。可先参考快速上手。

不同工具里的字段通常长什么样？

工具里的字段名	你应该填写的内容
`API Provider` / `Provider`	选择 `OpenAI`、`OpenAI Compatible` 或 `Custom OpenAI`
`Base URL` / `API Base URL` / `Endpoint`	`https://open.cherryin.net/v1`
`API Key` / `Bearer Token`	你的 CherryIN Key
`Model` / `Model ID`	例如 `anthropic/claude-sonnet-4.5`
`Organization ID`	一般留空即可

通用填写模板

在工具里选择 OpenAI 或 OpenAI Compatible 类型的提供商。
将 Base URL 填为 https://open.cherryin.net/v1。
将 API Key 填为你在 CherryIN 创建的 Key。
将模型填写为完整模型 ID，例如 anthropic/claude-sonnet-4.5。
点击测试、保存，或直接发一条消息验证。

关于模型名称

CherryIN 的模型名不是只写 claude-sonnet-4.5，而是要写完整的 厂商/模型名，例如 anthropic/claude-sonnet-4.5。

什么时候用 Chat Completions，什么时候用 Responses？

场景	建议接口
大多数聊天工具、IDE 插件、工作流节点	`Chat Completions`
工具允许你手动指定原始接口，且你要调用 GPT-5.x 系列模型	`Responses API`

GPT-5.x 兼容性

像 openai/gpt-5.2-chat 这类 GPT-5.x 模型，请优先使用 Responses API，不要走 Chat Completions。

Chat Completions 示例

curl https://open.cherryin.net/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -d '{
    "model": "anthropic/claude-sonnet-4.5",
    "messages": [
      {"role": "user", "content": "你好，请用一句话介绍你自己"}
    ]
  }'

Responses API 示例

curl https://open.cherryin.net/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -d '{
    "model": "openai/gpt-5.2-chat",
    "input": "请把 CherryIN 的接入方式总结成 3 个要点"
  }'