> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# أدلة الهجرة

> نقل أحمال العمل من OpenAI وAnthropic وGemini ووسائط الإعلام إلى TokenLab مع تغييرات صغيرة وآمنة للإنتاج.

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

## تخطيط المسار

| عبء العمل الحالي     | عنوان 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

```python theme={null}
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

```python theme={null}
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

```bash theme={null}
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 متعدد التنسيقات](/ar/guides/api-formats)                     |
| SDK من OpenAI                    | [SDK من OpenAI](/ar/integrations/openai-sdk)                      |
| SDK من Anthropic                 | [SDK من Anthropic](/ar/integrations/anthropic-sdk)                |
| Gemini Native                    | [API من Gemini Native](/ar/api-reference/gemini/generate-content) |
| توليد الصور                      | [توليد الصور](/ar/guides/image-generation)                        |
| الوظائف غير المتزامنة والاستطلاع | [الوظائف غير المتزامنة والاستطلاع](/ar/guides/async-jobs-polling) |