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

دوال مزودي الفيديو

POST /public/v1/video/function

يستدعي أداة مساعدة يتيحها مزود فيديو. وهذه موجودة لتملأ بها قيمة customParams لا يعرفها إلا المزود، تمامًا كما يفعل تشغيل أداة قناة للقنوات الاجتماعية.

وأوضح مثال هو التعليق الصوتي: فالمزود الذي يقرأ نصًا بصوت عالٍ يحتاج معرف صوت، وهذه طريقتك في الحصول على قائمة الأصوات الصالحة قبل استدعاء توليد فيديو.

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

الحقل مطلوب الوصف
identifier نعم مزود الفيديو، وهي القيمة نفسها التي يأخذها type في توليد فيديو: veo3 أو image-text-slides.
functionName نعم الأداة المساعدة التي تستدعى. ولا يمكن استدعاء إلا الدوال التي يتيحها المزود عن قصد.
params لا معاملات الأداة المساعدة.

وليس كل مزود يتيح شيئًا. فـ image-text-slides يتيح loadVoices، الذي يعيد أصوات التعليق الصوتي التي تستطيع تمريرها في customParams الخاصة به. أما veo3 فلا يتيح شيئًا، لأن لقطة واحدة بلا تعليق صوتي ليس فيها ما يبحث عنه.

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

ما تعيده الأداة المساعدة أيًا كان، بلا غلاف:

[
{ "id": "voice-id", "name": "A voice name" }
]

والشكل خاص بالمزود نفسه، لذا اقرأه من المزود بدل توقع غلاف موحد.

الاستجابة المعنى
400 Function ... not found on video instance لا أداة مساعدة كهذه لدى المزود، أو أن الدالة المسماة ليست مما يتيحه للاستدعاء. والأسماء تراعي حالة الأحرف.
500 {"statusCode": 500, "message": "Internal server error"} لا مزود فيديو بذلك المعرف.
  • لا يمكن بلوغ إلا الدوال التي يحددها المزود صراحةً على أنها قابلة للاستدعاء. وتسمية دالة أخرى على المزود تعيد خطأ عدم العثور نفسه بدل تنفيذها.
  • هذه العملية غير مقيدة ولا تستهلك أي رصيد فيديو. فـ توليد فيديو وحده يستهلكه.