توليد فيديو
POST /public/v1/generate-videoيولد فيديو بأحد مزودي الفيديو بالذكاء الاصطناعي في شارك ويحفظه في مكتبة الوسائط.
والاستجابة هي صف الوسائط نفسه الذي يعيده الرفع، فيوضع مباشرة في مصفوفة image الخاصة
بالمنشور.
إن كنت تفعل ذلك من التطبيق، فراجع صور وفيديو بالذكاء الاصطناعي. وهذه
العملية متاحة أيضًا بالأداة generateVideoTool في خادم
MCP من شارك، وهي تبدأ إنشاء الفيديو وتعود فورًا بدل الانتظار، ولا يقابلها أمر في أداة CLI.
جسم الطلب
Section titled “جسم الطلب”| الحقل | مطلوب | الوصف |
|---|---|---|
type |
نعم | مزود الفيديو المستخدم. حاليًا veo3 أو image-text-slides. |
output |
نعم | vertical أو horizontal. وأي شيء آخر يرفض. |
customParams |
لا | خيارات خاصة بالمزود، بالشكل الذي يحدده مخطط المزود نفسه. |
المزودون المتاحون
Section titled “المزودون المتاحون”يتوفر اثنان، وقد تم التحقق من ذلك مقابل الإنتاج في 2026-08-24:
type |
ما الذي ينتجه | يعمل في الفترة التجريبية |
|---|---|---|
veo3 |
لقطة واحدة متصلة نحو 8 ثوانٍ، بدقة 1080p، بحركة كاميرا حقيقية، بلا قطعات وبلا نص مقروء. وصوت اختياري: صامت أو محيطي أو منطوق، وحتى 3 صور مرجعية. الأنسب للحظة واحدة نابضة. | لا |
image-text-slides |
عرض شرائح من 1 إلى 6 صور ثابتة مولدة بالذكاء الاصطناعي، تعرض كل واحدة بينما يقرؤها راوٍ، مع نص الشرح مطبوعًا على الصورة نفسها. ونحو 10 إلى 55 ثانية من التعليق الصوتي. الأنسب حين يكون للفيديو عدة نقاط يطرحها. | نعم |
والمجموعة تعتمد على إعدادات خادم شارك، فقد تتغير. ولقراءتها في أي وقت، أرسل type تعرف
أنه خاطئ: فخطأ التحقق يسرد بالضبط ما هو مقبول.
{ "statusCode": 400, "message": ["type must be any of: image-text-slides, veo3"], "error": "Bad Request"}ولكل منهما شكل customParams مختلف، فراجع خيارات المزود نفسه قبل تركيب طلب حقيقي.
curl -X POST https://dash.sharek.app/api/public/v1/generate-video \ -H "Authorization: your-api-key" \ -H "Content-Type: application/json" \ -d '{ "type": "video-provider-id", "output": "vertical", "customParams": {} }'الاستجابة
Section titled “الاستجابة”صف وسائط:
{ "id": "media-id", "name": "a1b2c3d4e5.mp4", "originalName": null, "path": "https://media.example.com/a1b2c3d4e5.mp4", "thumbnail": null, "alt": null, "status": "ready"}أرفقه بمنشور تمامًا كما ترفق ملفًا مرفوعًا:
"image": [ { "id": "media-id", "path": "https://media.example.com/a1b2c3d4e5.mp4" } ]الأخطاء
Section titled “الأخطاء”| الاستجابة | المعنى |
|---|---|
400 تحقق من الحقول |
type ليس مزودًا متاحًا، أو output ليس vertical ولا horizontal. |
402 |
نفد رصيد فيديو الذكاء الاصطناعي لهذه الفترة. والجسم يحمل resetsAt وurl. |
406 This video is not available in trial mode |
المؤسسة في الفترة التجريبية، وهذا المزود لا يسمح بالاستخدام فيها. |
422 Your request was rejected by the AI safety system. ... |
رفض مزود الذكاء الاصطناعي الطلب. أعد صياغة الموجه ثم أعد المحاولة. |
500 AI generation failed, please try again later. |
نفذ المزود لكنه لم ينتج نتيجة. أعد المحاولة. |
ملاحظات
Section titled “ملاحظات”- التوليد يستهلك رصيد فيديو الذكاء الاصطناعي، وهو يحسب منفصلًا عن حصة منشوراتك.
image-text-slidesيتيح أداةloadVoicesلأصوات التعليق الصوتي لديه. استدعها بـ دوال مزودي الفيديو. أماveo3فلا يتيح شيئًا.