توليد الفيديو وإدارة الأصول
إنشاء مقاطع فيديو باستخدام نماذج Kling v4 و Seedance، والإشارة إلى أصول وسائط معتمدة.
إرسال مهام إنشاء الفيديو وإدارة أصول الوسائط المعتمدة عبر نقاط نهاية الفيديو الأصلية.
POST
/v1/videosجسم الطلب
| الحقل | النوع | مطلوب | الوصف |
|---|---|---|---|
prompt | string | نعم | الوصف النصي للمشهد وحركة الكاميرا المطلوبة في الفيديو. |
model | string | لا | معرف نموذج الفيديو، مثل kling-v4 أو doubao-seedance-2-0-260128. |
duration_seconds | number | لا | مدة الفيديو بالثواني (رقم موجب حتى 300، أو الاسم المستعار duration). |
| Additional fields | object | لا | معلمات الفيديو الإضافية (مثل resolution و aspect_ratio و first_frame_url و last_frame_url) يتم تمريرها دون تغيير إلى المحرك. |
أصول Seedance المعتمدة
POST
/v1/seedance/assetsGET
/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.