مصفوفة التوافق
توافق الأدوات وحزم SDK
اعثر على إعداد TokenLab المناسب لأدوات البرمجة وتطبيقات الدردشة وحزم SDK وأطر العمل
تتصل معظم الأدوات بـ TokenLab عبر تغيير مفتاح API وعنوان URL الأساسي. ويعتمد الإعداد الدقيق على تنسيق API الذي يمكن للأداة استخدامه.
| تنسيق API | عنوان URL الأساسي | العملاء الشائعون |
|---|---|---|
| Chat Completions (متوافق مع OpenAI) | https://api.tokenlab.sh/v1 | حزم SDK الخاصة بـ OpenAI والعديد من تطبيقات الدردشة وأطر العمل |
| OpenAI Responses | https://api.tokenlab.sh/v1 | عملاء Responses والأدوات التي تستخدم أحداث Responses |
| Anthropic Messages | https://api.tokenlab.sh | حزم SDK الخاصة بـ Anthropic والأدوات الموجهة إلى Claude |
| Gemini | https://api.tokenlab.sh | عملاء Gemini عبر REST أو SDK الذين يسمحون بمضيف مخصص |
يجب أن يتضمن accepted_request_formats للنموذج المختار التنسيق نفسه. ويعتمد البث واستدعاء الأدوات أيضًا على قدرات النموذج ودعم العميل. راجع الأمثلة في تنسيقات API.
حالات التوافق
| الحالة | المعنى |
|---|---|
| متوافق | يستخدم إعداد TokenLab في الصفحة المرتبطة خيارات الإعداد الموثقة للعميل |
| متوافق مع قيود | ينطبق الإعداد على ميزات أو طرق مصادقة محددة؛ وتبقى لخدمات المورّد الأخرى متطلباتها الخاصة |
تصف هذه الحالات طريقة الإعداد في الصفحة المرتبطة. ويعتمد توفر الميزات أيضًا على النموذج المختار وإصدار العميل.
أدوات البرمجة
| الأداة | الحالة | تنسيق API | ملاحظات |
|---|---|---|---|
| Claude Code | متوافق | Anthropic Messages | يستخدم ANTHROPIC_BASE_URL ومفتاح API من TokenLab |
| Codex CLI | متوافق مع قيود | Responses | يستخدم Responses؛ وتعتمد الميزات المتاحة على النموذج المختار |
| Cursor | متوافق مع قيود | متوافق مع OpenAI | ينطبق على ميزات Cursor التي تقبل مفتاح API وعنوان URL مخصصين |
| Cline | متوافق | متوافق مع OpenAI | اختر OpenAI Compatible وأدخل عنوان URL الأساسي ومعرّف النموذج |
| Kilo Code | متوافق | متوافق مع OpenAI | يستخدم موفّرًا مخصصًا ومعرّف نموذج |
| OpenCode | متوافق | متوافق مع OpenAI | حمّل إعداد موفّر منفصلًا باستخدام OPENCODE_CONFIG |
| OpenHands | متوافق | متوافق مع OpenAI | واجهة تعتمد على LiteLLM: Advanced → Custom Model مع البادئة openai/ وحقل Base URL |
| Gemini CLI | متوافق مع قيود | Gemini | استخدم GOOGLE_GEMINI_BASE_URL مع المصادقة بمفتاح API؛ ويحافظ GEMINI_CLI_HOME المنفصل على الإعداد الحالي |
تطبيقات الدردشة
| التطبيق | الحالة | ملاحظات |
|---|---|---|
| Chatbox | متوافق | أضف موفّرًا من نوع OpenAI API Compatible |
| Cherry Studio | متوافق | أضف موفّرًا وأكمل Verify and Enable |
| DeepChat | متوافق | اختر OpenAI Completions لاستخدام Chat Completions |
| Jan | متوافق | أضف خدمة متوافقة مع OpenAI |
| LibreChat | متوافق | اضبط نقطة نهاية مخصصة متوافقة مع OpenAI |
| Open WebUI | متوافق | أضف اتصالًا متوافقًا مع OpenAI واختر Chat في API Type |
حزم SDK وأطر العمل
| العميل | الحالة | الإعداد |
|---|---|---|
| OpenAI SDK | متوافق | اضبط base_url / baseURL على https://api.tokenlab.sh/v1 |
| Anthropic SDK | متوافق | اضبط عنوان URL الأساسي على https://api.tokenlab.sh |
| Vercel AI SDK | متوافق | أنشئ موفّرًا مخصصًا متوافقًا مع OpenAI |
| LangChain | متوافق | اضبط ChatOpenAI أو OpenAIEmbeddings باستخدام عنوان TokenLab |
| LlamaIndex | متوافق | استخدم خيارات العميل المتوافق مع OpenAI |
| OpenAI Agents SDK | متوافق مع قيود | يستخدم الدليل OpenAIChatCompletionsModel؛ تحقق من دعم الميزات في النموذج وSDK قبل استخدام Responses |
| AutoGen | متوافق | استخدم عميل نماذج متوافقًا مع OpenAI |
| CrewAI | متوافق | اضبط عميل LLM المتوافق مع OpenAI |
| PydanticAI | متوافق | حدد موفّرًا متوافقًا مع OpenAI |
توجد أطر عمل وأدوات مراقبة وبوابات ومنتجات تقييم أخرى في قائمة Integrations.
الاستهلاك في الاستجابات المتدفقة
تقبل تدفقات Chat Completions الخيار stream_options: { include_usage: true }، الذي يضيف جزءًا أخيرًا يتضمن الاستهلاك قبل إغلاق التدفق. لا توفر واجهة Responses الخيار include_usage؛ بل تعرض تدفقاتها الاستهلاك في الحدث الختامي.
ما لا يستبدله مفتاح API مخصص
تجمع بعض المنتجات بين استدعاءات النموذج وميزات يستضيفها المورّد. يمكن لمفتاح TokenLab تشغيل طلبات النموذج المتاحة عبر إعدادات BYOK، لكنه لا يستبدل الاشتراكات الأخرى أو خدمات الإكمال التلقائي أو ميزات الحساب أو الإضافات المملوكة للمورّد.
إذا غيّر تحديث الأداة طريقة إعدادها، فاتبع صفحة التكامل الحالية بدلًا من نسخ مثال قديم لمتغيرات البيئة.
قبل الاعتماد على ميزة
- تأكد من أن الأداة تسمح بعنوان URL أساسي مخصص للتنسيق المطلوب.
- تأكد من أن النموذج يدرج هذا التنسيق في
accepted_request_formats. - جرّب البث واستدعاءات الأدوات إذا كان سير عملك يتطلبها.
- احتفظ بمفتاح API على جهاز أو خادم موثوق.
- سجّل معرّف الطلب عند الإبلاغ عن خطأ.