ERROR CODES / ENGLISH
model_not_found: the model ID does not exist
Fixes for 404 model errors: wrong ID casing and separators, renamed models, and relay name mappings, plus how to fetch the real model list.
Reviewed 2026-11-13 · ERROR CODES / 404 · Chinese detail: 完整中文页
What it means
The model ID is written wrong, or the site does not offer the model at all. The most common mistake is the separator: gpt-4.1 and gpt-4-1 are two different strings.
// OpenAI
{'error': {'message': 'The model `gpt-4.1` does not exist or you do not have access to it.', 'type': 'invalid_request_error', 'code': 'model_not_found'}}
// Relay
{"error":{"message":"无可用渠道","type":"new_api_error"}}
{"error":{"message":"模型 gpt-6 不存在","type":"new_api_error"}}The relay messages mean "no available channel" and "model gpt-6 does not exist".
Common causes
| Share | Cause |
|---|---|
| 45% | Model ID misspelled (casing, . vs -) |
| 30% | The site really does not have this model |
| 15% | The model was renamed (the vendor updated the ID) |
| 10% | Using the Anthropic protocol with an OpenAI model name |
How to confirm
Fetch the list and copy from it:
curl https://api.example.com/v1/models \
-H "Authorization: Bearer $KEY" | jq -r '.data[].id'Do not write model names from memory.
Common ID confusions:
| What you may write | What it may actually be |
|---|---|
gpt-4.1 | gpt-4.1 (only the versioned one) |
claude-3.5-sonnet | claude-sonnet-5-5 / claude-3-5-sonnet-20241022 |
gemini-pro | gemini-3.1-pro-preview |
deepseek | deepseek-chat / deepseek-reasoner |
Fix
Copy the exact ID from /v1/models, including case and separators. If it is missing from the list, choose a model the site does provide. If you recently changed protocol, confirm that the model name matches the protocol you are calling.
If it still fails
| Symptom | Responsible party |
|---|---|
The ID is not in /v1/models | You wrote it wrong, or the site does not have it |
| The list contains it, but calls return 404 | The site's routing |
| Worked yesterday, not today | The vendor changed the ID |
General guidance, not a statement about any specific provider. For measured data, see the relay directory and method.