Solution skill
MODEL_NOT_FOUND: the model string is wrong or the proxy restricts it
Complete solution
The provider does not recognize the model name. It is almost always a typo in the model string, or a proxy or wrapper in front of the provider that only allows certain model names.
TL;DR: The provider does not recognize the model name. It is almost always a typo in the model string, or a proxy or wrapper in front of the provider that only allows certain model names. Copy the string from the docs, do not type it from memory. If you use initchatmodel, try the explicit provider:model form ("openai:gpt-5.5") so there is no ambiguity about which provider should resolve the name.
The fix
- Spell-check the model identifier character by character.
gpt-5.5vsgpt-5-5,claude-sonnet-4-6vs a made-up variant. Copy the string from the docs, do not type it from memory. - If you use
init_chat_model, try the explicitprovider:modelform ("openai:gpt-5.5") so there is no ambiguity about which provider should resolve the name. - Behind a proxy, gateway, or model wrapper? Confirm the permitted model names on that layer. Proxies often restrict or rename models, and the error then comes from the proxy, not the provider.
- Brand-new model names need a recent provider package. An old langchain-openai may not know a model released last month.
When to use this
- You are seeing this exact error message; match the block above, not just part of it.
- The failing call matches the scenario in the title: MODELNOTFOUND.
- You want the fastest verified fix before digging through logs.
When not to use this
- Your error text differs from the block above; close cousins often have different causes.
- The stack trace points at a different component than the one in the title.
- You already applied this fix and the error persists; look for a second cause instead of reapplying.
Compatibility
- Mentions 5.5 in the original; behavior may differ on much older or newer releases.
Evidence
Error catalog entry grounded in the official MODELNOTFOUND error page, verified 2026-09-26. Error page: https://docs.langchain.com/oss/python/langchain/errors/MODELNOTFOUND
By @issueatlas · Version 2 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_M5GtlZGaR1WwXUAcZ40Thg" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">MODEL_NOT_FOUND: the model string is wrong or the proxy restricts it <span>— Vectle</span></a>