<!-- Canonical URL: https://ask.atlascloud.ai/ar/migrate-sora-api-app-to-seedance-or-wan -->

# كيف تنقل تطبيق فيديو من Sora API إلى Seedance أو Wan؟

> انقل Sora إلى Seedance أو Wan بفصل عقد مهمة الفيديو الداخلي الثابت عن payload الخاص بالمزود. اربط prompt والمدخلات والمدة والحجم والصوت والحالة عبر adapter، واحفظ كل معرّف خارجي، وقارن النتائج المقبولة على مجموعة انحدار ثابتة قبل تحويل الحركة.

<!-- Canonical URL: https://ask.atlascloud.ai/migrate-sora-api-app-to-seedance-or-wan -->

# كيف تنقل تطبيق فيديو من Sora API إلى Seedance أو Wan؟

يغير النقل الأكثر أمانًا adapter المزود، لا بقية المنتج. احتفظ بعقد مهمة فيديو داخلي واحد لprompt ووسائط المصدر والمدة والاتجاه والصوت والتسليم، ثم حوّله عند الحد إلى طلبات Sora أو Seedance أو Wan.

لا تستبدل `sora-2` باسم آخر وترسل payload نفسه. تشترك APIs في نمط المهام غير المتزامنة، لكنها تختلف في endpoints وتنسيق الطلب والقيم وحقول الوسائط واستجابات الحالة.

## احصر سلوك Sora الذي يعتمد عليه التطبيق

