त्रुटियाँ और विश्वसनीयता

API में Model not found: कारण कैसे खोजें और ठीक करें

model not found: endpoint, protocol, API Key, Model ID, overrides, status और request ID की चरणबद्ध जाँच।

BT

BetterToken

संपादकीय टीम
6 मिनट पढ़ने में

model not found का मतलब है कि server मौजूदा endpoint और API Key के संदर्भ में दिए गए Model ID को resolve नहीं कर सका। इसका कारण typo, पुराना alias, गलत protocol, access का अभाव या configuration override हो सकता है। पहले status और request ID लिखें, फिर Base URL से key और model तक पूरी chain जाँचें। नामों को बिना प्रमाण आजमाना मूल कारण छिपाता है।

Configuration बदलने से पहले क्या सहेजें

पहले एक छोटी diagnostic card रखें:

time: 2026-08-03T12:00:00Z
client: your-client-and-version
protocol: openai-compatible | anthropic-compatible
base_url: https://example.com/v1
model: MODEL_ID_FROM_CONFIG
http_status: 404
provider_code: model_not_found
request_id: req_...

इसमें API Key, पूरा prompt या response शामिल नहीं होता। यदि गलती IDE या agent tool में है, config file का नाम और environment variables की मौजूदगी भी लिखें। इससे पता चलता है कि server तक कौन-सा वास्तविक मान पहुँचा।

वर्तमान catalog से diagnosis दोहराने के लिए BetterToken account और API Key बनाएँ, endpoint और Model ID को API reference से मिलाएँ, फिर एक minimal request करें। Endpoint type, Base URL, Key group और current Model ID का मेल होना चाहिए; नाम documentation या models and pricing page से लें और परिणाम Dashboard में जाँचें।

चरण 1. Base URL और path जाँचें

Settings की string नहीं, request का अंतिम URL देखें। SDK खुद /v1, /models, /chat/completions, /responses या /messages जोड़ सकता है।

  • Base URL में resource path पहले से है और SDK उसे फिर जोड़ देता है।
  • /v1 गायब है या दो बार जुड़ा है।
  • OpenAI client Anthropic-compatible address पर request भेज रहा है।
  • कोई environment variable config के Base URL को override कर रहा है।
  • Application कोई दूसरा profile या workspace उपयोग कर रही है।

BetterToken के OpenAI-compatible tools का Base URL /v1 के साथ होता है, जबकि Anthropic SDK और Claude Code के address में /v1 नहीं जोड़ा जाता; पूरा Messages path अलग से बनता है। बदलाव से पहले उस tool की current guide मिलाएँ।

चरण 2. वास्तविक API Key पहचानें

एक interface में कई credentials हो सकते हैं और model error चुनी हुई key के access की कमी को छिपा सकती है। जाँचें कि client किस credential या environment variable को पढ़ता है, अतिरिक्त spaces या line breaks नहीं हैं, protocol और model group सही हैं, project config global setting को override तो नहीं कर रहा, और key expire या revoke तो नहीं हुई।

Key को echo, debug log या screenshot में कभी न दिखाएँ। तुलना के लिए सुरक्षित profile name या UI में दिखा fingerprint का अंतिम हिस्सा पर्याप्त है।

चरण 3. वर्तमान Model ID प्राप्त करें

OpenAI-compatible endpoint पर अक्सर models list मिलती है:

curl "$OPENAI_BASE_URL/models" \
  -H "Authorization: Bearer $OPENAI_API_KEY"

यह command environment variables उपयोग करती है और text में वास्तविक key नहीं रखती। इसे तभी चलाएँ जब endpoint documentation /models की पुष्टि करे। दूसरे protocol या client के लिए provider का official catalog लें। id field को case, spaces और suffixes बदले बिना copy करें; marketing name और API Model ID अलग हो सकते हैं।

List खुलती है लेकिन आवश्यक model नहीं है तो चुनी हुई key और catalog जाँचें। यदि /models स्वयं error दे, पहले endpoint या authorization ठीक करें।

