OpenMotion لإنشاء الفيديو، أي جزء يتم توصيل مفتاح API به؟ إخراج الصور والتعليق الصوتي عبر واجهة متوافقة، واللقطات تحتاج إلى توصيل منفصل.

ملاحظة المؤلف: اعتمادًا على README وملاحظات الإصدار ووثائق مزوّد الخدمة، نفصل مراحل الإنتاج الخمس في OpenMotion، لنوضّح أي المراحل يمكن ربطها بمفتاح واحد متوافق مع OpenAI، وأي اللقطات التي يتعذّر ربطها فتُنتَج في الخارج ثم تُستورد.

عندما تبدأ في صناعة فيلمك الخاص باستخدام OpenMotion، وتمتلك مفتاح API جاهزًا، فإن أول ما يخطر ببال كثيرين هو لصقه في اتصال “متوافق مع OpenAI” داخل Model Settings، ثم توقّع أن يعمل توليد الصور والتعليق الصوتي واللقطات والموسيقى التصويرية كلها دفعة واحدة. لكن بحسب ما تكتبه وثائق المستودع، المفتاح المتوافق الواحد لا يقابل في OpenMotion سوى بروتوكولين: توليد الصور والتعليق الصوتي. أما تحويل الكلام إلى نص فهو واجهة ثالثة منفصلة، ولقطات الفيديو والموسيقى التصويرية ليست ضمن خانة “متوافق”.

هذا ليس مقالًا آخر عن شعبية المستودع، فالمقال لا يتخذ عدد النجوم دليلًا على شيء، بل يقارن README وملاحظات إصدار v0.1.1 ووثائق مزوّد الخدمة، ويتحقق فقرةً فقرة من أين يمكن أن يصل المفتاح. وكل وصف للقدرات مذكور مع مصدره، ولا يوجد فيه أي بند مبني على تجربة فعلية.

القيمة الأساسية: بعد قراءة هذا المقال ستستطيع بنفسك أن تحدد أي المراحل تُسلِمها إلى الواجهة المتوافقة، وأيها تُغيّر مزوّدها، وأيها تُنتِجها في الخارج أولًا ثم تستوردها إلى OpenMotion.

openmotion-api-key-image-narration-video-setup-ar-image-0


النقاط الأساسية لطريقة ربط المفاتيح في OpenMotion لإنتاج الفيديو

دعنا نضع الاستنتاجات في جدول واحد أولاً. عبارة “البروتوكول المتوقع” في الجدول مأخوذة من docs/provider-settings.md وcompatible.md في المستودع، وهي تمثّل ما نفّذه جانب OpenMotion، ولا تعني أن أي منصة تقدّم نقطة النهاية (endpoint) المقابلة.

مرحلة الإنتاج البروتوكول المتوقع في OpenMotion هل يمكن ربط المفتاح المتوافق مباشرةً الخطوة التالية عند تعذّر الربط
توليد الصور POST base مع /images/generations، يقرأ b64_json أو url نعم، بشرط أن تقدّم المنصة نقطة النهاية هذه اختر منصة توفّر نقطة نهاية لتوليد الصور
التعليق الصوتي POST base مع /audio/speech، يوضع input في جسم الطلب، ويجب أن يحتوي على voice، ويُرجع صوتًا ثنائيًا البروتوكول منفّذ، لكن يجب أن تمتلك المنصة نقطة النهاية هذه فعلاً بدّل إلى مزوّد يمتلك هذه النقطة، أو استورد صوتًا سجّلته بنفسك
الترجمة النصية POST base مع /audio/transcriptions، ويجب أن يتضمّن طوابع زمنية حقيقية إنها واجهة منفصلة، لا تُشترك مع التعليق الصوتي اكتبها يدويًا في Studio أو استورد ملف ترجمة
المشاهد يمرّ عبر fal.ai أو Atlas Cloud أو WaveSpeedAI أو OpenDesign Cloud لا أنشئ المقطع النهائي خارجيًا ثم استورده
الموسيقى التصويرية/المؤثرات الصوتية كما في المشاهد؛ البروتوكول المتوافق لا ينفّذ الموسيقى والمؤثرات الصوتية لا بدّل المزوّد، أو استورد ملفاتك الصوتية الخاصة

