مصفوفة التوافق
توافق الأدوات و SDK
اعثر على إعداد TokenLab المناسب لأدوات البرمجة، وتطبيقات الدردشة، و SDK، وأطر العمل
تتصل معظم الأدوات بـ TokenLab عن طريق تغيير مفتاح API وعنوان URL الأساسي. يعتمد الإعداد الدقيق على تنسيق API الذي يمكن للأداة استخدامه.
| تنسيق API | عنوان URL الأساسي | العملاء الشائعون |
|---|---|---|
| Chat Completions (متوافق مع OpenAI) | https://api.tokenlab.sh/v1 | OpenAI SDKs، والعديد من تطبيقات الدردشة وأطر العمل |
| OpenAI Responses | https://api.tokenlab.sh/v1 | عملاء Responses والأدوات المبنية حول أحداث Responses |
| Anthropic Messages | https://api.tokenlab.sh | Anthropic SDKs والأدوات الموجهة لـ Claude |
| Gemini | https://api.tokenlab.sh | عملاء Gemini REST و SDK الذين يسمحون بمضيف مخصص |
يجب أن يدرج النموذج المختار نفس التنسيق في accepted_request_formats. يعتمد البث (Streaming) واستدعاء الأدوات (Tool calling) أيضًا على إمكانيات النموذج والعميل. راجع تنسيقات API للاطلاع على الأمثلة.
تصنيفات التوافق
| التصنيف | المعنى |
|---|---|
| يعمل | إعداد TokenLab المرتبط يستخدم خيارات التكوين الموثقة للعميل |
| يعمل مع قيود | ينطبق التكوين على ميزات محددة أو أوضاع مصادقة؛ تحتفظ خدمات البائعين الأخرى بمتطلباتها الخاصة |
تصف هذه التصنيفات التكوين الموجود في الصفحة المرتبطة. يعتمد توفر الميزات أيضًا على النموذج المختار وإصدار العميل.
أدوات البرمجة
| الأداة | الحالة | تنسيق API | ملاحظات |
|---|---|---|---|
| Claude Code | يعمل | Anthropic Messages | يستخدم ANTHROPIC_BASE_URL ومفتاح TokenLab API |
| 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 منفصل على الإعداد الحالي |
| Visual Studio Code | يعمل مع قيود | متوافق مع OpenAI | الدردشة عبر نقطة نهاية مخصصة (Chat Completions)؛ لا حاجة لخطة Copilot للدردشة. لا تزال الاقتراحات المضمنة والبحث الدلالي تتطلب GitHub |
تطبيقات الدردشة
| التطبيق | الحالة | ملاحظات |
|---|---|---|
| Chatbox | يعمل | أضف مزود OpenAI API Compatible |
| Cherry Studio | يعمل | أضف مزودًا وأكمل Verify and Enable |
| DeepChat | يعمل | اختر OpenAI Completions لـ Chat Completions |
| Jan | يعمل | أضف خدمة متوافقة مع OpenAI |
| LibreChat | يعمل | قم بتكوين نقطة نهاية مخصصة متوافقة مع OpenAI |
| Open WebUI | يعمل | أضف اتصالًا متوافقًا مع OpenAI مع نوع API Chat |
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 باستخدام عنوان URL الخاص بـ TokenLab |
| LlamaIndex | يعمل | استخدم خيارات العميل المتوافقة مع OpenAI |
| OpenAI Agents SDK | يعمل مع قيود | يستخدم الدليل OpenAIChatCompletionsModel؛ تحقق من دعم ميزات النموذج و SDK قبل استخدام Responses |
| AutoGen | يعمل | استخدم عميل نموذج متوافق مع OpenAI |
| CrewAI | يعمل | قم بتكوين عميل LLM المتوافق مع OpenAI الخاص به |
| PydanticAI | يعمل | قدم مزودًا متوافقًا مع OpenAI |
يتم سرد المزيد من أطر العمل، وأدوات المراقبة، والبوابات، ومنتجات التقييم في قائمة التنقل الخاصة بالتكاملات (Integrations).
الاستخدام في الاستجابات المباشرة (Streamed responses)
تقبل تدفقات Chat Completions المعامل stream_options: { include_usage: true }، والذي يضيف جزء استخدام نهائي قبل إغلاق التدفق. لا يكشف API الخاص بـ Responses عن include_usage؛ حيث تبلغ تدفقات Responses عن الاستخدام في حدثها النهائي بدلاً من ذلك.
ما لا يستبدله مفتاح API المخصص
تدمج بعض المنتجات استدعاءات النماذج مع ميزات يستضيفها بائع المنتج. يمكن لمفتاح TokenLab تشغيل طلبات النماذج المكشوفة من خلال إعدادات BYOK، لكنه لا يستبدل الاشتراكات غير ذات الصلة، أو خدمات الإكمال التلقائي، أو ميزات الحساب، أو الإضافات الخاصة.
عندما يغير تحديث الأداة تكوينها، استخدم صفحة التكامل الحالية بدلاً من نسخ مقتطف متغير بيئة قديم من مكان آخر.
قبل الاعتماد على ميزة ما
- تأكد من أن الأداة تسمح بعنوان URL أساسي مخصص للتنسيق الذي تحتاجه.
- تأكد من أن النموذج يدرج ذلك التنسيق في
accepted_request_formats. - اختبر البث واستدعاء الأدوات إذا كان سير عملك يتطلب ذلك.
- احتفظ بمفتاح API على جهاز أو خادم موثوق.
- سجل معرف الطلب (Request ID) عند الإبلاغ عن فشل.