توثيق
کسی بھی انٹی 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 ڈیولپر API | x-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 کے ذریعہ دکھائے گئے مکمل قدر کو کاپی کریں؛ خود سے کوئی سابقہ نہ شامل کریں اور نہ ہی ہٹائیں۔
export ANYINT_API_KEY="your_api_key"حفاظتی ہدایات
- کلیدوں کو سرور سائیڈ سیکرٹ مینیجر یا انوائرنمنٹ ویری ایبل میں محفوظ کریں۔
- کلید کو کبھی بھی فرنٹ اینڈ جاوا اسکرپٹ، سورس کنٹرول، لاگز، یا URLs میں نہ رکھیں۔
- ہر ایپلیکیشن اور انوائرنمنٹ کے لیے ایک الگ کلید استعمال کریں۔
- اگر کوئی کلید بے نقاب ہو گئی ہو تو اسے فوری طور پر روٹیٹ کریں۔
- AnyInt کلیدوں کو اپ اسٹریم فراہم کنندگان کو آگے نہ بھیجیں۔
توثیق کا تجربہ کریں
انفرنس کی درخواست بھیجنے سے پہلے کلید کی تصدیق کرنے کے لیے ماڈلز کی فہرست بنائیں۔
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 Forbidden | IP پابندی، ماحول کی عدم مطابقت، یا ناکافی اجازتیں | اپنی API کلید کا دائرہ کار چیک کریں اور اپنے کلائنٹ IP کو اجازت یافتہ IP فہرست سے چیک کریں۔ |
| 404 Not Found | غلط اینڈ پوائنٹ پاتھ یا نامعلوم ماڈل ID | Base URL پاتھ کی تصدیق کریں؛ ماڈل ID فعال ہونے کی تصدیق کے لیے GET /v1/models کو کال کریں۔ |
| 429 Too Many Requests | شرح کی حد (RPM/TPM) یا سمورتی حد مکمل ہو گئی | سمورتی کو کم کریں؛ ایکسپونینشل بیک آف ری ٹرائی ترتیب دیں؛ یا کنسول میں کوٹہ بڑھانے کی درخواست کریں۔ |
| 502 Bad Gateway | اپ اسٹریم فراہم کنندہ کا نیٹ ورک کا مسئلہ یا خراب ردعمل | AnyInt گیٹ وے خودکار طور پر چینلز پر فیل اوور کی کوشش کرتا ہے؛ اگر مسئلہ برقرار رہے تو کنسول کی درخواست لاگز سے رپورٹ کریں۔ |
| 503 Service Unavailable | تمام روٹنگ امیدوار چینلز عارضی طور پر دستیاب نہیں ہیں | تھوڑی دیر بعد دوبارہ کوشش کریں یا مساوی متبادل ماڈل پر سوئچ کریں۔ |
| 504 Gateway Timeout | اپ اسٹریم استدلال کا وقت ختم ہو گیا (پیچیدہ استدلال ماڈل) | پرامپٹ کی پیچیدگی چیک کریں؛ کلائنٹ سائیڈ ٹائم آؤٹ بڑھائیں؛ استدلال کے ماڈلز کے لیے اسٹریمنگ (stream: true) کو فعال کریں۔ |