واجهات OpenMotion المتوافقة لا تُخرج إلا الصور والتعليق الصوتي

ملف docs/provider-settings.md في المستودع يقولها بصراحة: الاتصال المتوافق مع OpenAI يستطيع تنفيذ /images/generations و/audio/speech بصيغة ثنائية، والصوت يجب أن يحمل voice. أما Anthropic وGoogle Gemini فهما هنا مجرد إعدادات في الكتالوج، ولا يوجد محوّل وسائط عام، لذا حتى لو أدخلت مفتاح Claude أو Gemini فلن تظهر لك قدرة توليد صور أو دبلجة من العدم. أما الفيديو والموسيقى فمُسلَّمان بوضوح إلى fal.ai أو Atlas Cloud أو WaveSpeedAI أو OpenDesign Cloud.

ويضع compatible.md حدودًا للمحوّل المتوافق. توليد الصور يقتصر على تحويل النص إلى صورة، ولا يشمل تحرير الصور أو رفعها، ولا الفيديو غير المتزامن؛ والتعليق الصوتي يعيد ملفًا صوتيًا ثنائيًا، لكن بروتوكولات الموسيقى والمؤثرات الصوتية غير مُنفَّذة. ويضيف docs/model-gateway.md (الموسوم بتحديث 2026-11-15) ملاحظة: الاتصال العام المتوافق ينفّذ بروتوكول الصوت القياسي، وهذا لا يعني أن تلك الاتصالات تملك واجهات موسيقى أو مؤثرات صوتية قابلة للنقل. بعبارة أخرى، كلمة «متوافق» تتوقف عند الصوت.

لا تخلط بين قوائم الطرازات الثلاث في README الخاص بـ OpenMotion

يقدّم README ثلاث قوائم في مواضع مختلفة، ولكل منها غرض مختلف، ولا يصح دمجها في «جدول طرازات مدعومة من OpenMotion» واحد.

  • الأمثلة في البداية: يذكر توليد الصور وإضافة اللقطات والموسيقى التصويرية والتعليق الصوتي كمثال على GPT Image 2.6 وSeedance 2.5 وSuno وEleven v4، لتوضيح شكل سير العمل.
  • فقرة كتالوج fal.ai: بعد ربط fal.ai في Model Settings وتحديث الكتالوج، يمكنك العثور على GPT Image 2.6 وNano Banana 2.1 وFLUX.3 وSeedance 2.5 وKling 4.0 وWan 3.0 وEleven v4. هذا هو الكتالوج عبر fal.ai.
  • جدول القدرات: الصور هي Codex Image وNano Banana 2 via Atlas Cloud وFLUX Schnell via fal.ai؛ والفيديو هو Seedance 2.0 via Atlas Cloud وWan 2.2 via fal.ai؛ والموسيقى هي Suno v4 via Atlas Cloud؛ والصوت هو Kokoro via fal.ai.

هذه القوائم الثلاث تجيب عن ثلاثة أسئلة مختلفة: «مخطط سير العمل»، و«ما الموجود في كتالوج مزوّد معيّن»، و«طرق الربط المذكورة في الوثائق». فمجرد أن البداية تذكر Seedance 2.5 لا يعني أن مفتاحك المتوافق يستطيع إنتاج لقطات Seedance مباشرة داخل OpenMotion.

openmotion-api-key-image-narration-video-setup-ar-image-1


OpenMotion لإنشاء الفيديو: ربط مفاتيح API خطوة بخطوة

سنمشي هنا عبر الخطوات بالترتيب نفسه الذي تتبعه عند إنتاج الفيديو. في كل خطوة، نبدأ أولاً بما يتوقعه OpenMotion، ثم نتحقق مما إذا كانت المفاتيح المتوفرة لديك تلبي هذا التوقع.

الخطوة الأولى: إعداد بيئة OpenMotion المحلية

