دوال مزودي الفيديو
POST /public/v1/video/functionيستدعي أداة مساعدة يتيحها مزود فيديو. وهذه موجودة لتملأ بها قيمة customParams لا يعرفها
إلا المزود، تمامًا كما يفعل
تشغيل أداة قناة للقنوات الاجتماعية.
وأوضح مثال هو التعليق الصوتي: فالمزود الذي يقرأ نصًا بصوت عالٍ يحتاج معرف صوت، وهذه طريقتك في الحصول على قائمة الأصوات الصالحة قبل استدعاء توليد فيديو.
إن كنت تفعل ذلك من التطبيق، فراجع صور وفيديو بالذكاء الاصطناعي. وهذه
العملية متاحة أيضًا بالأداة videoFunctionTool في خادم
MCP من شارك، ولا يقابلها أمر في أداة CLI.
جسم الطلب
Section titled “جسم الطلب”| الحقل | مطلوب | الوصف |
|---|---|---|
identifier |
نعم | مزود الفيديو، وهي القيمة نفسها التي يأخذها type في توليد فيديو: veo3 أو image-text-slides. |
functionName |
نعم | الأداة المساعدة التي تستدعى. ولا يمكن استدعاء إلا الدوال التي يتيحها المزود عن قصد. |
params |
لا | معاملات الأداة المساعدة. |
وليس كل مزود يتيح شيئًا. فـ image-text-slides يتيح loadVoices، الذي يعيد أصوات التعليق الصوتي
التي تستطيع تمريرها في customParams الخاصة به. أما veo3 فلا يتيح شيئًا، لأن لقطة
واحدة بلا تعليق صوتي ليس فيها ما يبحث عنه.
curl -X POST https://dash.sharek.app/api/public/v1/video/function \ -H "Authorization: your-api-key" \ -H "Content-Type: application/json" \ -d '{ "identifier": "image-text-slides", "functionName": "loadVoices", "params": {} }'الاستجابة
Section titled “الاستجابة”ما تعيده الأداة المساعدة أيًا كان، بلا غلاف:
[ { "id": "voice-id", "name": "A voice name" }]والشكل خاص بالمزود نفسه، لذا اقرأه من المزود بدل توقع غلاف موحد.
الأخطاء
Section titled “الأخطاء”| الاستجابة | المعنى |
|---|---|
400 Function ... not found on video instance |
لا أداة مساعدة كهذه لدى المزود، أو أن الدالة المسماة ليست مما يتيحه للاستدعاء. والأسماء تراعي حالة الأحرف. |
500 {"statusCode": 500, "message": "Internal server error"} |
لا مزود فيديو بذلك المعرف. |
ملاحظات
Section titled “ملاحظات”- لا يمكن بلوغ إلا الدوال التي يحددها المزود صراحةً على أنها قابلة للاستدعاء. وتسمية دالة أخرى على المزود تعيد خطأ عدم العثور نفسه بدل تنفيذها.
- هذه العملية غير مقيدة ولا تستهلك أي رصيد فيديو. فـ توليد فيديو وحده يستهلكه.