通用兼容指南

任何支持「自定義 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
newcclm-fast
newcclm-coding
newcclm-free

不要選 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