工具接入
工具接入
在 Cursor、Claude Code、Codex、Cherry Studio 等常用工具中使用 AIPUT。
模型调用暂未开放
本页内容用于接入准备。调用开放后，请使用你自己的可用 Key，并把示例中的模型占位值换成模型广场中实际开放的型号。
在任何工具里使用 AIPUT，都只需要三样东西：API 地址、你的 API Key 和模型 ID。各工具的区别只在两点：用哪种接口格式，地址要不要带 /v1。
各工具一览
| 工具 | 接口格式 | 地址写法 |
|---|---|---|
| Cursor | 普通对话 | 带 /v1 |
| Claude Code | Anthropic | 不带 /v1 |
| Codex | Responses | 带 /v1 |
| Cline | 普通对话 | 带 /v1 |
| OpenCode | 普通对话 | 带 /v1 |
| Cherry Studio | 普通对话 | 不带 /v1，由工具自动补全 |
| Open WebUI | 普通对话 | 带 /v1 |
| WorkBuddy | 普通对话 | 带 /v1 |
| DeepSeek Harness | 普通对话 | 带 /v1 |
| OpenClaw | 普通对话 | 带 /v1 |
| Hermes Agent | 普通对话 | 带 /v1 |
| CC Switch | 帮你配置 Claude Code、Codex 等工具 | 从控制台一键导入时自动填写 |
两种地址写法分别是：
- 带
/v1：https://api.aiput.top/v1 - 不带
/v1：https://api.aiput.top
地址多写 /v1 会返回 404；少写 /v1 时会返回一段网页，工具通常提示无法解析返回内容。
选择模型
三种接口格式分别对应模型广场筛选条件「端点类型」里的三个选项（窄屏时点“筛选”按钮）：
| 接口格式 | 「端点类型」选项 | 使用它的工具 |
|---|---|---|
| 普通对话（OpenAI Chat Completions） | Chat | Cursor、Cline、Cherry Studio 等大多数工具 |
| Anthropic Messages | Anthropic | Claude Code |
| OpenAI Responses | Response | Codex |
先按工具筛选，再复制模型 ID。模型 ID 要和模型广场显示的完全一致，包括大小写。模型不支持工具使用的格式时，调用可能失败。
开始之前
上面第 3 步以普通对话格式为例；Claude Code 选 Anthropic，Codex 选 Response。
保管好 Key
- 工具会把 Key 保存在你电脑上的配置文件里。这些文件不要提交到代码仓库，也不要截图分享。
- 团队共用一个工具实例（例如 Open WebUI）时，所有人的调用都记在同一把 Key 上，都从这把 Key 所属账户的余额扣费。
- Key 泄露后，按保管 API Key的步骤停用旧 Key。
各工具的名称和商标归其所有者所有，这里只表示兼容。各工具界面可能随版本变化，以工具官方说明为准。