يسرد قسم التثبيت في README المتطلبات التالية، ويُنصح بالتأكد من اكتمال البيئة قبل ربط المفاتيح:

  1. Node.js 26.11.1: الإصدار المحدد صراحةً في README.
  2. التثبيت من المصدر هو الطريقة الافتراضية: تطبيق npm المنشور خيار اختياري، ويحذر README في نصه الأصلي بأن published versions can lag، أي أن الميزات الجديدة قد تتأخر في الوصول.
  3. Chrome أو Chromium، بالإضافة إلى FFmpeg: تعتمد عليهما المعاينة المحلية والتصدير.
  4. Docker Compose (اختياري): تشير ملاحظات إصدار v0.1.1 إلى إمكانية فتح Studio محلياً من المصدر باستخدام Docker Compose.

يوضح README أيضاً أن البرنامج نفسه لا يفرض اشتراكاً ولا يحسب رسوم عرض لكل مرة، بل يُحاسب كل مزود وفق حسابك الخاص. كما يمكنك تماماً عدم استدعاء واجهات التوليد والاكتفاء باستيراد مقاطع الفيديو والصور والصوت الخاصة بك مباشرةً، وهي نقطة ستُستخدم مراراً في المراحل التي لا يمكن ربطها لاحقاً.

الخطوة الثانية: ملء خانة توليد الصور في OpenMotion باتصال متوافق

توليد الصور هو الجزء الأكثر استقرارًا في المفاتيح المتوافقة. ولنأخذ APIYI مثالًا، فهي منصة تجميع نماذج متوافقة مع OpenAI، حيث يتيح مفتاح واحد استدعاء عدة نماذج رئيسية، كما أن نقطة نهاية توليد الصور فيها /v1/images/generations تتطابق تمامًا مع المسار الذي يطلبه محوّل توليد الصور في OpenMotion. وفي إعدادات النموذج (Model Settings) تُملأ الحقول على النحو التالي تقريبًا:

الحقل ما يُكتب فيه ملاحظة
نوع الاتصال متوافق مع OpenAI هذا النوع وحده هو الذي يمر عبر /images/generations
Base URL https://api.apiyi.com/v1 يلحق المحوّل /images/generations في نهاية العنوان
مفتاح API الرمز الذي تنشئه في لوحة تحكم المنصة انتبه إلى أن مجموعة الرمز يجب أن تضم مجموعة الطراز المختار
طراز الصور gpt-image-2.6-all أو gpt-image-2.6-flare أو gpt-image-2.6-sunburst يقابل GPT Image 2.6 الوارد في أمثلة ملف README
صيغة الاستجابة b64_json أو url يدعم المحوّل قراءة الصيغتين معًا

بعد إدخال البيانات، ولّد إطارًا ثابتًا واحدًا أولًا للتأكد من أن المسار يعمل بسلاسة. ولاحظ أن محوّل توليد الصور المتوافق في OpenMotion لا يدعم تحميل الصور لتعديلها، أي أن عملية «تعديل صورة موجودة» لا تعمل عبر هذا المسار؛ فكل ما يمكنك فعله هو إعادة التوليد أو استيراد صورة جاهزة عُدّلت خارجيًا.

🚀 بداية سريعة: يُنصح في قسم توليد الصور بتشغيل صورة واحدة أولًا باستخدام رصيد الاختبار المجاني المخصص للمستخدمين الجدد على APIYI apiyi.com، للتأكد من تطابق Base URL ومجموعة الرمز ومعرّف الطراز، ثم توليد اللقطات الثابتة للوحات القصة بالجملة.

الخطوة الثالثة: تأكيد نقاط النهاية أولاً لخانتي التعليق الصوتي والترجمة النصية في OpenMotion

خانة التعليق الصوتي تحتاج إلى /v1/audio/speech، وخانة الترجمة النصية تحتاج إلى /v1/audio/transcriptions، وهما واجهتان مختلفتان. ووفقًا لواجهة تسعير APIYI التي قرأناها بتاريخ 2026-11-20، فإن نقاط النهاية العامة المتاحة هي فقط /v1/messages و/v1/embeddings وGemini generateContent و/v1/images/generations و/v1/chat/completions و/v1/responses، ولا توجد بينها /v1/audio/speech ولا /v1/audio/transcriptions.

