先看错误信息
model not foundOpenCode model not found 检查 provider/model 选择、配置中的 models 键以及目标服务授权的准确 ID。展示名称不能替代真实模型键，其他平台前缀也不能直接沿用；确认协议后在新会话发最小请求。
正在打开页面…
正在加载内容，请稍候。
- 保留现场
记录状态码、错误正文和请求时间
- 缩小范围
按下方检查项逐个排除，不同时修改多项
- 最小复测
用同一请求验证，再回到原工具测试
选出你的现象，查看下一步
只需选择错误类型，无需粘贴密钥或完整日志。本页不会发送 API 请求，也不会自动判定连接成功。
先取得错误详情，暂时不能确定原因
- 展开错误详情，记录时间、HTTP 状态、错误码和最终请求路径。不要只截最外层提示。
- 核对服务商协议、模型 ID、API 地址；然后按对应教程进行同条件终端检查。
启动新会话先测试短文本，核对实际 endpoint 和 provider；随后在测试目录授权读取 README，分别记录两项结果。
查看 OpenCode 完整配置教程记录仅在浏览器中生成；下载后可补充脱敏结果，便于对照复测或提交客服。
常见表现
- 认证成功但模型调用失败
- 只在某个项目目录失败
- 错误包含 model not found
这个报错是什么意思
model not found 需要结合错误正文定位。Base URL 为 https://api.apizt.com/v1；@ai-sdk/openai-compatible 使用 Chat Completions，@ai-sdk/openai 的 Responses 用法需要服务端支持 Responses；不能仅改模型 ID 就切换协议。
先判断是哪一类问题
对照请求链路定位失败阶段
判断 01
Base URL 为 https://api.apizt.com/v1；@ai-sdk/openai-compatible 使用 Chat Completions，@ai-sdk/openai 的 Responses 用法需要服务端支持 Responses；不能仅改模型 ID 就切换协议。
判断 02
provider package error 先查依赖和配置加载；请求尚未发出时更换 API Key 没有帮助。
判断 03
AI_APICallError 是外层错误，需展开 HTTP 状态和正文；auth.json 存有凭据不等于当前 provider 正在使用它。
按顺序修复
01
核对平台实际授权且支持当前协议的模型 ID
02
确认 baseURL 是 /v1
03
删除旧模型别名
04
重新启动 opencode
详细修复步骤
Step 01
找到实际生效的配置
先运行 opencode --version，按该版本 schema 检查配置。使用 provider/npm/options 的配置，不混入其他版本字段。
Step 02
核对协议与凭据
核对 provider ID、SDK 包、options.baseURL 和 models 键；当前模型引用使用 provider ID/模型 ID。
Step 03
回到新会话验证
检查全局、项目配置及 OPENCODE_CONFIG_CONTENT 的覆盖关系，保留备份，仅修改实际生效的条目。
正确配置
Base URL 为 https://api.apizt.com/v1；@ai-sdk/openai-compatible 使用 Chat Completions，@ai-sdk/openai 的 Responses 用法需要服务端支持 Responses；不能仅改模型 ID 就切换协议。
模型 ID：从当前平台授权列表复制，不能用显示名称代替。
API Key：在客户端安全输入；本页无需提供。
成功判据：启动新会话先测试短文本，核对实际 endpoint 和 provider；随后在测试目录授权读取 README，分别记录两项结果。常见原因
- 项目 opencode.json 写了旧模型
- 模型名拼写错误
- provider 和模型不匹配
- baseURL 指向错误服务
怎么确认已经修好
- 启动新会话先测试短文本，核对实际 endpoint 和 provider；随后在测试目录授权读取 README，分别记录两项结果。
- 记录客户端版本、请求时间、模型 ID、HTTP 状态和请求 ID。文字成功后再测试所需工具、图片或长上下文功能。
- 页面提供配置核对与复测步骤，没有连接你的客户端；本页未提供该客户端的真实付费调用验证结果。
避免下次再报错
- 团队内统一一份 Base URL 和模型名，不要让每个人从不同教程复制配置。
- 给生产任务和个人调试任务分开 API Key，方便定位是谁触发了限流或余额消耗。
- 工具升级后先保留旧配置备份，再用一个短 prompt 验证连通性。
- 把正确配置写进团队文档，尤其标明 Claude Code 和 OpenAI 兼容工具的 Base URL 差异。
仍未解决？这样提供排查信息
记录报错时间、工具版本、模型 ID 和 HTTP 状态码，附上脱敏后的错误正文。
说明问题是否稳定复现，以及同一配置的最小请求是否成功。
可以提供请求 ID 或控制台日志编号，不要发送完整 API Key、密码或个人业务数据。
先区分配置、权限、额度与上游服务问题；不要通过重复充值或高频重试来排查。
排查完成后，再开始接入
先按上文检查地址、鉴权与协议，并完成复测。确认要使用 apizt 后，再创建 API Key、选择模型并配置工具；充值不能修复配置错误。
创建 API Key
在控制台创建令牌，选择需要使用的模型权限。
填写接入配置
按工具要求填写 API Key、接口地址与模型 ID。
发起第一次调用
确认收到有效结果，再到控制台查看用量与费用。
FAQ
OpenCode models 里的 name 就是 API 模型 ID 吗？
显示名与配置键可能不同。核对 Provider 模型映射和最终请求的 model 字段，复制目标令牌分组支持的准确 ID，不仅修改人类可读名称。
OpenCode 模型已添加为什么还报 model not found？
确认当前会话选中的 provider/model 与保存配置一致，并检查用户、项目配置覆盖及服务授权。模型出现在选择器中只证明配置可见，仍需实际请求验证。
OpenCode 应该填写哪个 API 地址？
Base URL 为 https://api.apizt.com/v1；@ai-sdk/openai-compatible 使用 Chat Completions，@ai-sdk/openai 的 Responses 用法需要服务端支持 Responses；不能仅改模型 ID 就切换协议。
终端请求成功，为什么客户端仍然失败？
provider package error 先查依赖和配置加载；请求尚未发出时更换 API Key 没有帮助。 AI_APICallError 是外层错误，需展开 HTTP 状态和正文；auth.json 存有凭据不等于当前 provider 正在使用它。 终端结果只有在同一 Key、模型、端点和实际运行网络下才具有可比性。
本页是否代表已经实测全部功能？
不是。本页为配置核对与排错指南，依据官方文档及现有教程整理。客户端版本和真实调用结果需要按步骤记录；网页检查通过不能替代客户端实测。
2026 年 11 月 5 日补测
OpenCode 找不到模型：先列出可见 Provider 与模型
在本机实际运行 models 命令，再对照样例配置中未注册的模型。
- OpenCode 原生模型列表核验。
- 准备独立样例。安装文章所用客户端，或用 Python 3.11+ 运行标注为本地 HTTP/TOML 的样例。
- 本例操作：在本机实际运行 models 命令，再对照样例配置中未注册的模型。
- 解压练习包，执行 python3 lab.py --output ./result u11。完整命令、样例输入和输出保存在回执。
- 打开 result/u11.json，对照实际退出码、请求路径或产物字段。
- 逐项确认下方通过条件。本例的测试范围以运行回执为准。
- 通过：原生模型列表包含唯一注册模型
先下载样例，再完成自己的首次调用
示例不含密钥。API 按实际用量计费；下载和点击不代表调用成功。