IDE 代码解释
复现：打开测试项目，在 Qoder 聊天中让所选模型解释一个函数。
通过：回答引用该函数，控制台记录显示目标模型。
正在打开页面…
正在加载内容，请稍候。
- 应用 / 开发工具
选择对应协议，填写 Key 与 Base URL
- apizt 网关
核对模型 ID、令牌分组和可用额度
- 模型返回结果
检查响应正文与后台用量记录
先给结论
适用范围与接入结论
Qoder 桌面版在 Settings → Models → Add 中选择自定义 OpenAI 兼容模型，Base URL 填 https://api.apizt.com/v1。Validate and Add Model 通过后，还要在实际会话选中新模型并得到回答。
适合用 Qoder 的 IDE 聊天、代码理解及代理功能。CLI 自定义模型有独立入口，桌面 IDE 保存成功不能替代 CLI 验证。
按真实任务判断是否可用
CLI 对比
复现：如当前 CLI 版本支持 /model → Custom，单独导入同一 Key 和地址并发出短请求。
通过：CLI 自身得到回答；不能把 IDE 校验通过记作 CLI 成功。
先选对协议和请求地址
桌面版支持 OpenAI Compatible 配置；若版本提供 Responses 选项，应与模型实际支持的端点一致。展示名称、上下文与功能标记不是模型 API ID。
按当前工具填写的配置示例 · 模型 ID 与 Key 需要换成自己的
Qoder IDE：Settings → Models → Add → Custom
协议：OpenAI Compatible（Chat Completions）
Base URL：https://api.apizt.com/v1
API Key：apizt 令牌
模型 ID：复制平台可用 ID
完成：Validate and Add Model → 在聊天中选中这是字段与路径示例，不包含有效密钥。所选模型是否支持对应协议、工具与图像能力，应按令牌授权和实际调用结果核对。
生成 Qoder 自定义模型 配置与验证清单照这个顺序接入
- 01
确认自定义入口
记录桌面客户端版本和账户可用的模型管理入口。不同版本与 CLI 的菜单不完全相同。
- 02
验证并添加
填写协议、地址、Key 与模型 ID；进入下一步填写展示名称与当前确认的能力，再执行 Validate and Add Model。
- 03
回到任务中验证
在新会话选中自定义模型进行短文本测试，再依次验证代码编辑、代理或图片等实际需要的能力。
对照工具配置与验证顺序
验证到哪一步？
Qoder 官方文档说明自定义模型入口、URL、模型 ID 和 Validate and Add Model 步骤。
- 现有依据
- 桌面流程已按官方资料核对
- 验证边界
- 本地图片是配置示意；没有 Qoder 桌面或 CLI 付费调用记录。
- 资料日期
- 核对公开配置说明；客户端调用记录以各链接标注的日期为准。
这个工具的费用怎样算
验证模型、聊天、Agent 是不同请求；是否计费以平台记录为准。完整任务成本要算重试与多轮上下文，不能只看 Validate 的结果。
出现这些现象，先查哪里
| 现象 | 可能原因 | 下一步 |
|---|---|---|
| Validate 失败 | 路径、协议、Key 或模型 ID 有一项不匹配。 | 先保留验证响应的 HTTP 状态与错误正文，再只修改对应字段。 |
| 已添加但仍使用内置模型 | 新模型没有被当前会话选择。 | 查看会话顶部模型名及后台日志中的 model ID。 |
| IDE 可用、CLI 失败 | CLI 自定义模型配置与 IDE 配置分开。 | 在当前 CLI 版本的 /model 菜单单独核对自定义 URL 和 Key。 |
选出你的现象，查看下一步
只需选择错误类型，无需粘贴密钥或完整日志。本页不会发送 API 请求，也不会自动判定连接成功。
先取得错误详情，暂时不能确定原因
- 展开错误详情，记录时间、HTTP 状态、错误码和最终请求路径。不要只截最外层提示。
- 核对服务商协议、模型 ID、API 地址；然后按对应教程进行同条件终端检查。
分别记录 Validate 结果和新会话回答；使用 CLI 时再单独验证 CLI 的提供商，不能由 IDE 成功推断 CLI 已配置。
查看 Qoder 完整配置教程记录仅在浏览器中生成；下载后可补充脱敏结果，便于对照复测或提交客服。
- 响应包含有效结果
- 文本请求有可读取的输出；异步任务需要继续查询到完成状态，不能只把提交成功当作生成成功。
- 日志与请求对得上
- 核对调用时间、模型、令牌分组和用量。界面与账单显示不同货币时，先确认计价口径。
- 原工具中也能重复完成
- 最小示例成功但工具失败，优先检查工具的协议、模型映射和配置生效位置。反馈问题时隐藏完整 Key、Cookie 和个人数据。
把选好的模型，接入你的应用
从 Claude、GPT、Gemini 等模型中选择所需能力。获取 API Key，按工具配置接口地址，再用一个小请求确认结果和费用。
创建 API Key
在控制台创建令牌，选择需要使用的模型权限。
填写接入配置
按工具要求填写 API Key、接口地址与模型 ID。
发起第一次调用
确认收到有效结果，再到控制台查看用量与费用。
常见问题
Qoder 自定义模型 Validate 失败怎么处理？
确认当前版本与账号界面有自定义模型入口，核对 Base URL、Key、准确 ID 和所选协议。先用文本能力验证，未确认的图片与工具能力不要同时启用，保留具体 HTTP 错误。
Qoder IDE 配置成功后 CLI 也会生效吗？
不能据此判断。CLI 的 /model → Custom 是独立入口，应核对其 Provider 和实际请求；不要把 IDE 文件直接覆盖到 CLI，再分别记录新会话结果。
Qoder 应该填写哪个 API 地址？
桌面 IDE 的自定义 OpenAI 兼容模型 Base URL 填 https://api.apizt.com/v1；协议选择与实际 Chat Completions 或 Responses 支持一致。
终端请求成功，为什么客户端仍然失败？
先确认所装版本及账户界面提供自定义模型入口；没有入口时按该版本官方说明处理。 验证失败要保留具体 HTTP 状态；工具或图片能力未确认时，不同时开启多个能力测试。 终端结果只有在同一 Key、模型、端点和实际运行网络下才具有可比性。
本页是否代表已经实测全部功能？
不是。本页为配置核对与排错指南，依据官方文档及现有教程整理。客户端版本和真实调用结果需要按步骤记录；网页检查通过不能替代客户端实测。