في الجدول الإجمالي، الطرازان tts-1 وtts-1-hd مكتوب عند نقطة النهاية الخاصة بهما chat فقط، بينما يرسل محوّل التعليق الصوتي في OpenMotion طلبات إلى /audio/speech. لذلك لا يمكنك أن تضع معرّفي هذين الطرازين في خانة التعليق الصوتي وتتوقع أن يصدر صوت. أمام هذا الجزء مسارَان: إما الانتقال إلى مزوّد آخر يوفّر فعلاً /audio/speech ويدعم معامل voice، أو تسجيل الصوت بنفسك واستيراده مباشرة.

أما الترجمة النصية فهي أسهل في الإصدار v0.1.1. تذكر ملاحظات الإصدار أنه يمكنك داخل Studio توليد الترجمة النصية أو استيرادها أو كتابتها يدويًا، ثم تصديرها بصيغة SRT أو VTT. ويحذّر قسم الترجمة النصية في compatible.md (تاريخ المراجعة 2026-11-17) من أنه لا يمكن تصدير SRT أو VTT إلا بعد الحصول على طوابع زمنية حقيقية، فالنص وحده لا يكفي لبناء خط زمني. وعند غياب نقطة نهاية للنسخ الصوتي، تكون كتابة ملف ترجمة نصية يحمل طوابع زمنية يدويًا أو استيراده هي الطريقة الأكثر مباشرة.

الخطوة الرابعة: إنشاء لقطات OpenMotion خارجيًا ثم استيرادها

لا يمكن وضع مقطع اللقطة في الفتحة المتوافقة. وحتى إذا أنشأت اللقطات مباشرةً داخل OpenMotion، فسيظل عليك المرور عبر fal.ai أو Atlas Cloud أو WaveSpeedAI؛ وإذا كانت أرصدة الفيديو لديك في منصة أخرى، فأنشئ المقطع النهائي هناك ثم استورد الملف إلى Studio. كما أن تصدير مقطع MP4 المفرد الجديد في v0.1.1 يسهّل فحص المقاطع التي استُبدلت لقطاتها على حدة. وسنشرح تحديدًا كيفية إنشاء Seedance 2.5 خارجيًا في القسم التالي.

openmotion-api-key-image-narration-video-setup-ar-image-2


كيف تطابق أسماء نماذج توليد الصور في OpenMotion مع أسعارها

أكثر ما يُوقعك في الخطأ عند التحقق من أسماء النماذج ومطابقة الأسعار هو خلط الأرقام الواردة في صفحات مختلفة في سعر واحد. فيما يلي نعرضها حسب المصادر الثلاثة في APIYI، مع تدوين تاريخ القراءة في رأس الجدول، وعند اختلاف موضعين نُبقي الموضعين كما هما.

معرّف النموذج الجدول الإجمالي (وقت البيانات 2026-11-19 10:59) واجهة التسعير (قُرئت في 2026-11-20) صفحة الشرح
gpt-image-2.6-all لكل مرة 0.025 دولار/مرة؛ نقاط النهاية chat وimages؛ المجموعات Default وimage2_OSS وSVIP model_price 0.025؛ نقاط النهاية image-generation وopenai صفحة الشرح تذكر gpt-image-2-all بسعر 0.025 دولار/صورة، وليس 2.6
gpt-image-2.6-flare لكل مرة 0.2 دولار/مرة؛ نقاط النهاية مكتوب فيها images فقط؛ المجموعات Default وimage2Enterprise وimage2_OSS وSVIP model_price 0.2، ومعها billing_expr (p * 5 + cr * 1.25 + img * 8 + img_cr * 2 + c * 30)؛ نقاط النهاية image-generation وopenai التحويل الرسمي حسب التوكن: إدخال نصي 5، إدخال صور 8، إخراج صور 30 دولار/مليون توكن؛ قراءة من الذاكرة المؤقتة: نص 1.25، صور 2 دولار
gpt-image-2.6-sunburst نفس flare: لكل مرة 0.2 دولار/مرة، ونقاط النهاية مكتوب فيها images فقط نفس flare كما سبق، حسب التوكن

