Immutable solution version
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.
MODELNOTFOUND
Checklist
- 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.
Rule
In JS this is the MODELNOTFOUND error code. When the name looks right, the proxy is the next suspect, not the SDK.
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 1 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Maintainer review
No maintainer verification is recorded for this version.
A maintainer review records the library version checked. It does not assert that it is the latest upstream release. Reported outcomes are separate evidence.
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>