الانتقال إلى المحتوى الرئيسي
TokenLab يدعم تنسيقات متعددة: يمكنك الاحتفاظ بعملاء متوافقين مع OpenAI، واستدعاءات رسائل أصلية من Anthropic، واستدعاءات REST أصلية من Gemini، ونقاط نهاية الوسائط في أشكالها الطبيعية. الهجرة الأكثر أمانًا هي عدم ترجمة كل عبء عمل إلى تنسيق عالمي واحد. اختر المسار الذي يمتلك السلوك الذي يحتاجه تطبيقك.

تخطيط المسار

عبء العمل الحاليعنوان URL الأساسي لـ TokenLabنقطة النهاية الرئيسيةملاحظة الهجرة
إكمالات دردشة OpenAIhttps://api.tokenlab.sh/v1/chat/completionsأقل تغيير لدردشة OpenAI المتوافقة واستدعاء الوظائف
استجابات OpenAIhttps://api.tokenlab.sh/v1/responsesاستخدمه عندما يعتمد تطبيقك على مدخلات أو أدوات أو معالجة مخرجات محددة للاستجابات
SDK من Anthropichttps://api.tokenlab.sh/v1/messagesلا تضف /v1 إلى عنوان URL الأساسي لـ SDK
Gemini RESThttps://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

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-tokenlab-key",
    base_url="https://api.tokenlab.sh/v1",
)

response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "Hello from TokenLab"}],
)
احتفظ بشفرة إعادة المحاولة، والمهلة، والبث الحالية، ولكن تحقق من معرفات النماذج باستخدام GET /v1/models قبل حركة المرور الإنتاجية. بالنسبة لتوليد الصور، أرسل model بشكل صريح واقرأ دليل الصور لأن نماذج الصور تختلف أكثر من نماذج الدردشة.

هجرة Anthropic

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-your-tokenlab-key",
    base_url="https://api.tokenlab.sh",
)

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Explain TokenLab in one sentence."}],
)
استخدم /v1/messages لاستخدام الأدوات الأصلية من Claude، وتدفقات التفكير، ودلالات رسائل Anthropic. لا تترجم الحقول الخاصة بـ Anthropic فقط عبر إكمالات الدردشة ما لم تكن ترغب عمدًا في تغيير سلوك متوافق مع OpenAI.

هجرة Gemini

curl "https://api.tokenlab.sh/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "Authorization: Bearer sk-your-tokenlab-key" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"Hello"}]}]}'
احتفظ بالأدوات المدمجة في Gemini، ومراجع API للملفات، والمحتويات المخزنة، وإعلانات الوظائف، وأجزاء المحتوى الأصلية على /v1beta عندما يعتمد تطبيقك على سلوك Gemini الأصلي.

هجرة الوسائط

  1. استعلام GET /v1/models?recommended_for=image|video|music|3d.
  2. اقرأ tokenlab.public_contract_summary في استجابات القائمة وtokenlab.public_contract الكامل حيثما كان متاحًا.
  3. أرسل model بشكل صريح، خاصة لنقاط نهاية الصور.
  4. قم بتخزين task_id وpoll_url ونقطة النهاية والنموذج ومعرف الوظيفة الخاص بك للوظائف غير المتزامنة.
  5. قم بتسوية التكاليف من خلال سجلات الاستخدام وbilling_transaction_id، وليس معرفات مهام المزود.
تحتاج أحمال العمل الخاصة بالوسائط إلى خطة طرح خاصة بها لأن الكمون، وإعادة المحاولات، والأصول النهائية تتصرف بشكل مختلف عن إكمالات الدردشة.

خطة طرح الإنتاج

المرحلةالهدفالفحوصات
1. الجردقائمة نقاط النهاية والنماذج وحقول الطلب والسلوك المتزامن/غير المتزامن ومالك الفوترةلا يُفترض أن تكون هناك حقول خاصة بالمزود مخفية عامة
2. تجربة مسار واحدنقل نقطة نهاية واحدة وعائلة نموذج واحدةشكل الاستجابة والتكلفة والسجلات تتطابق مع التوقعات
3. الظل أو العينةمقارنة المخرجات المحددة مع المزود السابقالجودة والكمون المرئي للمستخدم مقبولان
4. الطرح التدريجيزيادة حركة المرور حسب المفتاح أو المنظمة أو علامة الميزةراقب 4xx و5xx والكمون والتوازن والوظائف غير المتزامنة المكررة
5. التنظيفإزالة مسار المزود القديم فقط بعد الاستخدام المستقرتم توثيق مسار التراجع وكتاب الدعم

عوائق الهجرة

  • لا تضع كل نموذج خلف مسار واحد لإكمالات دردشة OpenAI إذا كان تطبيقك يحتاج إلى سلوك أصلي من Anthropic أو Gemini أو استجابات.
  • لا تفترض القيم الافتراضية القديمة للصور. أرسل model بشكل صريح.
  • لا تعيد محاولة طلبات الإنشاء غير المتزامنة دون التحقق مما إذا كانت المهمة قد تم إنشاؤها بالفعل.
  • لا تكشف عن بيانات توجيه المزود في سجلاتك أو واجهة المستخدم الخاصة بك.
  • لا تقارن الفوترة مع معرفات مهام المزود. استخدم سجلات استخدام TokenLab.

مرجع API

الموضوعالمرجع
API متعدد التنسيقاتAPI متعدد التنسيقات
SDK من OpenAISDK من OpenAI
SDK من AnthropicSDK من Anthropic
Gemini NativeAPI من Gemini Native
توليد الصورتوليد الصور
الوظائف غير المتزامنة والاستطلاعالوظائف غير المتزامنة والاستطلاع