كما ترى، الجدول الإجمالي يكتب flare وsunburst بسعر 0.2 دولار لكل مرة وبنقاط نهاية images فقط، بينما واجهة التسعير تعلّق إلى جانب 0.2 معادلة تسعير حسب التوكن، وتضيف نقطة النهاية openai. أما صفحة الشرح فتُدرج سعر التحويل الرسمي حسب التوكن، وتوضح أن التحويل الرسمي من النص إلى الصورة يمر عبر /v1/images/generations ويعيد b64_json. هذه المواضع ليست متطابقة تمامًا، ولن ندمجها في سعر واحد هنا؛ والمرجع في الخصم الفعلي هو قائمة النماذج في لوحة تحكم apiyi.com عند إنشاء الطلب.

أما بالنسبة لخانة توليد الصور في OpenMotion، فالمعلومة الجوهرية هي نقطة النهاية: نقاط نهاية الصور في النماذج الثلاثة كلها تطابق /images/generations، وصيغة الإرجاع هي b64_json التي يستطيع المحوّل قراءتها.

وفي ما يخص الموسيقى التصويرية والتعليق الصوتي، فإن Suno وEleven v4 المذكورين في أمثلة README لا يظهران في الجدول الإجمالي بتاريخ 2026-11-19 ولا في واجهة التسعير بتاريخ 2026-11-20، كما لا يظهر whisper في الجدول الإجمالي. Suno وEleven v4 غير متاحين على المنصة حاليًا، وسنعمل على إتاحة هذا النموذج في أقرب وقت؛ والأسماء والأسعار تُعتمد وفق قائمة النماذج في المنصة.

openmotion-api-key-image-narration-video-setup-ar-image-3

قسم اللقطات في OpenMotion: لماذا لا يُدرج Seedance 2.5 في خانة التوافق

معرّف الطراز الخاص بـ Seedance 2.5 في APIYI هو doubao-seedance-2-5-260628. عدم إدراجه في خانة التوافق في OpenMotion له سببان: فمحوّل التوافق في OpenMotion لا يتعامل أصلًا مع الفيديو غير المتزامن، كما أن doubao-seedance-2-5-260628 يستخدم في APIYI واجهة المهام الخاصة به، وليس واجهة الفيديو المتوافقة.

العنصر الجدول العام (2026-11-19) واجهة التسعير (2026-11-20) صفحة شرح Seedance2
نقطة النهاية chat فقط openai فقط (أي chat) POST /seedance/api/v3/contents/generations/tasks
المجموعة SeeDance2 SeeDance2 فقط؛ ومضاعفات مجموعات SeeDance2 وSD2Fast وSD2Mini كلها 0.18 يجب تحديد SeeDance2 في الرمز المميز، والمضاعف 0.18x
صيغة السعر حسب الاستخدام: الإدخال 70، الإخراج 70 دولارًا/مليون token، وقراءة التخزين المؤقت بلا بيانات الطراز نفسه، ويُحسب وفق مضاعف المجموعة مثال 720p و5 ثوانٍ وبدون فيديو إدخال = 1.3721 دولار
نمط الفوترة حسب الاستخدام حسب الاستخدام حسب الاستخدام (بأولوية) أو حسب الاستخدام

لا تخلط بين هذين الرقمين. سعر 70 دولارًا/مليون token في الجدول العام هو السعر المعلن؛ أما 1.3721 دولار في صفحة الشرح فهو مثال محدد طُبّق عليه مضاعف مجموعة SeeDance2 البالغ 0.18. وضرب السعر المعلن في الجدول العام بـ 0.18 يعطي 12.60 دولارًا/مليون token، ثم بضرب ذلك في 108900 token المستخدمة في مثال صفحة الشرح نحصل على نحو 1.37 دولار، وهو ما يطابق ذلك المثال تمامًا. لذا فإنهما يصفان مستويين من منظومة الفوترة نفسها، وليسا سعرين يمكن الاختيار بينهما.

