Skip to main content
POST
cURL
استخدم نقطة النهاية هذه لإرسال مهمة تعديل الفيديو متعددة الوسائط النهائية بعد أن تصبح الجلسة والاختيارات جاهزة.

سير العمل الكامل

1

تهيئة جلسة التعديل

ابدأ بـ Initialize Video for Editing للحصول على session_id للمقطع الذي تريد تعديله.
2

إنشاء منطقة التحديد

استخدم Add Video Selection وعند الحاجة Preview Selected Video Area لتحسين منطقة التعديل.
3

إرسال المهمة النهائية

أرسل session_id وedit_mode وprompt النهائي وأي إعدادات إنشاء اختيارية عبر نقطة النهاية هذه، ثم احفظ task id المُعاد للتحقق من الحالة.

قبل استدعائها

  • تأكد من أن جلسة التحديد تمت تهيئتها بالفعل
  • أكّد أن تحديد المنطقة صحيح قبل استهلاك استدعاء إنشاء
  • نفّذ استدعاءات المتابعة الخاصة بالتحديد على الحساب نفسه وباستخدام session_id نفسه تمامًا الذي أُعيد عند التهيئة
  • اضبط edit_mode على addition أو swap أو removal
  • وفّر image_list لكل من addition وswap؛ واحذف image_list عند removal
  • أرسل duration كسلسلة نصية مثل "5" أو "10"؛ وتمرّر الأمثلة "5" بشكل صريح
  • تعامل مع هذا المسار باعتباره خطوة الإنشاء النهائية، وليس خطوة الإعداد
  • أضف image_list أو negative_prompt أو mode أو duration أو callback_url أو external_task_id فقط عندما يتطلبها سير عمل التعديل
للاطلاع على المرجع الكامل للمعلمات، راجع Kling API documentation.

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الجسم

application/json
session_id
string
مطلوب

Selection session id returned by init-selection. Follow-up calls must use the same account and exact session id.

edit_mode
enum<string>
مطلوب

Editing operation for the selected video region. Use addition to add an element, swap to replace a selected element, or removal to remove it.

الخيارات المتاحة:
addition,
swap,
removal
prompt
string
مطلوب

Instruction describing the desired edit. Reference the source video as <<<video_1>>> and any reference image as <<<image_1>>>.

model_name
enum<string>
افتراضي:kling-v1-6

Kling model variant for the final edit task. Omit to use kling-v1-6.

الخيارات المتاحة:
kling-v1-6
image_list
object[]

Image references used by addition and swap tasks. Omit this field for removal tasks.

Minimum array length: 1
negative_prompt
string

Elements to avoid in the edited result.

mode
enum<string>

Generation mode. Use std or pro.

الخيارات المتاحة:
std,
pro
duration
string

Requested output duration in seconds.

callback_url
string

Webhook URL to receive task status updates.

external_task_id
string

Custom task id for your own tracking. Must be unique per account.

الاستجابة

200 - application/json

Task accepted.

code
integer
مطلوب
message
string
مطلوب
data
object
مطلوب