المصادقة

قم بمصادقة كل بروتوكول واجهة برمجة تطبيقات مدعوم بأمان باستخدام مفتاح واجهة برمجة تطبيقات AnyInt.

يتطلب كل طلب واجهة برمجة تطبيقات للمطور مفتاح واجهة برمجة تطبيقات AnyInt نشطًا. استخدم الرأس الذي يتوقعه بروتوكول العميل الخاص بك حتى تستمر حزم تطوير البرامج (SDKs) الحالية لـ OpenAI و Anthropic و Gemini في العمل.

المصادقة الموصى بها حسب البروتوكول

البروتوكولالإدخال الموصى بهقاعدة واجهة برمجة التطبيقات القياسية
متوافق مع OpenAIAuthorization: Bearer <AnyInt API Key>https://api.anyint.ai/openai/v1
رسائل Anthropicx-api-key: <AnyInt API Key>https://api.anyint.ai/anthropic/v1
Gemini Developer APIx-goog-api-key: <AnyInt API Key>https://api.anyint.ai/gemini/v1beta
وسائط غير متزامنةAuthorization: Bearer <AnyInt API Key>https://api.anyint.ai/v1/async-tasks

للتوافق مع العميل، يقبل البوابة أيضًا رؤوس مفاتيح AnyInt المدعومة عبر عائلات البروتوكولات ويقبل معلمة استعلام Gemini key على مسارات Gemini. فضل الرؤوس حتى لا تظهر بيانات الاعتماد في عناوين URL أو السجلات الوسيطة.

تستهلك البوابة بيانات اعتماد AnyInt قبل توجيه الموفر. لا تقوم أبدًا بإعادة توجيه بيانات الاعتماد هذه كمفتاح موفر علوي. تفشل المفاتيح غير الصالحة أو منتهية الصلاحية أو الملغاة بشكل مغلق.

إنشاء مفتاح

إنشاء مفتاح واجهة برمجة تطبيقات في وحدة التحكم، ثم قم بتخزينه في مدير أسرار جانب الخادم أو متغير بيئة.

تستخدم مفاتيح AnyInt الصادرة حديثًا البادئة sk- متبوعة بـ 52 حرفًا من Base64URL (55 حرفًا إجمالاً). تظل مفاتيح ak_ الحالية صالحة حتى تقوم بتدويرها أو تعطيلها. انسخ دائمًا القيمة الكاملة التي تعرضها وحدة التحكم؛ لا تقم بإضافة أو إزالة بادئة بنفسك.

bash
export ANYINT_API_KEY="your_api_key"

إرشادات الأمان

  • قم بتخزين المفاتيح في مدير أسرار جانب الخادم أو متغير بيئة.
  • لا تضع مفتاحًا أبدًا في JavaScript الواجهة الأمامية، أو التحكم في المصدر، أو السجلات، أو عناوين URL.
  • استخدم مفتاحًا منفصلاً لكل تطبيق وبيئة.
  • قم بتدوير مفتاح على الفور إذا كان من المحتمل أن يكون قد تم كشفه.
  • لا تقم بإعادة توجيه مفاتيح 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 Forbiddenقيود عنوان IP أو عدم تطابق البيئة أو عدم كفاية الأذوناتتحقق من نطاق مفتاح API وتأكد من عنوان IP للعميل ضمن قائمة العناوين المسموح بها.
404 Not Foundمسار نقطة نهاية غير صحيح أو معرف نموذج غير معروفتحقق من مسار Base URL؛ واستدعِ GET /v1/models للتأكد من أن معرف النموذج نشط.
429 Too Many Requestsتم الوصول إلى حد المعدل (RPM/TPM) أو الحد الأقصى للتزامنقلل التزامن؛ وقم بإعداد إعادة المحاولة بفاصل تصاعدي؛ أو اطلب زيادة الحصة من وحدة التحكم.
502 Bad Gatewayخطأ في شبكة المزود الرئيسي أو استجابة غير صحيحةتحاول بوابة AnyInt تجاوز الفشل تلقائيًا عبر القنوات؛ إذا استمرت المشكلة، أبلغ عبر سجلات طلبات وحدة التحكم.
503 Service Unavailableجميع قنوات التوجيه المرشحة غير متاحة مؤقتًاأعد المحاولة بعد مهلة قصيرة أو انتقل إلى نموذج بديل مكافئ.
504 Gateway Timeoutانتهاء مهلة استنتاج المزود الرئيسي (نماذج التفكير المعقدة)تحقق من تعقيد المطالبة؛ وزد مهلة انتظار العميل؛ ومكّن البث التدفقي (stream: true) لنماذج التفكير.