توجد أيضًا فروق في أسماء المجموعات: الجدول العام يكتب fast وmini باسمَي SD2-Fast-Cheap وSD2-Mini-Cheap، بينما تسميهما واجهة التسعير SD2Fast وSD2Mini. عند إنشاء الرمز المميز، اعتمد على اسم المجموعة الذي تعرضه لوحة التحكم فعليًا، ولا تملأه حرفيًا تبعًا لاسم وارد في صفحة ما.

أما في سير إنتاج الفيديو: أرسل أولاً مهمة اللقطة عبر واجهة مهام Seedance في APIYI، وبعد اكتمال المهمة نزّل الفيديو النهائي، ثم استورد ملف الفيديو إلى الخط الزمني في OpenMotion، وقم بمونتاجه مع الإطارات الثابتة التي تولّدها الواجهة المتوافقة، والتعليقات الصوتية المسجلة خارجيًا.

💡 نصيحة للاختيار: إذا كنت تريد إدارة حصة اللقطات وحصة توليد الصور تحت مفتاح API نفسه، يمكنك في APIYI apiyi.com تحديد مجموعة توليد الصور ومجموعة SeeDance2 معًا للرمز المميز؛ تُدخل إعدادات توليد الصور في OpenMotion، وتُولّد اللقطات عبر واجهة المهام ثم تُستورد، وستكون الفاتورة قابلة للمطابقة بوضوح من لوحة تحكم واحدة.


الأسئلة الشائعة FAQ

Q1: ما هو OpenMotion؟

OpenMotion هو Studio مفتوح المصدر لإنتاج الفيديو، أصدرته nexu-io برخصة Apache-2.0، وأُنشأ المستودع بتاريخ 2026-05-11. يذكر وصف المستودع أنه يدعم 22 وكيلًا (agent)، ويسمّي Claude Code وCodex وDSH وWorkBuddy. ووفقًا لملف README، لا يفرض البرنامج نفسه رسوم اشتراك أو رسوم عرض، أما واجهات التوليد فتُحتسب عبر حساب المزوّد الخاص بك.

Q2: ما الفرق بين الواجهات المتوافقة في OpenMotion وكل من fal.ai وAtlas Cloud؟

الواجهات المتوافقة في OpenMotion تنفّذ فقط بروتوكولي `/images/generations` و`/audio/speech`، أما الترجمات النصية فتسلك مسارًا مختلفًا هو `/audio/transcriptions`. في المقابل، فإن fal.ai وAtlas Cloud وWaveSpeedAI وOpenDesign Cloud هي القنوات المخصّصة للفيديو والموسيقى وفق الوثائق. وإذا أردت توليد اللقطات مباشرة داخل Studio، فلا سبيل إلا عبر هذه الشركات الأخيرة.

Q3: متى صدر OpenMotion v0.1.1، وما الذي تغيّر فيه؟

صدر v0.1.1 في 2026-11-18 الساعة 19:32 (بتوقيت بكين). ووفق ملاحظات الإصدار: أصبحت الترجمات النصية قابلة للتوليد أو الاستيراد أو الكتابة يدويًا، وتصديرها بصيغة SRT أو VTT؛ ويمكن تصدير مقطع MP4 واحد على حدة؛ وأُضافت 96 مهارة (Skill)؛ ودعم فتح Studio محليًا من الكود المصدري عبر Docker Compose؛ وإضافة اختيارية على شكل DeepSeek Harness plugin تضع Studio بجانب المحادثة. هذه المعلومات كلها مأخوذة من ملاحظات الإصدار وليست نتائج تجربة فعلية.

Q4: هل يمكن وضع tts-1 في خانة السرد الصوتي في OpenMotion؟

لا يمكن فعل ذلك مباشرة. خانة السرد الصوتي ترسل طلبًا إلى `/v1/audio/speech`، ويجب أن يحمل `voice`، ويعيد صوتًا بصيغة ثنائية؛ بينما يذكر جدول APIYI الإجمالي أن نقطة نهاية `tts-1` و`tts-1-hd` مكتوب لها chat فقط، وأن نقاط النهاية العامة في واجهة التسعير لا تشمل `/v1/audio/speech`. لذا يُنصح للسرد الصوتي بالانتقال إلى مزوّد آخر يوفّر نقطة النهاية هذه، أو بتسجيل الصوت واستيراده.

