先看错误信息
provider package errorOpenCode provider package error 先看包名、加载日志和当前配置。确认 npm Provider 与实际 Chat Completions 或 Responses 协议一致；请求尚未发出时更换 API Key 没有帮助，依赖调整后重新验证最小请求。
正在打开页面…
正在加载内容，请稍候。
OpenCode provider package error：依赖加载与 API 协议
OpenCode provider package error 先看包名、加载日志和当前配置。确认 npm Provider 与实际 Chat Completions 或 Responses 协议一致；请求尚未发出时更换 API Key 没有帮助，依赖调整后重新验证最小请求。
- 保留现场
记录状态码、错误正文和请求时间
- 缩小范围
按下方检查项逐个排除，不同时修改多项
- 最小复测
用同一请求验证，再回到原工具测试
选出你的现象，查看下一步
只需选择错误类型，无需粘贴密钥或完整日志。本页不会发送 API 请求，也不会自动判定连接成功。
先取得错误详情，暂时不能确定原因
- 展开错误详情，记录时间、HTTP 状态、错误码和最终请求路径。不要只截最外层提示。
- 核对服务商协议、模型 ID、API 地址；然后按对应教程进行同条件终端检查。
启动新会话先测试短文本，核对实际 endpoint 和 provider；随后在测试目录授权读取 README，分别记录两项结果。
查看 OpenCode 完整配置教程记录仅在浏览器中生成；下载后可补充脱敏结果，便于对照复测或提交客服。
常见表现
- 启动时 provider 加载失败
- 未发起模型请求
- 升级后突然失败
这个报错是什么意思
provider package error 需要结合错误正文定位。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
provider 使用 openai 或 openai-compatible
02
Base URL 使用 /v1
03
更新 opencode 到当前版本
04
清理旧配置后重新登录
详细修复步骤
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，分别记录两项结果。常见原因
- provider 名称写错
- 配置文件仍指向旧包
- 本地依赖版本冲突
- OpenAI 兼容接口被配置成 Anthropic provider
怎么确认已经修好
- 启动新会话先测试短文本，核对实际 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 openai-compatible 和 openai Provider 怎样选？
按所用 AI SDK 包及调用端点核对。现有配置中 @ai-sdk/openai-compatible 用于 Chat Completions；采用 Responses 的路径需要服务端支持，不能仅改模型 ID 来切换协议。
OpenCode provider package error 怎么判断是否要更新包？
记录 opencode 版本、具体 npm 包和加载错误，对照当前配置文档。只有错误指向包加载或参数不兼容时再更新相应依赖或缓存，保留认证与会话。
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、模型、端点和实际运行网络下才具有可比性。
本页是否代表已经实测全部功能？
不是。本页为配置核对与排错指南，依据官方文档及现有教程整理。客户端版本和真实调用结果需要按步骤记录；网页检查通过不能替代客户端实测。