البدء
المصادقة
أمّن طلبات TokenLab API الخاصة بك باستخدام مفاتيح API
مفاتيح API
تتطلب استدعاءات النماذج والموارد الخاصة مفتاح API. تعمل نقاط الاكتشاف العامة مثل GET /v1/models وGET /v1/models/{model} دون مفتاح. نجاح استعلام الاكتشاف لا يؤكد صلاحية المفتاح؛ اتبع دليل البدء السريع لإرسال طلب إلى نموذج. استخدم المفتاح الكامل المحفوظ، لا البادئة الظاهرة في القائمة.
بالنسبة إلى نقاط النهاية المتوافقة مع OpenAI، أرسله بالشكل التالي:
Authorization: Bearer sk-your-api-keyبالنسبة إلى طلبات /v1/messages المتوافقة مع Anthropic، يمكنك أيضًا استخدام:
x-api-key: sk-your-api-keyرموز الإدارة
تستخدم نقاط نهاية واجهة إدارة API نوعًا منفصلًا من الرموز:
Authorization: Bearer mt-your-management-tokenاستخدم رموز الإدارة فقط مع /v1/management/*. افتح API → Tokens لمساحة العمل المحددة لإنشاء رمز أو استبداله. احفظ الرمز الكامل بأمان عند ظهوره؛ فهو يُعرض مرة واحدة فقط بعد الإنشاء أو الاستبدال.
لا يمكن استخدام رموز الإدارة لاستدلال النماذج، ولا يمكن استخدام مفاتيح API العادية sk-... مع واجهة إدارة API.
الحصول على مفتاح API الخاص بك
- سجّل الدخول إلى لوحة تحكم TokenLab
- افتح API Keys
- أنشئ مفتاحًا جديدًا
- امنحه اسمًا وصفيًا
- انسخه فورًا لأنه يُعرض مرة واحدة فقط
- لا تكشف أبدًا عن مفاتيح API في كود جهة العميل
- لا تقم أبدًا بإيداع مفاتيح API في نظام التحكم بالإصدارات
- استخدم متغيرات البيئة أو مدير الأسرار
- قم بتدوير المفاتيح بشكل دوري
- احذف المفاتيح غير المستخدمة
استخدام مفاتيح API
راجع البدء السريع لمتغيرات البيئة وطلب أول كامل. استخدم SDK المناسب لصيغة API المختارة واحتفظ بالمفاتيح على الخادم.
ميزات مفتاح API
حدود الاستخدام
يمكنك تعيين حد استخدام لكل مفتاح API:
| الإعداد | الوصف |
|---|---|
| بدون حد | يستخدم المفتاح رصيد حسابك دون قيود |
| حد ثابت | يتوقف المفتاح عن العمل بعد الوصول إلى المبلغ المحدد |
بادئة المفتاح
تبدأ جميع مفاتيح TokenLab API بـ sk-.
استجابات الأخطاء
| رمز الحالة | النوع | الرمز | الوصف |
|---|---|---|---|
| 401 | invalid_api_key | invalid_api_key | مفتاح API مفقود أو غير صالح أو غير نشط أو ملغى |
| 401 | expired_api_key | expired_api_key | انتهت صلاحية مفتاح API |
| 402 | insufficient_balance | insufficient_balance | رصيد الحساب غير كافٍ |
| 402 | quota_exceeded | quota_exceeded | تم الوصول إلى حد استخدام مفتاح API |
مثال:
{
"error": {
"message": "Invalid API key provided",
"type": "invalid_api_key",
"code": "invalid_api_key"
}
}