Q5: كيف أربط OpenMotion بتوليد الصور عبر API بسرعة؟

الخطوات قصيرة:

1. سجّل في APIYI على apiyi.com واحصل على رصيد اختبار مجاني.
2. أنشئ توكن، واختر مجموعة تضم المجموعة التي ينتمي إليها نموذج الصور الذي ستستخدمه، مثل Default.
3. في OpenMotion Model Settings، أنشئ اتصالًا متوافقًا مع OpenAI، واملأ Base URL بـ `https://api.apiyi.com/v1`، واملأ حقل النموذج بمعرّف متاح مثل `gpt-image-2.6-all`.
4. ولّد صورة ثابتة واحدة للتحقق، فسيقرأ المحوّل `b64_json` أو `url` من الاستجابة.

Q6: كيف أضع اللقطات المولّدة بواسطة Seedance 2.5 في OpenMotion؟

استخدم `doubao-seedance-2-5-260628` لإرسال المهمة عبر واجهة المهام `POST /seedance/api/v3/contents/generations/tasks`، مع تفعيل توكن مجموعة SeeDance2. بعد اكتمال المهمة، نزّل ملف الفيديو، ثم ضعه على الخط الزمني في OpenMotion عبر استيراد المواد. أما السعر فيُقرأ في مكانين منفصلين: السعر المعلن في الجدول الإجمالي هو 70 دولارًا لكل مليون توكن إدخال وإخراج، بينما المثال في صفحة التوضيح لدقة 720p ومدة 5 ثوانٍ فهو 1.3721 دولارًا بعد التحويل.

س7: ما القيود المعروفة في طريقة الربط هذه؟

– **توليد الصور**: المحوّل المتوافق لا يدعم رفع الصور للتعديل، ويعمل فقط في تحويل النص إلى صورة.
– **التعليق الصوتي والترجمة النصية**: بروتوكول OpenMotion مُنفَّذ بالفعل، لكن يلزم أن توفّر المنصة فعليًا `/audio/speech` و`/audio/transcriptions`؛ وبلا طوابع زمنية حقيقية للترجمة النصية لا يمكن تصدير SRT أو VTT.
– **الموسيقى التصويرية والمؤثرات الصوتية**: البروتوكول المتوافق غير مُنفَّذ، ولا سبيل إلا عبر fal.ai أو Atlas Cloud أو WaveSpeedAI أو OpenDesign Cloud، أو استيراد ملفاتك الصوتية.
– **معايير الأسعار**: الجدول الإجمالي وواجهة التسعير وصفحة الشرح لا تكتب السعر للنموذج الواحد بالصيغة نفسها تمامًا، فاعتمد قائمة النماذج في المنصة قبل الطلب.


أبرز النقاط حول ربط مفاتيح API لإنشاء الفيديو عبر OpenMotion

  • فتحات التوافق تعترف ببروتوكولين فقط: توليد الصور عبر /images/generations والتعليق الصوتي عبر /audio/speech، أما الترجمة النصية فهي الواجهة الثالثة.
  • المشاهد والموسيقى التصويرية لا تدخل فتحات التوافق: التوليد داخل Studio يجري عبر fal.ai أو Atlas Cloud أو WaveSpeedAI أو OpenDesign Cloud.
  • لا تدمج قوائم README الثلاث: الأمثلة في المقدمة، ودليل fal.ai، وجدول القدرات، لكلٍّ منها غرضه الخاص.
  • هناك نماذج جاهزة ومتاحة لتوليد الصور: gpt-image-2.6-all وgpt-image-2.6-flare وgpt-image-2.6-sunburst كلها متوافقة مع نقطة نهاية الصور.
  • انظر إلى الأسعار منفصلة حسب مصدرها: الجدول الإجمالي يحسب بالمرة، وواجهة التسعير تأتي بصيغة حسابية، وصفحة الشرح تعتمد على token، فلا تدمجها في سعر واحد.
  • إن تعذّر الربط، ولّد خارجيًا ثم استورد: Seedance 2.5 ينتج الفيديو عبر واجهة المهام، نزّله ثم استورده إلى الخط الزمني.
  • ابدأ بتجربة صورة واحدة: استخدم الحصة المجانية من APIYI للتحقق من Base URL ومجموعة المفتاح، ثم توسّع إلى بقية المراحل.

