الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
مفاتيح API

تتطلب جميع طلبات TokenLab API مفتاح API. بالنسبة إلى نقاط النهاية المتوافقة مع OpenAI، أرسله بالشكل التالي: 
Authorization: Bearer sk-your-api-key
بالنسبة إلى طلبات /v1/messages المتوافقة مع Anthropic، يمكنك أيضًا استخدام: 
x-api-key: sk-your-api-key

​
الحصول على مفتاح API الخاص بك

  1. سجّل الدخول إلى لوحة تحكم TokenLab
  2. افتح API Keys
  3. أنشئ مفتاحًا جديدًا
  4. امنحه اسمًا وصفيًا
  5. انسخه فورًا لأنه يُعرض مرة واحدة فقط
  • لا تكشف أبدًا عن مفاتيح API في كود جهة العميل
  • لا تقم أبدًا بإيداع مفاتيح API في نظام التحكم بالإصدارات
  • استخدم متغيرات البيئة أو مدير الأسرار
  • قم بتدوير المفاتيح بشكل دوري
  • احذف المفاتيح غير المستخدمة

​
استخدام مفاتيح API

curl https://api.tokenlab.sh/v1/responses \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "input": "Hello!"
  }'

​
ميزات مفتاح API

​
حدود الاستخدام

يمكنك تعيين حد استخدام لكل مفتاح API:
الإعدادالوصف
بدون حديستخدم المفتاح رصيد حسابك دون قيود
حد ثابتيتوقف المفتاح عن العمل بعد الوصول إلى المبلغ المحدد

​
بادئة المفتاح

تبدأ جميع مفاتيح TokenLab API بـ sk-.

​
التوافق مع Anthropic

بالنسبة إلى نقطة النهاية /v1/messages، يعمل ترويس Anthropic كما هو متوقع: 
curl https://api.tokenlab.sh/v1/messages \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
استخدم Authorization: Bearer ... لنقاط النهاية المتوافقة مع OpenAI مثل /v1/responses و/v1/chat/completions و/v1/models ومعظم مسارات TokenLab الأخرى.

​
استجابات الأخطاء

رمز الحالةالنوعالرمزالوصف
401invalid_api_keyinvalid_api_keyمفتاح API مفقود أو غير صالح
401expired_api_keyexpired_api_keyتم إلغاء مفتاح API
402insufficient_balanceinsufficient_balanceرصيد الحساب غير كافٍ
402quota_exceededquota_exceededتم الوصول إلى حد استخدام مفتاح API
مثال: 
{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}