تخطيط المسار
| عبء العمل الحالي | عنوان URL الأساسي لـ TokenLab | نقطة النهاية الرئيسية | ملاحظة الهجرة |
|---|---|---|---|
| إكمالات دردشة OpenAI | https://api.tokenlab.sh/v1 | /chat/completions | أقل تغيير لدردشة OpenAI المتوافقة واستدعاء الوظائف |
| استجابات OpenAI | https://api.tokenlab.sh/v1 | /responses | استخدمه عندما يعتمد تطبيقك على مدخلات أو أدوات أو معالجة مخرجات محددة للاستجابات |
| SDK من Anthropic | https://api.tokenlab.sh | /v1/messages | لا تضف /v1 إلى عنوان URL الأساسي لـ SDK |
| Gemini REST | https://api.tokenlab.sh | /v1beta/models/:model:generateContent | احتفظ بالحقول الأصلية من Gemini على مسار Gemini |
| توليد الوسائط | https://api.tokenlab.sh/v1 | /images, /videos, /music, /3d | اكتشف النماذج مع recommended_for وتوقع الاستطلاع غير المتزامن حيثما تم توثيقه |
| الإدارة والفوترة | https://api.tokenlab.sh/v1 | /management/... | استخدم رموز الإدارة للاستخدام من جانب الخادم وتسوية الفواتير |
هجرة متوافقة مع OpenAI
GET /v1/models قبل حركة المرور الإنتاجية. بالنسبة لتوليد الصور، أرسل model بشكل صريح واقرأ دليل الصور لأن نماذج الصور تختلف أكثر من نماذج الدردشة.
هجرة Anthropic
/v1/messages لاستخدام الأدوات الأصلية من Claude، وتدفقات التفكير، ودلالات رسائل Anthropic. لا تترجم الحقول الخاصة بـ Anthropic فقط عبر إكمالات الدردشة ما لم تكن ترغب عمدًا في تغيير سلوك متوافق مع OpenAI.
هجرة Gemini
/v1beta عندما يعتمد تطبيقك على سلوك Gemini الأصلي.
هجرة الوسائط
- استعلام
GET /v1/models?recommended_for=image|video|music|3d. - اقرأ
tokenlab.public_contract_summaryفي استجابات القائمة وtokenlab.public_contractالكامل حيثما كان متاحًا. - أرسل
modelبشكل صريح، خاصة لنقاط نهاية الصور. - قم بتخزين
task_idوpoll_urlونقطة النهاية والنموذج ومعرف الوظيفة الخاص بك للوظائف غير المتزامنة. - قم بتسوية التكاليف من خلال سجلات الاستخدام و
billing_transaction_id، وليس معرفات مهام المزود.
خطة طرح الإنتاج
| المرحلة | الهدف | الفحوصات |
|---|---|---|
| 1. الجرد | قائمة نقاط النهاية والنماذج وحقول الطلب والسلوك المتزامن/غير المتزامن ومالك الفوترة | لا يُفترض أن تكون هناك حقول خاصة بالمزود مخفية عامة |
| 2. تجربة مسار واحد | نقل نقطة نهاية واحدة وعائلة نموذج واحدة | شكل الاستجابة والتكلفة والسجلات تتطابق مع التوقعات |
| 3. الظل أو العينة | مقارنة المخرجات المحددة مع المزود السابق | الجودة والكمون المرئي للمستخدم مقبولان |
| 4. الطرح التدريجي | زيادة حركة المرور حسب المفتاح أو المنظمة أو علامة الميزة | راقب 4xx و5xx والكمون والتوازن والوظائف غير المتزامنة المكررة |
| 5. التنظيف | إزالة مسار المزود القديم فقط بعد الاستخدام المستقر | تم توثيق مسار التراجع وكتاب الدعم |
عوائق الهجرة
- لا تضع كل نموذج خلف مسار واحد لإكمالات دردشة OpenAI إذا كان تطبيقك يحتاج إلى سلوك أصلي من Anthropic أو Gemini أو استجابات.
- لا تفترض القيم الافتراضية القديمة للصور. أرسل
modelبشكل صريح. - لا تعيد محاولة طلبات الإنشاء غير المتزامنة دون التحقق مما إذا كانت المهمة قد تم إنشاؤها بالفعل.
- لا تكشف عن بيانات توجيه المزود في سجلاتك أو واجهة المستخدم الخاصة بك.
- لا تقارن الفوترة مع معرفات مهام المزود. استخدم سجلات استخدام TokenLab.
مرجع API
| الموضوع | المرجع |
|---|---|
| API متعدد التنسيقات | API متعدد التنسيقات |
| SDK من OpenAI | SDK من OpenAI |
| SDK من Anthropic | SDK من Anthropic |
| Gemini Native | API من Gemini Native |
| توليد الصور | توليد الصور |
| الوظائف غير المتزامنة والاستطلاع | الوظائف غير المتزامنة والاستطلاع |