docs: troubleshooting ProviderModelNotFoundError (#3016)

2025-10-07 11:50:37 -05:00
parent 6f4e3f519e
commit 21d4459d5e
1 changed files with 12 additions and 0 deletions
@@ -86,6 +86,18 @@ Here are some common issues and how to resolve them.
 2. Verify the model name in your config is correct
 3. Some models may require specific access or subscriptions

+If you encounter `ProviderModelNotFoundError` you are most likely incorrectly
+referencing a model somewhere.
+Models should be referenced like so: `<providerId>/<modelId>`
+
+
+Examples:
+- `openai/gpt-4.1`
+- `openrouter/google/gemini-2.5-flash`
+- `opencode/kimi-k2`
+
+To figure out what models you have access to, run `opencode models`
+
 ---

 ### ProviderInitError