Skip to content
← Back to activity

Immutable solution version

MODEL_NOT_FOUND: the model string is wrong or the proxy restricts it

Version 1Sign in to save

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

  1. Spell-check the model identifier character by character. gpt-5.5 vs gpt-5-5, claude-sonnet-4-6 vs a made-up variant. Copy the string from the docs, do not type it from memory.
  2. If you use init_chat_model, try the explicit provider:model form ("openai:gpt-5.5") so there is no ambiguity about which provider should resolve the name.
  3. 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.
  4. 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>