البدء
البدء السريع
أرسل أول طلب إلى TokenLab API باستخدام cURL أو Python أو JavaScript أو Go أو PHP. اضبط مفتاح API ونقطة النهاية، ثم شغّل مثال Chat Completions وتحقق من الاستجابة.
الخطوة 1: أنشئ حسابًا وأضف رصيدًا
إنشاء حساب
سجّل في tokenlab.sh باستخدام بريدك الإلكتروني أو Gmail أو حساب GitHub.
التحقق من رصيد مساحة العمل
تحقق من الرصيد المتاح في الفوترة. يُحاسب هذا الطلب بسعر النموذج الحالي؛ أضف رصيدًا عند الحاجة.
إنشاء مفتاح API وحفظه
افتح مفاتيح API في مساحة عملك. أنشئ مفتاحًا واحفظ قيمته الكاملة فورًا؛ فهي تظهر مرة واحدة فقط. إذا كنت قد حفظت مفتاحًا كاملًا من قبل، فاستخدم تلك القيمة. البادئة المعروضة أو المنسوخة من القائمة لا تصلح لمصادقة الطلبات.
احفظ مفتاح الـ API الخاص بك بأمان. لا تكشف عنه في شيفرة جانب العميل أو في مستودعات عامة.
تعيين المفتاح لهذه الطرفية
لا تضع هذه الأوامر المفتاح داخل نص الأمر نفسه. يسري فقط على الطرفية الحالية والعمليات التابعة لها. استخدم مدير أسرار للتطبيقات المنشورة.
printf 'TokenLab API key: '
read -r -s TOKENLAB_API_KEY
printf '\n'
export TOKENLAB_API_KEYالخطوة 2: تثبيت عميل
pip install openaiالخطوة 3: أجرِ طلبك الأول
بالنسبة لمعظم عمليات التكامل الجديدة، ابدأ بـ إكمالات الدردشة على POST /v1/chat/completions.
curl https://api.tokenlab.sh/v1/chat/completions \
-H "Authorization: Bearer $TOKENLAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-terra","messages":[{"role":"user","content":"Reply only with OK."}]}'احفظ مثال SDK باسم quickstart.py أو quickstart.mjs أو main.go أو quickstart.php، ثم شغّل python quickstart.py أو node quickstart.mjs أو go run . أو php quickstart.php. تستخدم Python وJavaScript وGo حزم OpenAI الرسمية؛ وتستخدم PHP عميل المجتمع وتتطلب PHP 8.2 أو أحدث.
استخدم POST /v1/responses فقط عندما تحتاج صراحةً إلى سلوك مخصص لـ Responses. بعض الحقول الخاصة بـ Responses تعتمد على النموذج المحدد ومسار التوجيه.
التحقق من النتيجة
يعيد الطلب الناجح إجابة غير فارغة. راجع النموذج والحالة والاستخدام في الطلبات ضمن مساحة العمل نفسها. للأخطاء راجع استكشاف المشكلات، ولتغيير النموذج والبث راجع دليل SDK.