بلاگ پر واپس جائیں

خرابیوں کا ازالہگائیڈ

API 401 یا 404 error: غلط کلید، base URL یا ماڈل id

اسٹیٹس کوڈ پڑھیں، تین چیزوں میں سے کون سی غلط ہے (کلید، base URL، ماڈل id) معلوم کریں اور ایک curl درخواست سے حل کی تصدیق کریں۔

از CheapTokens Teamشائع شدہ 5 منٹ کا مطالعہ

اسٹیٹس 401 والا error کارڈ اور کلید، base URL اور ماڈل id چیک کرنے کا اشارہ
اس صفحہ پر
  1. ان میں فرق بتانے کا تیز طریقہ
  2. 401: کلید endpoint سے مطابقت نہیں رکھتی
  3. ہر ماڈل پر 404: پتہ غلط ہے
  4. ایک ماڈل پر 404: ماڈل id
  5. ایک curl کمانڈ سے حل ثابت کریں
  6. اگر پھر بھی کام نہ کرے

آپ کی درخواست اسٹیٹس کوڈ کے ساتھ ناکام ہوئی اور آپ کو یقین نہیں کہ پہلے کیا دیکھیں۔ مختصر جواب: 401 عام طور پر کلید کی طرف اشارہ کرتا ہے، 404 عام طور پر مطلب ہے کہ آپ غلط جگہ دستک دے رہے ہیں — یا تو پتہ (base URL اور path) یا ماڈل id۔ تین چیزیں، اسی ترتیب سے چیک کریں، اور ایک curl کمانڈ جو حل کو ثابت کرتی ہے۔

OpenAI کے error-codes صفحے (26 اکتوبر 2026 کو چیک کیا گیا) میں دو 401 پیغامات درج ہیں: "Invalid Authentication" اور "Incorrect API key provided"۔ دونوں کے لیے دیا گیا حل ایک ہی ہے: کلید چیک کریں یا نئی بنائیں۔ یہ صفحہ API کے لیے کوئی 404 دستاویز نہیں کرتا، لہٰذا 404 کے لیے نیچے دیا گیا اصول اس صفحے سے نہیں بلکہ OpenAI-compatible endpoints کے کام کرنے کے طریقے سے آتا ہے۔

ان میں فرق بتانے کا تیز طریقہ#

اسٹیٹس سرور کیا کہہ رہا ہے پہلے کیا دیکھیں
401 عام طور پر: میں یہ کلید قبول نہیں کرتا کلید، اور یہ کس پرووائیڈر کی ہے
ہر ماڈل پر 404 عام طور پر: اس پتے پر کچھ نہیں ہے base URL اور /v1
صرف ایک ماڈل پر 404 عام طور پر: پتہ ٹھیک ہے، یہ ماڈل id معلوم نہیں ماڈل id

پیغام کی عبارت سرور اور آپ کے ٹول (Cline، Aider، OpenCode اور Continue ہر ایک اپنے انداز میں errors لپیٹتے ہیں) پر منحصر ہے، لہٰذا نمبر سے شروع کریں، پھر نیچے دیے گئے curl چیک سے تصدیق کریں۔

401: کلید endpoint سے مطابقت نہیں رکھتی#

کلاسیکی کہانی: آپ نے ایک ٹول کو نئے پرووائیڈر پر منتقل کیا، base URL تبدیل کیا، اور کنفیگ میں پرانے پرووائیڈر کی کلید چھوڑ دی۔ پتہ نیا ہے، کلید پرانی ہے، اور سرور 401 جواب دیتا ہے۔ کچھ ٹوٹا نہیں؛ کلید صرف ایک مختلف گھر کی ہے۔

کیا چیک کریں:

  1. کلید کس پرووائیڈر نے جاری کی؟ یہ وہی ہونا چاہیے جس کا پتہ آپ کال کر رہے ہیں۔ ایک سروس کی کلید دوسری پر درست نہیں۔
  2. بےجا حروف۔ کلید کے ساتھ پیسٹ ہونے والی اسپیس یا لائن بریک، یا quotes جو ویلیو کے اندر آ گئے۔
  3. ٹول اسے کہاں سے پڑھتا ہے۔ ایک environment variable جو ایک ٹرمینل میں سیٹ ہے اور جس سے آپ کے ایڈیٹر نے آغاز کیا اس میں نہیں — یہ اکثر وجہ ہوتی ہے۔ اگر ٹول میں config file اور environment variable دونوں ہیں، تو معلوم کریں کہ کون جیتتا ہے۔
  4. منسوخ یا حذف شدہ کلید۔ آپ کی حذف یا منسوخ کردہ کلید کام کرنا بند کر دیتی ہے — نئی بنائیں اور کنفیگ میں رکھیں۔

اگر آپ کو یقین نہیں کہ کلیدیں کیسے کام کرتی ہیں یا انہیں کہاں رکھنا ہے، تو what an API key is and how to store it safely اسے آسان الفاظ میں بیان کرتا ہے۔

ہر ماڈل پر 404: پتہ غلط ہے#

