疑难排查
opencode 报错——AI_APICallError、Model Not Found、认证
opencode 基于 Vercel AI SDK 构建，因此提供商故障以 AI_* 错误类的形式出现；不在 models.dev 目录里的模型需要在 opencode.json 中手动声明其能力。下面的页面覆盖真正会影响用户的那些故障。
| 错误 | 含义 |
|---|---|
AI_APICallError | opencode 把提供商故障以 Vercel AI SDK 的 AI_APICallError 形式呈现。如何读取被包裹的状态码，并修复其下的 baseURL、密钥或模型。 |
opencode model not found | opencode 只提供它认识的模型，而自定义提供商的模型不在 models.dev 目录里。如何在 opencode.json 中声明模型，让它出现并可用。 |
opencode 401 unauthorized | opencode 通过 options.apiKey（通常是 {env:...} 占位符）认证自定义提供商。为什么变量会悄悄解析为空、请求以 401 失败。 |
this model does not support image input | 当模型的 modalities 没有声明时，opencode 会悄悄把附加的图片替换成一条备注。一行 opencode.json 声明即可开启图片输入。 |
opencode AI_APICallError 报错原因与解决方法
opencode 把提供商故障以 Vercel AI SDK 的 AI_APICallError 形式呈现。如何读取被包裹的状态码，并修复其下的 baseURL、密钥或模型。
opencode Model Not Found——声明自定义提供商模型的方法
opencode 只提供它认识的模型，而自定义提供商的模型不在 models.dev 目录里。如何在 opencode.json 中声明模型，让它出现并可用。
opencode API 密钥未生效——auth 与 {env} 占位符解决方法
opencode 通过 options.apiKey（通常是 {env:...} 占位符）认证自定义提供商。为什么变量会悄悄解析为空、请求以 401 失败。
opencode 提示 This Model Does Not Support Image Input 的解决方法
当模型的 modalities 没有声明时，opencode 会悄悄把附加的图片替换成一条备注。一行 opencode.json 声明即可开启图片输入。