توثيق API, ProductAdVideoPack

واجهة API غير متزامنة: حزمة فيديو إعلاني للمنتج

حمّل من 3 إلى 8 صور حقيقية للمنتج وشعاراً اختيارياً. ينشئ العامل ثلاثة إعلانات MP4 بدقة 1080×1920 بخطافات مختلفة وسرد من OpenAI وتعليقات مضمّنة وعبارة تحفيز على الإجراء. لا يُنشئ الذكاء الاصطناعي أي صورة أو فيديو.

نقطة النهاية: POST https://mxprocess.com/api/files/start-process
المصادقة: Bearer JWT
التكلفة: 72 tokens بعد رفع ملفات MP4 الثلاثة كلها.

curl --location --request POST 'https://mxprocess.com/api/files/start-process' \
--header 'Authorization: Bearer YOUR_JWT' \
--form 'actionName=ProductAdVideoPack' \
--form 'file0=@"/path/photo-01.jpg"' \
--form 'file1=@"/path/photo-02.jpg"' \
--form 'file2=@"/path/photo-03.jpg"' \
--form 'logoFile=@"/path/logo.png"' \
--form 'parameters=[["productName",["Product name"]],["benefits",["Fact one; fact two"]],["price",["19.90 EUR"]],["callToAction",["Discover it"]],["language",["en"]],["voice",["alloy"]],["durationSeconds",["20"]]]' \
--form 'async=true'

استخدم file3 حتى file7 للصور الإضافية. استعلم من /api/actions/get-action-infos/{id} ونزّل النتائج الثلاثة product-ad-video-01.mp4 حتى product-ad-video-03.mp4 النتائج. يصف الملف الاختياري product-ad-video-pack.json ويصف المخرجات المُنشأة.

اتصل بنا