切换主题
客户端配置
Sprelay API 同时支持 OpenAI Compatible、Responses、Claude Messages 和 Gemini Native。正确的配置取决于客户端使用的协议，以及它是否会自动补全 /v1 和具体端点。
先选择正在使用的工具
| 工具 | 推荐教程 | 常用地址 |
|---|---|---|
| Cherry Studio | Cherry Studio | https://sprelaytoken.com/v1 |
| CC Switch | CC Switch | 使用站内一键导入 |
| Claude Code | Claude Code | https://sprelaytoken.com |
| Codex CLI | Codex CLI | https://sprelaytoken.com/v1 |
| Cursor | Cursor | https://sprelaytoken.com/v1 |
| 其他 OpenAI 客户端 | 通用兼容客户端 | 通常为 https://sprelaytoken.com/v1 |
配置前的检查清单
三种常见地址填写方式
| 客户端字段含义 | 填写值 |
|---|---|
| OpenAI Base URL，客户端自动拼接端点 | https://sprelaytoken.com/v1 |
API Host，客户端自己拼接 /v1 | https://sprelaytoken.com |
| 完整 Chat Completions Endpoint | https://sprelaytoken.com/v1/chat/completions |
不要把完整端点填进只需要 Base URL 的字段，否则可能形成 /chat/completions/chat/completions。
一键导入优先
Sprelay 控制台可能为 Cherry Studio、CC Switch 等工具提供一键导入。它会根据站点地址、密钥和所选模型生成配置，通常比手动填写更可靠。导入前仍应确认目标应用和模型，避免把高权限密钥导入错误程序。
客户端连接失败
先不要反复重装客户端。复制当前 Base URL、模型名称和错误码，对照客户端连接问题逐项检查。