第三方调用总览
第三方工具接入 puaai 时，核心就是三件事：Base URL、API Key、模型名。不同工具只是配置入口不同。
先选客户端类型
| 客户端 | 推荐页面 | 典型 Base URL |
|---|---|---|
| Curl / 自写请求 | https://puaai.xyz | |
| OpenCode | https://puaai.xyz/v1 | |
| Kilo Code | https://puaai.xyz/v1 | |
| Zed | https://puaai.xyz/v1 | |
| Cline / Roo Code | https://puaai.xyz/v1 | |
| Open WebUI / LobeChat | https://puaai.xyz/v1 | |
| Hermes Agent | https://puaai.xyz/v1 |
接入前固定动作
- 创建 API Key，并绑定可用分组。
- 用当前 Key 查询模型列表。
- 从模型列表复制模型名。
- 在客户端里填写 Base URL、API Key、模型名。
- 发一条最小消息测试。
协议选择
| 分组或工具类型 | 推荐协议 |
|---|---|
| OpenAI 兼容工具 | OpenAI Chat 或 Responses |
| Claude / Anthropic 兼容工具 | Anthropic Messages |
| Gemini 工具 | Gemini 原生 /v1beta |
| 不确定工具能力 | 先用 OpenAI Chat 兼容配置测试 |
最小化变量
第一次接入时先关闭复杂功能，例如工具调用、图片、长上下文、代理插件和自定义 header。先跑通最小文本请求，再逐步打开高级能力。