توثق [مرجعية Videos API](https://platform.openai.com/docs/api-reference/videos) الحالية من OpenAI إنشاء المهمة عبر `POST /v1/videos` وجلب الحالة حسب المعرّف وحقول `prompt` و`input_reference` و`model` و`seconds` و`size`. قد يعتمد التطبيق أيضًا على remix أو التنزيل أو كائنات SDK أو أخطاء OpenAI.

سجل الاعتماد الفعلي قبل كتابة البديل:

| الاعتماد | السؤال |
|---|---|
| النموذج | هل يرتبط الكود بـ `sora-2` أو `sora-2-pro`؟ |
| الإدخال | نص أم صورة مرجع واحدة أم فيديو موجود؟ |
| المدة | ما القيم المستخدمة في الإنتاج؟ |
| الحجم | هل تحفظ الواجهة pixel أم النسبة أم preset؟ |
| الصوت | هل يعد المنتج بصوت مولد أم يستبدله لاحقًا؟ |
| الحالة | كيف تُربط حالات المزود بالحالة المحلية؟ |
| الناتج | هل يُبث أو يُنزل أو يُنسخ أو يُشار إليه بعنوان؟ |
| الفشل | ما الأخطاء التي تعاد أو تظهر أو تُصعّد؟ |

يكشف الحصر إن كان النقل تغيير نموذج أو workflow أو كليهما.

## عرّف مهمة فيديو محايدة للمزود

أنشئ كائنًا داخليًا يعبر عن قصد المنتج دون افتراض أن كل مزود يدعم الضوابط نفسها.

```json
{
  "job_id": "vid_01J...",
  "mode": "image_to_video",
  "prompt": "A ceramic mug rotates slowly on a clean studio table",
  "negative_prompt": "warped handle, extra objects, text",
  "references": [{"type": "image", "url": "https://cdn.example/mug.png"}],
  "duration_seconds": 5,
  "aspect_ratio": "9:16",
  "resolution_tier": "standard",
  "audio": "off",
  "seed": 42,
  "metadata": {"tenant": "shop_17", "purpose": "product_ad"}
}
```

صنّف القدرات إلى مطلوبة ومفضلة واختيارية. حذف المرجع المطلوب بصمت خطأ في المنتج. يمكن للadapter حذف seed لمسار لا يدعمه، لكنه يسجل القرار.

## اربط القصد لا أسماء الحقول

تستخدم Sora أبعاد pixel عبر `size`. قد تعرض Seedance `ratio` و`resolution` و`duration` ومصفوفات المراجع والصوت. قد تستخدم Wan `size` أو `ratio` وتعرض توسيع prompt أو نوع اللقطة أو المرجع أو التحرير.

| قصد المنتج | مثال Sora | ربط Seedance أو Wan |
|---|---|---|
| النموذج | `sora-2` | معرّف Atlas الفعلي الدقيق |
| الإرسال | `POST /v1/videos` | `POST /api/v1/model/generateVideo` |
| Prompt | `prompt` | عادة `prompt` |
| المرجع | `input_reference` | `image` أو `reference_images` حسب المسار |
| المدة | `seconds` | `duration` ونطاق حسب المسار |
| الإطار | `size` | `ratio` أو `size` أو دقة ونسبة |
| الصوت | سلوك النموذج | `generate_audio` أو إدخال صوت حسب المسار |
| مفتاح النتيجة | معرّف الفيديو | Prediction ID من الاستجابة |
| الحالة | Endpoint حالة الفيديو | `GET /api/v1/model/prediction/{id}` |

هذا checklist وليس schema للطلب. خذ القيم الدقيقة من صفحة النموذج الفعلية التي تختارها.

## اختر مسار Seedance بقصد

Seedance عائلة وليست endpoint واحدة قابلة للتبديل. يوثق Atlas Cloud تدفقات نصوص وصور ومراجع. تستقبل [Seedance 2.0 Fast reference-to-video](https://www.atlascloud.ai/models/bytedance/seedance-2.0-fast/reference-to-video?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=migrate-sora-api-app-to-seedance-or-wan) وسائط مرجعية وتعرض ضوابط للمدة والدقة والنسبة وbitrate والصوت.

فكر في Seedance من أجل:

* مقاطع سمعية بصرية قصيرة؛
* توجيه الموضوع أو النمط أو المشهد بالمرجع؛
* تنسيقات اجتماعية وإعلانية؛
* الاختيار بين التكرار السريع والجودة الأعلى.

لا تفترض أن كل إصدار يقبل المدخلات نفسها. اختر المسار حسب mode وتحقق من المهمة بschema قبل الإرسال.

## اختر مسار Wan بقصد

يقدم Wan أجيالًا ومسارات تحرير متعددة. تشمل [صفحات Wan في Atlas Cloud](https://www.atlascloud.ai/models/wan-3.0?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=migrate-sora-api-app-to-seedance-or-wan) Wan 3.0 والإصدارات السابقة، بينما تحدد endpoints الفردية text-to-video وimage-to-video والمرجع وvideo-edit.

فكر في Wan من أجل:

* اختيار واسع للتوليد والتحرير؛
* توسيع prompt أو ضبط اللقطة على المسارات المدعومة؛
* تدفقات المرجع أو الفيديو المصدر؛
* عائلة ثانية لتوجيه الجودة أو التوفر.

اختر endpoint دقيقًا واحدًا للنقل الأول. يتحول adapter عام باسم `wan` إلى مجموعة شروط خفية يصعب اختبارها.

## نفذ adapters صريحة

ضع التحقق قرب adapter. يوضح هذا المثال المبسط الحد دون اختراع حقول المسار.

```python
def to_atlas_payload(job, route):
    payload = {
        "model": route.model_id,
        "prompt": job["prompt"],
    }

    if job.get("duration_seconds") is not None:
        payload[route.duration_field] = route.map_duration(job["duration_seconds"])

    if job.get("aspect_ratio"):
        route.apply_frame_shape(payload, job["aspect_ratio"], job.get("resolution_tier"))

    if job.get("references"):
        route.apply_references(payload, job["references"])

    if job.get("audio") != "unspecified":
        route.apply_audio(payload, job["audio"])

    route.validate(payload)
    return payload
```

يجب أن يرفض إعداد المسار المتطلبات غير المدعومة. لا يقصر 12 ثانية إلى 5، ولا يحول الأفقي إلى العمودي، ولا يهمل المرجع بصمت.

احفظ المهمة الداخلية وpayload الفعلي لتعيد إنتاج تراجع الجودة أو مشكلة الفوترة.

## حافظ على أمان المهام غير المتزامنة

يعيد Atlas Cloud prediction ID ويوثق دورة الحياة في [دليل Predictions](https://www.atlascloud.ai/docs/en/predictions?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=migrate-sora-api-app-to-seedance-or-wan). استخدم حالات محلية دائمة بدل نشر حالات المزود في التطبيق.

| الحالة المحلية | المعنى |
|---|---|
| `ready` | تحقق منها ولم تُرسل |
| `submitted` | حُفظ المعرّف الخارجي |
| `processing` | المزود يعالج |
| `succeeded` | جُلبت metadata الناتج |
| `failed` | أعاد المزود خطأ نهائيًا |
| `rejected` | اكتملت ولم تجتز الجودة |

أنشئ idempotency key قبل الإرسال. احفظ المزود والمسار وhash الpayload والمعرّف الخارجي في سجل دائم واحد. إذا فقد worker الاتصال بعد الإرسال، يفحص السجل قبل إنشاء طلب مدفوع آخر.

استخدم polling بفاصل متزايد وjitter. الاستعلام المتكرر لا يسرع الفيديو.

## أنشئ مجموعة انحدار للنقل

استخدم 20 إلى 50 مهمة ممثلة للحركة الحقيقية، بما فيها الحالات الصعبة. حافظ على الأصول وقصد المنتج بين المزودين.

قيّم:

* الالتزام بprompt؛
* اتساق الموضوع والمنتج؛
* استقرار الحركة؛
* الاستمرارية الزمنية؛
* دقة المرجع؛
* الملاءمة السمعية البصرية؛
* ملاءمة القص والدقة؛
* قابلية تحرير أول وآخر إطار؛
* توزيع وقت الإكمال؛
* تكلفة الناتج المقبول.

لا تقارن مقطعًا استعراضيًا واحدًا. قد تجعل العشوائية مزودًا يبدو أفضل أو أسوأ من الواقع. كرر عندما يسمح المنتج بذلك.

## انشر بخطة حركة قابلة للتراجع

انتقل على مراحل.

1. أعد تشغيل prompt غير الحساسة offline.
2. شغّل مهام shadow لا تصل إلى المستخدم.
3. أرسل نسبة canary صغيرة لمسار جديد.
4. قارن الأخطاء والوقت والقبول والتكلفة.
5. زد النسبة عند ثبات الحدود فقط.
6. احتفظ بadapter Sora حتى لا تحتاج rollback.

حدد ما إذا كان المستخدم يرى اسم المزود. إذا اختلفت النماذج كثيرًا فقد يكون الاختيار صريحًا ومفيدًا. إذا كان المنتج يبيع capability فوجه فقط بين خيارات تحقق عقد القبول نفسه.

## الخلاصة

انقل Sora إلى Seedance أو Wan مع الحفاظ على مهمة فيديو محايدة وتبديل adapter فقط. اربط القدرات صراحة، واختر endpoint حقيقيًا في Atlas، واحفظ كل prediction ID، وارفض المتطلبات غير المدعومة، وقارن تكلفة الناتج المقبول بمجموعة ثابتة.

Seedance وWan ليسا بديلين يعملان بمجرد تغيير اسم النموذج. يصبحان آمنين عندما تظل schema المزود تفصيلًا تنفيذيًا ويظل النقل قابلًا للتراجع.

## FAQ

### هل يمكن تغيير اسم نموذج Sora فقط والإبقاء على request body نفسه؟

لا. تستخدم Sora وSeedance وWan معرّفات نماذج وendpoints وحقولًا وقيمًا ومدخلات وسائط مختلفة. احتفظ بschema المهمة الداخلي واكتب adapter لكل مسار.

### ما أكبر عنصر معماري مشترك بين هذه API؟

توليد الفيديو غير متزامن. يرسل التطبيق المهمة ويحفظ المعرّف الخارجي ويتحقق من الحالة لاحقًا ولا يجلب النتيجة إلا بعد الاكتمال.

### ما الحقول التي يجب ربطها صراحة؟

اربط معرّف النموذج وprompt ووسائط المرجع والمدة والنسبة أو الحجم والدقة والصوت وseed وسلوك السلامة وحالة المزود. لا تتجاهل الحقول غير المدعومة بصمت.

### هل أختار Seedance أم Wan؟

اختبر كليهما بمهام التطبيق الفعلية. يتميز Seedance بالفيديو القصير المعتمد على المراجع والمهام السمعية البصرية، بينما يقدم Wan مسارات نص وصورة ومرجع وتحرير متعددة. احكم بالنتائج المقبولة.

### كيف أمنع تكرار المهام المدفوعة أثناء النقل؟

أنشئ مفتاح idempotency داخليًا، واحفظ معرّف المزود فور الإرسال، وافحص المهمة الموجودة قبل الإعادة. عدم اليقين في الشبكة لا ينبغي أن يؤدي إلى إعادة إرسال عمياء.

### ما مقدار الحركة الذي ينبغي نقله أولًا؟

ابدأ بطلبات انحدار offline، ثم استخدم نسبة shadow أو canary صغيرة. زدها فقط عندما تبقى نسب القبول والأخطاء ووقت الإكمال والتكلفة ضمن الحدود.