主题
接入地址与参数
接入主要需要三项：接口地址、API Key、模型 ID。地址填写方式取决于客户端选择的协议。
选择并复制地址
https://one-model.com/v1适用于 Codex、Roo Code、Cherry Studio、ChatBox 等客户端的 Base URL。
参数速查
| 配置项 | 填写内容 |
|---|---|
| API Key | 在 API Keys 页面创建的密钥 |
| 模型 ID | 从 模型页面 复制，例如 glm-5.2 |
| OpenAI Base URL | https://one-model.com/v1 |
| Anthropic Base URL | https://one-model.com |
| Chat Completions 完整 URL | https://one-model.com/v1/chat/completions |
| Responses 完整 URL | https://one-model.com/v1/responses |
| Messages 完整 URL | https://one-model.com/v1/messages |
Base URL 和完整 URL 的区别
SDK 或客户端通常会在 Base URL 后自动拼接接口路径。只有明确要求「完整 URL」的输入框才填写完整请求地址。
按客户端选地址
| 客户端 | 填写地址 | 说明 |
|---|---|---|
| Claude Code | https://one-model.com | Anthropic 协议，不加 /v1 |
| Codex CLI | https://one-model.com/v1 | 使用 Responses 协议 |
| Roo Code / Kilo Code | https://one-model.com/v1 | 选择 OpenAI Compatible |
| Cherry Studio | https://one-model.com/v1 | 检查请求地址预览，避免重复 /v1 |
| ChatBox | https://one-model.com/v1 | API 路径填 /chat/completions |
| WorkBuddy | https://one-model.com/v1/chat/completions | 填完整请求地址 |
| Trae | https://one-model.com/v1/chat/completions | OpenAI 格式，打开「完整 URL」 |
备用线路
主线路连接超时或网络不通时，将域名换成 vip-1.one-model.com，保留原来的路径：
| 协议 | 备用地址 |
|---|---|
| OpenAI Base URL | https://vip-1.one-model.com/v1 |
| Anthropic Base URL | https://vip-1.one-model.com |
| Chat Completions 完整 URL | https://vip-1.one-model.com/v1/chat/completions |
选择模型
模型 ID 请从官网复制，不要把展示名称或厂商名当作 ID。原教程中的 glm-5.2、deepseek-v4-pro、kimi-k2.8 都是 ID 示例；实际可用模型取决于平台当前配置及你的 Key 所在分组。
客户端支持某种协议，不代表每个模型都支持图片、工具调用、思考开关或全部推理档位。按模型能力开启对应选项。