الأدلة الأساسية
أدلة الترحيل
انقل عملاء OpenAI و Anthropic و Gemini والوسائط الحاليين إلى TokenLab
حافظ على تنسيق الطلب الذي يستخدمه تطبيقك بالفعل. تمتلك كل من العملاء المتوافقة مع OpenAI، و Anthropic Messages، و Gemini REST، ونقاط نهاية الوسائط عنوان API مطابقاً في TokenLab.
تعيين API
| API الحالي | عنوان URL الأساسي لـ TokenLab | نقطة النهاية | ملاحظات هامة |
|---|---|---|---|
| OpenAI Chat Completions | https://api.tokenlab.sh/v1 | /chat/completions | أقل تغيير ممكن للدردشة المتوافقة مع OpenAI واستدعاء الدوال |
| OpenAI Responses | https://api.tokenlab.sh/v1 | /responses | استخدمه عندما يعتمد تطبيقك على مدخلات أو أدوات أو معالجة مخرجات خاصة بـ Responses |
| Anthropic SDK | 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/generations, /videos/generations, /music/generations, /3d/generations | اكتشف النماذج باستخدام recommended_for وتوقع الاستطلاع غير المتزامن حيثما تم توثيقه |
| الإدارة والفواتير | https://api.tokenlab.sh/v1 | /management/... | تستخدم استدعاءات جانب الخادم رمز إدارة (management token)، وليس مفتاح API للنموذج |
وصفات الترحيل السريع
من OpenAI إلى TokenLab
قم بتغيير base_url / baseURL الخاص بـ SDK إلى https://api.tokenlab.sh/v1 ، واستبدل مفتاح API، واختر معرف نموذج من GET /v1/models.
من OpenRouter إلى TokenLab
استبدل عنوان URL الأساسي لـ OpenRouter بـ https://api.tokenlab.sh/v1. لا تتضمن معرفات نماذج TokenLab بادئة مزود OpenRouter. استخدم Anthropic Messages أو Gemini فقط عندما يحتاج تطبيقك إلى حقول من تلك التنسيقات.
من LiteLLM إلى TokenLab
استخدم تكوين custom_openai/<model> الخاص بـ LiteLLM مع api_base: https://api.tokenlab.sh/v1. احتفظ باسم LiteLLM المستعار منفصلاً عن معرف نموذج TokenLab حتى يمكن تغيير أي منهما دون تعديل مطالبات (prompts) التطبيق.
رسائل Claude عبر TokenLab
وجه عملاء Anthropic SDK إلى https://api.tokenlab.sh وقم باستدعاء messages.create. لا تضف /v1 إلى عنوان URL الأساسي لـ SDK؛ حيث يمتلك SDK مسار /v1/messages الخاص به.
Gemini Native عبر TokenLab
احتفظ بحمولات Gemini على https://api.tokenlab.sh/v1beta/models/{model}:generateContent. يجب أن تظل حقول contents و parts والملفات والمحتويات المخزنة مؤقتاً وإعلانات الدوال والأدوات المدمجة الخاصة بـ Gemini على هذا المسار عندما يعتمد تطبيقك على سلوك Gemini.
الترحيل المتوافق مع 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.6-terra",
messages=[{"role": "user", "content": "Hello from TokenLab"}],
)يمكن عادةً الاحتفاظ بشيفرة إعادة المحاولة (retry) والمهلة (timeout) والبث (streaming) الحالية الخاصة بك. تأكد من معرف النموذج باستخدام GET /v1/models. يجب أن تتضمن طلبات الصور نموذجاً بشكل صريح؛ راجع دليل الصور للمدخلات الخاصة بكل نموذج.
ترحيل 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-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Reply with: Connected to TokenLab."}],
)استخدم /v1/messages لاستدعاءات أدوات Claude، وكتل التفكير (thinking blocks)، وحقول رسائل Anthropic. لا تضمن Chat Completions تلك الحقول.
ترحيل Gemini
curl "https://api.tokenlab.sh/v1beta/models/gemini-3.6-flash:generateContent" \
-H "Authorization: Bearer sk-your-tokenlab-key" \
-H "Content-Type: application/json" \
-d '{"contents":[{"parts":[{"text":"Hello"}]}]}'احتفظ بالأدوات المدمجة لـ Gemini، ومراجع File API، والمحتويات المخزنة مؤقتاً، وإعلانات الدوال، وأجزاء المحتوى الأصلية على /v1beta عندما يعتمد تطبيقك على سلوك Gemini الأصلي.
ترحيل الوسائط
- استعلم عن
GET /v1/models?recommended_for=image|video|music|3d. - اقرأ قائمة النماذج من
GET /v1/modelsوالتفاصيل الكاملة منGET /v1/models/{model}. - أرسل
modelصريحاً، خاصة لنقاط نهاية الصور. - قم بتخزين
task_idوpoll_urlونقطة النهاية والنموذج ومعرف الوظيفة الخاص بك للوظائف غير المتزامنة. قم باستطلاعها باستخدامGET /v1/tasks/{id}. - قم بمطابقة التكاليف من خلال سجلات الاستخدام و
billing_transaction_id، وليس معرفات مهام المزود.
يمكن أن ينتهي توليد الوسائط بشكل غير متزامن، لذا احفظ task_id و poll_url قبل استبدال التكامل الحالي. يجب ألا تؤدي مهلة طلب الإنشاء إلى إنشاء وظيفة مستخدم ثانية.
مخاطر الترحيل
- لا تضع كل نموذج خلف مسار OpenAI Chat Completions واحد إذا كان تطبيقك يحتاج إلى سلوك Anthropic أو Gemini أو Responses الأصلي.
- لا تفترض القيم الافتراضية القديمة للصور. أرسل
modelبشكل صريح. - لا تقم بإعادة محاولة طلبات الإنشاء غير المتزامنة دون التحقق مما إذا كانت المهمة قد تم إنشاؤها بالفعل.
- استخدم معرفات مهام TokenLab وسجلات الاستخدام في منتجك. معرفات مهام الطرف الثالث ليست معرفات فوترة.
مرجع API
| الموضوع | المرجع |
|---|---|
| Multi-Format API | Multi-Format API |
| OpenAI SDK | OpenAI SDK |
| Anthropic SDK | Anthropic SDK |
| Gemini Native | Gemini Native API |
| توليد الصور | Image Generation |
| الوظائف غير المتزامنة والاستطلاع | Async Jobs & Polling |