OpenCode error
OpenCode: AI_APICallError
AI_APICallErrorStatus: WorkaroundLast verified 2 documented fixes1 source
What it means
A request to the model provider's API failed. The official docs say this can happen when cached provider packages are out of date. OpenCode installs provider packages (OpenAI, Anthropic, Google, etc.) as it needs them and caches them locally.
Causes
- Outdated cached provider packages that no longer match current model parameters or API changes (official docs).
How to fix it
- Fix 1.
Clear the provider package cache. On Windows, press WIN+R and delete %USERPROFILE%\.cache\opencode.
Snippetrm -rf ~/.cache/opencode - Fix 2.
Restart opencode so it reinstalls the latest provider packages.
More OpenCode errors
All 17 OpenCode errorsProviderModelNotFoundErrorStatus: By designProviderInitErrorStatus: WorkaroundThis credential is only authorized for use with Claude Code and cannot be used for other API requests.Status: By designAI_APICallError: messages.13: `tool_use` ids were found without `tool_result` blocks immediately after: toolu_01CfJCsh21fK1pAXsXWYJYBA, toolu_01NoqnwsaxoK3AYM2FyrxmjN. Each `tool_use` block must have a corresponding `tool_result` block in the next message.Status: Fixed in releasemessages.3.content.0.type: Expected `thinking` or `redacted_thinking`, but found `tool_use`. When `thinking` is enabled, a final `assistant` message must start with a thinking block (preceeding the lastmost set of `tool_use` and `tool_result` blocks). We recommend you include thinking blocks from previous turns. To avoid this requirement, disable `thinking`.Status: WorkaroundError: Unexpected error, check log file at [user-home]/.local/share/opencode/log/2025-08-26T215857.log for more detailsStatus: WorkaroundAI_RetryError: Failed after 4 attempts. Last error: Too Many RequestsStatus: Workaroundundefined: The provided model identifier is invalid.Status: Fixed in release
Related reading
- OpenCode Hacked: What the Console Breach Means for Your API KeysOpenCode disclosed a breach of its Console that may have exposed provider keys. Who is affected, what to rotate today, and why hosted key gateways are the real risk.
- OpenCode 2: How to Upgrade From v1 Without Breaking Your SetupOpenCode 2 upgrade from v1: what the migration guide says breaks (plugins, server API, TUI config), what carries over, and a safe checklist before you switch.
- Run Your Coding Agent as an API: OpenCode Server on RailwayOpenCode server on Railway: run opencode serve in a container as a password-protected HTTP API with a persistent volume, reachable from any machine or webhook.
- Give Every Agent PR a Live Preview: Railway Environments for AI Pull RequestsRailway preview environments for agent pull requests: an isolated copy of your whole stack for every PR, so you verify agent changes by running them.
- GPT-6 Astra Release Guide: Benchmarks, $10/$50 Pricing, and How to Run It in Codex and OpenCodeGPT-6 Astra release guide: OpenAI's max-capability model, its $10/$50 pricing and 1.05M context, what the benchmarks do and do not say, and commands to try it.
- Put an AI Reviewer on Every Pull Request: A Webhook Build with OpenCode and RailwayBuild an AI pull request reviewer on Railway: a webhook service runs OpenCode headless on every PR diff and posts findings as a review, never touching the code.
FAQ
What does "AI_APICallError" mean in OpenCode?
A request to the model provider's API failed. The official docs say this can happen when cached provider packages are out of date. OpenCode installs provider packages (OpenAI, Anthropic, Google, etc.) as it needs them and caches them locally.
How do I fix "AI_APICallError"?
There are 2 documented fixes. Start with the first: Clear the provider package cache. On Windows, press WIN+R and delete %USERPROFILE%\.cache\opencode.
Is this OpenCode error fixed?
Status: Workaround. No release removes the cause. The documented fixes work around it.
Sources
Last verified against 1 source: official docs, maintainer replies and release notes.
- opencode.aihttps://opencode.ai/docs/troubleshooting/
Newsletter
Fixes for the tools you use, weekly
One email per week. New coding agent releases, what broke, and how developers are working around it.