تخطَّ إلى المحتوى

توليد فيديو

POST /public/v1/generate-video

يولد فيديو بأحد مزودي الفيديو بالذكاء الاصطناعي في شارك ويحفظه في مكتبة الوسائط. والاستجابة هي صف الوسائط نفسه الذي يعيده الرفع، فيوضع مباشرة في مصفوفة image الخاصة بالمنشور.

إن كنت تفعل ذلك من التطبيق، فراجع صور وفيديو بالذكاء الاصطناعي. وهذه العملية متاحة أيضًا بالأداة generateVideoTool في خادم MCP من شارك، وهي تبدأ إنشاء الفيديو وتعود فورًا بدل الانتظار، ولا يقابلها أمر في أداة CLI.

الحقل مطلوب الوصف
type نعم مزود الفيديو المستخدم. حاليًا veo3 أو image-text-slides.
output نعم vertical أو horizontal. وأي شيء آخر يرفض.
customParams لا خيارات خاصة بالمزود، بالشكل الذي يحدده مخطط المزود نفسه.

يتوفر اثنان، وقد تم التحقق من ذلك مقابل الإنتاج في 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 مختلف، فراجع خيارات المزود نفسه قبل تركيب طلب حقيقي.

Terminal window
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": {}
}'

صف وسائط:

{
"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" } ]
الاستجابة المعنى
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. نفذ المزود لكنه لم ينتج نتيجة. أعد المحاولة.
  • التوليد يستهلك رصيد فيديو الذكاء الاصطناعي، وهو يحسب منفصلًا عن حصة منشوراتك.
  • image-text-slides يتيح أداة loadVoices لأصوات التعليق الصوتي لديه. استدعها بـ دوال مزودي الفيديو. أما veo3 فلا يتيح شيئًا.