客户端怎么填

大部分客户端只问你要三样东西：接口地址、API Key、模型名。

通用填法

字段	填什么
接口地址 / Base URL	https://api.syuan.org/v1
API Key	sk- 开头的密钥
模型	见 模型与分组

如果客户端只让你填域名

有的客户端（比如部分 Claude 客户端）不带 /v1，那就填 https://api.syuan.org。 判断标准还是看最终请求路径：聊天请求应该落到 /v1/chat/completions。

常见客户端的差异

客户端类型	接口地址该填	说明
OpenAI 兼容类	https://api.syuan.org/v1	Cherry Studio、NextChat、LobeChat、各类 IDE 插件都属于这一类
Anthropic 原生类	https://api.syuan.org	走 /v1/messages，模型用 claude- 开头的
Gemini 原生类	https://api.syuan.org	走 /v1beta/models/...，见 Gemini 原生接口
AstrBot	见 专门一页	供应商里的 OpenAI 兼容地址

一个容易踩的坑

有些客户端会把模型名也拼进路径，或者强制补 /v1。如果你填完一直 404，先看错误信息里的实际请求路径：

POST /v1/v1/chat/completions   ← 多了个 /v1
POST /chat/completions         ← 少了 /v1

前者说明 Base URL 里已经带了 /v1，客户端又补了一次；后者说明客户端没补，你需要自己写全。

不确定就用最笨的办法

先用 curl 确认 Key 和网络都没问题（见第一次接入），再去配客户端。这样出问题时能确定是客户端配置的事，而不是 Key 的事。

排查顺序我会写在排障指南里。