चरण 4. alias और पुरानी setting खोजें

Model ID project config, global config, environment variable, UI profile, command-line flag, saved session, या routing/model-mapping gateway से आ सकता है। Repository search पुराना मान ढूँढती है:

rg -n --hidden --glob '!node_modules' --glob '!.git' \
  'OLD_MODEL_ID|model[[:space:]]*=' .

यह command secret configs भी खोज सकती है, इसलिए पूरा output प्रकाशित न करें। केवल उसी source को बदलें जिसे client सच में पढ़ता है। Config precedence client पर निर्भर है; उसके current docs में project, global, environment और CLI order जाँचें। Provider settings cache हों तो client restart करें या नई session खोलें।

चरण 5. Model error को access error से अलग करें

Compatible APIs में HTTP codes समान होना जरूरी नहीं, इसलिए error body भी देखें।

  • 401: credential और authorization format जाँचें।
  • 403: model मौजूद हो सकती है, पर current key को access नहीं है।
  • 404: path, endpoint या Model ID गलत हो सकता है।
  • 400: server ने model field या अन्य request parameter reject किया हो सकता है।
  • 429 / 5xx: सामान्यतः अलग category है; अतिरिक्त signal के बिना Model ID न बदलें।

UI का model not found client का paraphrase हो सकता है। वास्तविक HTTP status, provider code और request ID खोजें।

न्यूनतम दोबारा परीक्षण

सुधार के बाद streaming और tools के बिना एक छोटा request भेजें। OpenAI-compatible Chat Completions का रूप ऐसा हो सकता है:

curl "$OPENAI_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID_FROM_CURRENT_CATALOG",
    "messages": [{"role": "user", "content": "Reply with OK"}],
    "max_tokens": 8
  }'

Fields और endpoint provider documentation के अनुरूप होने चाहिए। इस example को adaptation के बिना Anthropic Messages में न ले जाएँ। सफल test में HTTP status सफलता दर्शाता है, response में अपेक्षित Model ID या documented variant है, request Dashboard में दिखती है, और time/status/usage उस test से मिलते हैं।

यदि छोटा request काम करता है पर IDE फिर भी error दिखाती है, तो server-side configuration ठीक है; client के override या cache में खोजें।

छोटा checklist

  • status, provider code और request ID सहेजे गए हैं।
  • final URL में duplicate /v1 या resource path नहीं है।
  • client अपेक्षित credential इस्तेमाल कर रहा है।
  • Model ID current catalog से लिया गया है।
  • project, global और environment overrides जाँचे गए हैं।
  • tools और stream के बिना minimal request किया गया है।
  • request को Dashboard से मिलाया गया है।

Model ID बदलने से पहले API reference और current catalog मिलाएँ। यह मिलते-जुलते नाम आजमाने से तेज और सुरक्षित है।

FAQ

Website पर model दिखती है, पर API model not found लौटाता है — क्यों?

Protocol या Key group अलग हो सकते हैं; session पुरानी हो सकती है या marketing name API ID से अलग हो सकता है। उसी credential के लिए models list जाँचें।

क्या retry करने से मदद मिलेगी?

Typo या गलत endpoint में नहीं। पहले configuration ठीक करें। Retry केवल temporary error के लिए उचित है, जब status और provider code उसका समर्थन करें।

क्या models list को हमेशा के लिए config में रख सकते हैं?

चुने हुए ID को managed setting की तरह रखें और उसे समय-समय पर current catalog से मिलाएँ। Availability और aliases बदलते रहते हैं।

curl काम करता है लेकिन application नहीं — क्यों?

Application दूसरा Base URL, credential या Model ID पढ़ सकती है। Final request की तुलना करें और project-level override, environment variables तथा saved profile जाँचें।

Sources

अपना LLM वर्कफ़्लो बेहतर बनाना चाहते हैं?

एक API से मॉडल जोड़ें, कुंजियाँ प्रबंधित करें और AI खर्च नियंत्रित करें।