CheapTokens کے لیے base URL https://api.cheaptokens.dev/v1 ہے۔ ٹولز اور SDKs خود endpoint path شامل کرتے ہیں، لہٰذا عام غلطیاں /v1 کے بارے میں ہوتی ہیں:

  • /v1 غائب: ٹول https://api.cheaptokens.dev/chat/completions کال کرتا ہے۔
  • دوہرا /v1: آپ نے مکمل path ایسے فیلڈ میں پیسٹ کر دیا جو پہلے ہی اسے شامل کرتا ہے، اور https://api.cheaptokens.dev/v1/v1/chat/completions ملتا ہے۔
  • غلط قسم: OpenAI-style ٹولز اور OpenAI SDK پتہ /v1 کے ساتھ لیتے ہیں۔ Anthropic SDK اور Claude Code پتہ بغیر /v1 کے لیتے ہیں: https://api.cheaptokens.dev۔

اگر آپ نے کبھی سوچا کہ base URL بالکل کیا ہے اور ٹول اس کا کون سا حصہ شامل کرتا ہے، تو this explainer اس پر روشنی ڈالتا ہے۔ Anthropic کی طرف، the Anthropic Python SDK with CheapTokens دیکھیں۔

ایک ماڈل پر 404: ماڈل id#

یہ ان لوگوں کو پکڑتا ہے جو قیمت کی جدول یا کسی دوسرے پرووائیڈر سے نام کاپی کرتے ہیں۔ قیمت کی جدول DeepSeek-V4-Flash کہہ سکتی ہے؛ API مکمل gateway id چاہتا ہے، developer prefix اور release کے ساتھ:

آپ نے کہاں دیکھا API کو کیا چاہیے
DeepSeek-V4-Flash deepseek-ai/DeepSeek-V4-Flash-0731
GLM-5.3-Flash zai-org/GLM-5.3-Flash
MiniMax-M2.7 MiniMaxAI/MiniMax-M2.7

قیمت کے لیبلوں سے مختصر ids API قبول نہیں کرتا، اور ہجے اہم ہیں: بڑے حروف، سلیش، -0731 لاحقہ۔ id کو CheapTokens دستاویزات سے کاپی کریں بجائے یاد سے ٹائپ کرنے کے — مختلف پرووائیڈر ایک ہی ماڈل کو مختلف نام دیتے ہیں۔ اپنی کلید کے لیے دستیاب عین ids دیکھنے کے لیے، اسی Authorization header کے ساتھ GET https://api.cheaptokens.dev/v1/models کال کریں اور فہرست سے id کاپی کریں:

bash
curl https://api.cheaptokens.dev/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

اگر جدول میں نام کا منطق عجیب لگے، تو how to read AI model names alias بمقابلہ pinned version کی وضاحت کرتا ہے۔

ایک curl کمانڈ سے حل ثابت کریں#

ٹول کو تصویر سے ہٹا دیں اور API کو براہ راست کال کریں۔ کلید کے placeholder کو اپنی کلید سے بدلیں:

bash
curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Say hi in one word."}],
    "max_tokens": 20
  }'

اس ایک درخواست میں تینوں مشتبہ چیزیں موجود ہیں: header میں کلید، پہلی سطر میں base URL، body میں ماڈل id۔ choices array کے ساتھ JSON جواب کا مطلب ہے کہ تینوں درست ہیں، اور آپ کا ٹول جو کچھ مختلف کرتا ہے وہی مسئلہ ہے۔ اگر یہ ناکام ہو، تو ایک وقت میں ایک چیز بدلیں:

  • 401 → CheapTokens سے حاصل کردہ کلید ڈالیں اور دوبارہ چلائیں۔
  • 404 → URL کا اوپر والے سے حرف بہ حرف موازنہ کریں، پھر ماڈل id کا۔

curl کے کام کرنے کے بعد، وہی تین ویلیوز ٹول میں کاپی کریں: کلید، base URL (https://api.cheaptokens.dev/v1، یا Anthropic SDK اور Claude Code کے لیے /v1 کے بغیر) اور مکمل ماڈل id۔

اگر پھر بھی کام نہ کرے#

  • ٹول میں وہی error، curl ٹھیک۔ ٹول کہیں اور سے پرانی کلید یا URL پڑھ رہا ہے: دوسری config file، محفوظ profile، environment variable۔ تبدیل کرنے کے بعد ٹول دوبارہ شروع کریں۔
  • ماڈل id درست ہونے کا یقین نہیں۔ اپنی کلید کے ساتھ GET /v1/models کال کریں اور فہرست سے id کاپی کریں۔
  • Connection refused، timeouts، certificate errors۔ یہ 401 یا 404 نہیں؛ common connection errors دیکھیں۔
  • یقین نہیں کہ پہلی درخواست کیسی ہونی چاہیے۔ Your first API request قدم بہ قدم بتاتا ہے، اور the docs میں مکمل حوالہ موجود ہے۔

اپنانے کے قابل عادت: جب کال ناکام ہو، پہلے نمبر پڑھیں۔ 401 عام طور پر کلید، 404 عام طور پر پتہ یا ماڈل id، اور curl اسے طے کر دیتا ہے۔ یہ ایک بھی لاگ کھولنے سے پہلے ان میں سے زیادہ تر errors حل کر دیتا ہے۔

ٹیگز: