توليد الفيديو وإدارة الأصول

إنشاء مقاطع فيديو باستخدام نماذج Kling v4 و Seedance، والإشارة إلى أصول وسائط معتمدة.

إرسال مهام إنشاء الفيديو وإدارة أصول الوسائط المعتمدة عبر نقاط نهاية الفيديو الأصلية.

POST/v1/videos

جسم الطلب

الحقلالنوعمطلوبالوصف
promptstringنعمالوصف النصي للمشهد وحركة الكاميرا المطلوبة في الفيديو.
modelstringلامعرف نموذج الفيديو، مثل kling-v4 أو doubao-seedance-2-0-260128.
duration_secondsnumberلامدة الفيديو بالثواني (رقم موجب حتى 300، أو الاسم المستعار duration).
Additional fieldsobjectلامعلمات الفيديو الإضافية (مثل resolution و aspect_ratio و first_frame_url و last_frame_url) يتم تمريرها دون تغيير إلى المحرك.

أصول Seedance المعتمدة

POST/v1/seedance/assets
GET/v1/seedance/assets/{asset_id}
  • تسجيل الأصول: أرسل POST /v1/seedance/assets (operationId: seedance_assets.create) مع حمولة JSON تحتوي على الحقول الإلزامية sourceUrl و assetType (image أو video) والحقل الاختياري displayName.
  • مراجع URI: الإشارة إلى الوسائط المسجلة مباشرة باستخدام asset://{asset_id} في عناوين URL للإطارات أو المعلمات المتقدمة.
  • عزل المستأجرين: يتم عزل الأصول بشكل آمن في مكتبة الأصول الحالية للمستأجر والتحقق منها مع التخزين العلوي.

حالة المهمة وتنزيل النتائج

GET/v1/videos/{task_id}
  • استطلاع الحالة: استعلم عن حالة المهمة عبر GET /v1/videos/{task_id} (operationId: legacy_media.video.get)، مع دعم 9 حالات: queued و submitting و submitted و running و ingesting_artifacts و cancel_requested و completed و failed و cancelled.
  • تنزيل المخرجات: تنزيل ملف الفيديو النهائي عبر GET /v1/videos/{task_id}/content.
  • دعم Kling v4: دعم كامل لتحويل النص إلى فيديو، وتوليد الفيديو من الصورة الأولى، وانتقالات الإطار الأخير.

مسارات التوافق

  • الاسم المستعار للوسائط السابقة: POST /openai/v1/videos هو اسم مستعار لـ POST /v1/videos (legacy_media.video.create.alias)، ويتبع الهيكل نفسه.
  • مسار المهام السابق: يقبل POST /v1/videos/generations حمولات بتنسيق CreateVideoGenerationRequest.
  • خط أنابيب غير متزامن موحد: يوفر POST /v1/async-tasks/video-generations عقد دورة حياة مهام غير متزامنة قياسياً لـ v4.