توثيق

کسی بھی انٹی API کلید کے ساتھ محفوظ طریقے سے ہر معاون API پروٹوکول کی توثیق کریں۔

ہر ڈیولپر API درخواست کے لیے ایک فعال AnyInt API کلید درکار ہے۔ اپنے کلائنٹ پروٹوکول کے ذریعہ متوقع ہیڈر استعمال کریں تاکہ موجودہ OpenAI، Anthropic، اور Gemini SDKs کام کرتے رہیں۔

پروٹوکول کے لحاظ سے تجویز کردہ توثیق

پروٹوکولتجویز کردہ ان پٹکینونیکل API بیس
OpenAI کے مطابقAuthorization: Bearer <AnyInt API Key>https://api.anyint.ai/openai/v1
Anthropic پیغاماتx-api-key: <AnyInt API Key>https://api.anyint.ai/anthropic/v1
Gemini ڈیولپر APIx-goog-api-key: <AnyInt API Key>https://api.anyint.ai/gemini/v1beta
Async میڈیاAuthorization: Bearer <AnyInt API Key>https://api.anyint.ai/v1/async-tasks

کلائنٹ کی مطابقت کے لیے، گیٹ وے پروٹوکول خاندانوں میں معاون AnyInt کلید ہیڈرز کو بھی قبول کرتا ہے اور Gemini راستوں پر Gemini کے key کوئری پیرامیٹر کو قبول کرتا ہے۔ ہیڈرز کو ترجیح دیں تاکہ اسناد URLs یا انٹرمیڈیٹ لاگز میں ظاہر نہ ہوں۔

گیٹ وے فراہم کنندہ روٹنگ سے پہلے AnyInt اسناد استعمال کرتا ہے۔ یہ اسناد کو کبھی بھی اپ اسٹریم فراہم کنندہ کلید کے طور پر آگے نہیں بھیجتا ہے۔ غلط، ختم شدہ، یا منسوخ شدہ کلیدیں ناکام ہو جاتی ہیں۔

کلید بنائیں

Console میں API کلید بنائیں، پھر اسے سرور سائیڈ سیکرٹ مینیجر یا انوائرنمنٹ ویری ایبل میں محفوظ کریں۔

نئی جاری کردہ AnyInt کلیدیں sk- سے شروع ہوتی ہیں جس کے بعد 52 بیس64URL حروف (کل 55 حروف) ہوتے ہیں۔ موجودہ ak_ کلیدیں تب تک درست رہیں گی جب تک آپ انہیں روٹیٹ یا غیر فعال نہیں کرتے۔ ہمیشہ Console کے ذریعہ دکھائے گئے مکمل قدر کو کاپی کریں؛ خود سے کوئی سابقہ نہ شامل کریں اور نہ ہی ہٹائیں۔

bash
export ANYINT_API_KEY="your_api_key"

حفاظتی ہدایات

  • کلیدوں کو سرور سائیڈ سیکرٹ مینیجر یا انوائرنمنٹ ویری ایبل میں محفوظ کریں۔
  • کلید کو کبھی بھی فرنٹ اینڈ جاوا اسکرپٹ، سورس کنٹرول، لاگز، یا URLs میں نہ رکھیں۔
  • ہر ایپلیکیشن اور انوائرنمنٹ کے لیے ایک الگ کلید استعمال کریں۔
  • اگر کوئی کلید بے نقاب ہو گئی ہو تو اسے فوری طور پر روٹیٹ کریں۔
  • AnyInt کلیدوں کو اپ اسٹریم فراہم کنندگان کو آگے نہ بھیجیں۔

توثیق کا تجربہ کریں

انفرنس کی درخواست بھیجنے سے پہلے کلید کی تصدیق کرنے کے لیے ماڈلز کی فہرست بنائیں۔

bash
curl "https://api.anyint.ai/openai/v1/models" \
  --header "Authorization: Bearer $ANYINT_API_KEY"

توثیق کی ناکامی HTTP 401 کے ساتھ پروٹوکول کی شکل میں ایک غلطی واپس کرتی ہے۔ ایک درست کلید اب بھی ناکافی بیلنس کے لیے 402 یا جب کوئی اہل فراہم کنندہ دستیاب نہ ہو تو 503 وصول کر سکتی ہے۔

عام خرابیوں کا ازالہ

جب کوئی API درخواست ناکام ہو جائے تو وجہ اور حل کو تیزی سے شناخت کرنے کے لیے اس جدول کا استعمال کریں:

HTTP حیثیتعام وجہخرابی کا ازالہ اور حل
401 Unauthorizedباطل یا زائد المیعاد API کلید، یا ہیڈر غائب ہےاپنے Bearer ٹوکن یا x-api-key ہیڈر کی تصدیق کریں؛ یقینی بنائیں کہ کلید کنسول API کلیدیں میں فعال ہے۔
402 Payment Requiredناکافی بیلنس یا ماہانہ بجٹ کی حد ختم ہو گئیکنسول میں کریڈٹ شامل کریں یا API کلید کے لیے ماہانہ بجٹ کی حد بڑھائیں۔
403 ForbiddenIP پابندی، ماحول کی عدم مطابقت، یا ناکافی اجازتیںاپنی API کلید کا دائرہ کار چیک کریں اور اپنے کلائنٹ IP کو اجازت یافتہ IP فہرست سے چیک کریں۔
404 Not Foundغلط اینڈ پوائنٹ پاتھ یا نامعلوم ماڈل IDBase URL پاتھ کی تصدیق کریں؛ ماڈل ID فعال ہونے کی تصدیق کے لیے GET /v1/models کو کال کریں۔
429 Too Many Requestsشرح کی حد (RPM/TPM) یا سمورتی حد مکمل ہو گئیسمورتی کو کم کریں؛ ایکسپونینشل بیک آف ری ٹرائی ترتیب دیں؛ یا کنسول میں کوٹہ بڑھانے کی درخواست کریں۔
502 Bad Gatewayاپ اسٹریم فراہم کنندہ کا نیٹ ورک کا مسئلہ یا خراب ردعملAnyInt گیٹ وے خودکار طور پر چینلز پر فیل اوور کی کوشش کرتا ہے؛ اگر مسئلہ برقرار رہے تو کنسول کی درخواست لاگز سے رپورٹ کریں۔
503 Service Unavailableتمام روٹنگ امیدوار چینلز عارضی طور پر دستیاب نہیں ہیںتھوڑی دیر بعد دوبارہ کوشش کریں یا مساوی متبادل ماڈل پر سوئچ کریں۔
504 Gateway Timeoutاپ اسٹریم استدلال کا وقت ختم ہو گیا (پیچیدہ استدلال ماڈل)پرامپٹ کی پیچیدگی چیک کریں؛ کلائنٹ سائیڈ ٹائم آؤٹ بڑھائیں؛ استدلال کے ماڈلز کے لیے اسٹریمنگ (stream: true) کو فعال کریں۔