通用兼容指南

任何支持「自定义 OpenAI 兼容接口」的工具都能接我们。 你用的工具没在上面的列表里？按这份通用说明填就行。

1. 先判断你的工具能不能接

在它的设置里找这几个关键词，出现任意一个就说明能接：

关键词	说明
自定义接口 / Custom Provider	可以新建一条自己的
OpenAI 兼容 / OpenAI Compatible	协议匹配
Base URL / API 地址 / 接口地址	能改地址就够了
反向代理 / Proxy	有些工具把这个当入口

如果只能选内置的「OpenAI / Anthropic / Gemini」而没有自定义入口 —— 那这个工具接不了我们。告诉我们工具名字，我们看看有没有替代方案。

2. 四个值，对号入座

不管界面怎么称呼，本质都是这四项：

通用填法

接口地址https://sccclm.com/v1

密钥你的 sk-* 密钥

模型名newcclm-fast

协议OpenAI 兼容（不要选 Anthropic）

3. 地址该填到哪一层

这是最容易出错的地方。不同工具对「接口地址」的期望不一样，取决于它自己会不会补路径：

工具的行为	你填	例子
它自己补 `/v1/chat/completions`	只填域名	`https://sccclm.com`
它只补 `/chat/completions`	填到 `/v1`	`https://sccclm.com/v1`
它要求完整端点	填完整	`https://sccclm.com/v1/chat/completions`

怎么知道是哪种？试一次就知道。 先填 https://sccclm.com/v1；报 404 就换成 https://sccclm.com；还报 404 就填完整端点。三次以内一定能试出来，不用查文档。

4. 不要这样配

不要叠加 /v1

# 错误 —— 会变成 /v1/v1/...
https://sccclm.com/v1/v1

不要填真实模型名

# 错误 —— 我们只认自己的档位名
gpt-4o
claude-3-5-sonnet
deepseek-chat

# 正确
newcclm-fast
newcclm-coding

不要选 Anthropic 协议

有些工具会让你选「OpenAI 格式」还是「Anthropic 格式」。一律选 OpenAI —— 选另一个会连不上。

不要把密钥写进提示词或对话里

密钥只填在设置里。写进对话内容既没用，又会泄露。

5. 测一下

配好之后，先用这条确认服务本身是通的：

curl https://sccclm.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"newcclm-fast","messages":[{"role":"user","content":"你好"}]}'

结果	说明
返回带内容的 JSON	服务端没问题 → 接下来查工具设置
`Invalid token`	密钥不对，与我们无关
`model not found`	模型名写错
`404`	地址层级不对，看第 3 节
连不上 / 超时	网络问题

6. 需要的话，把工具名字给我们

告诉我们你在用哪个工具，我们会补一份专门的配置说明。提供工具名和一张设置页截图（密钥打码）就够。

最常见的三种情况其实都很好解决：地址层级填错（看第 3 节）、模型名填成真实模型名、密钥没复制完整。先按这三条自查一遍，多数问题就没了。

← 返回帮助中心 · 常见问题 · Cherry Studio