الخلاصة

لإنتاج فيلم خاص بك باستخدام OpenMotion، يمكن تلخيص طريقة ربط المفاتيح في ثلاث نقاط:

  1. توليد الصور عبر الواجهات المتوافقة: وجّه Base URL إلى المنصة التي توفر /images/generations، ثم أدخل معرّف طراز GPT Image 2.6 في الإعدادات.
  2. تحقق من نقاط النهاية للتعليق الصوتي والترجمة أولاً: بروتوكول OpenMotion يدعم ذلك، لكن إذا كانت المنصة لا توفر /audio/speech و/audio/transcriptions، فاستبدل المزود أو اكتبها يدويًا أو استوردها.
  3. اللقطات والموسيقى التصويرية تُربط بشكل منفصل: بعد توليد النسخة النهائية خارجيًا، استوردها، أو اربط fal.ai وAtlas Cloud وWaveSpeedAI داخل Studio.

قبل أن تبدأ، اسرد الواجهات المقابلة لكل مرحلة وفق جدول الأقسام في هذا المقال، فهذا أسهل بكثير من ملء المفاتيح دفعة واحدة ثم تتبع الأخطاء. في مرحلتي توليد الصور ولقطات Seedance، يمكنك إدارة الأمرين باستخدام رمز واحد على APIYI عبر apiyi.com. جرّب أولاً الحصة المجانية للتحقق من سلسلة الاتصال، ثم قرر توزيع الأدوار لإنتاج الفيلم النهائي.


📚 المراجع

  1. مستودع OpenMotion و README: متطلبات التثبيت، وقوائم الطرازات الثلاث، وتفاصيل الفوترة

    • الرابط: github.com/nexu-io/openmotion
    • ملاحظة: تمت القراءة من فرع main في 2026-11-20، ويشمل إصدار Node.js واعتماديات Chrome وFFmpeg
  2. ملاحظات إصدار OpenMotion v0.1.1: تحديثات الترجمة والتصدير المقطعي وDocker Compose وغيرها

    • الرابط: github.com/nexu-io/openmotion/releases/tag/v0.1.1
    • ملاحظة: صدر في 2026-11-18، ووصف إمكانات الإصدار في هذا المقال مستند إلى هذه الصفحة
  3. وثائق مزود OpenMotion: الحدود البروتوكولية التي يمكن تنفيذها عبر الواجهات المتوافقة

    • الرابط: github.com/nexu-io/openmotion/blob/main/docs/provider-settings.md
    • ملاحظة: يضيف كل من docs/model-gateway.md في الدليل نفسه وskills/openmotion-media/references/providers/compatible.md تفاصيل الواجهات الثلاث لتوليد الصور والصوت والترجمة
  4. جدول طرازات APIYI وصفحة شرح الإمكانات وواجهة التسعير: معرّفات الطرازات ونقاط النهاية والمجموعات والأسعار

    • الرابط: docs.apiyi.com/models.md
    • ملاحظة: الصفحتان /api-capabilities/gpt-image-2/overview.md و/api-capabilities/seedance2/overview.md على الموقع نفسه هما صفحتا شرح؛ مسار واجهة التسعير هو /api/pricing تحت النطاق الفرعي api، وpricing_version هو shell-api-modelmak-v1

المؤلف: فريق APIYI التقني
التواصل التقني: إذا واجهت أثناء التكامل مشكلة في عدم تطابق الطراز أو المجموعة أو نقطة النهاية، يسعدنا تواصلك معنا عبر الصفحة الرئيسية لموقع APIYI الرسمي

أضف تعليق