الأدلة الأساسية

أدلة الترحيل

انقل عملاء OpenAI و Anthropic و Gemini والوسائط الحاليين إلى TokenLab

حافظ على تنسيق الطلب الذي يستخدمه تطبيقك بالفعل. تمتلك كل من العملاء المتوافقة مع OpenAI، و Anthropic Messages، و Gemini REST، ونقاط نهاية الوسائط عنوان API مطابقاً في TokenLab.

تعيين API

API الحاليعنوان URL الأساسي لـ TokenLabنقطة النهايةملاحظات هامة
OpenAI Chat Completionshttps://api.tokenlab.sh/v1/chat/completionsأقل تغيير ممكن للدردشة المتوافقة مع OpenAI واستدعاء الدوال
OpenAI Responseshttps://api.tokenlab.sh/v1/responsesاستخدمه عندما يعتمد تطبيقك على مدخلات أو أدوات أو معالجة مخرجات خاصة بـ Responses
Anthropic SDKhttps://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/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 الأصلي.

ترحيل الوسائط

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

يمكن أن ينتهي توليد الوسائط بشكل غير متزامن، لذا احفظ task_id و poll_url قبل استبدال التكامل الحالي. يجب ألا تؤدي مهلة طلب الإنشاء إلى إنشاء وظيفة مستخدم ثانية.

مخاطر الترحيل

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

مرجع API

الموضوعالمرجع
Multi-Format APIMulti-Format API
OpenAI SDKOpenAI SDK
Anthropic SDKAnthropic SDK
Gemini NativeGemini Native API
توليد الصورImage Generation
الوظائف غير المتزامنة والاستطلاعAsync Jobs & Polling

في هذه الصفحة