الانتقال إلى المحتوى الرئيسي
POST
cURL
استخدم نقطة النهاية هذه لتطبيق أحد مشاهد التأثير الجاهزة في Kling وتحويل الأصول المدخلة إلى فيديو قصير جديد.

اختر مشهد تأثير

  • تستخدم تأثيرات الصورة الواحدة effect_scene بالإضافة إلى input.image وinput.duration
  • تستخدم تأثيرات التفاعل بين شخصين effect_scene بالإضافة إلى input.images التي تحتوي على صورتين بالضبط
  • يجب أن تستوفي الصور المدخلة متطلبات البكسل الخاصة بـ Kling؛ إذ ترفض مهمة الإنشاء الصور المصغرة الصغيرة جدًا
  • يعتمد الشكل الدقيق للأصل على التأثير المحدد، لكن الطلب يغلّف دائمًا إعدادات التأثير داخل input
  • استخدم مشهد تأثير متاحًا حاليًا في Kling؛ إذ ترفض CometAPI قيم effect_scene غير المعروفة
  • تجنب الاعتماد على قائمة enum عامة ثابتة؛ إذ يتغير توفر التأثيرات حسب مسار النموذج وعائلة المشهد

تدفق المهمة

1

إرسال طلب التأثير

أرسل effect_scene مع كائن input المطابق واحفظ معرّف المهمة الذي يتم إرجاعه.
2

استعلم عن المهمة

تابع باستخدام الحصول على مهمة Kling حتى تنتهي مهمة التأثير.
3

الاحتفاظ بالأصل النهائي

نزّل فيديو التأثير النهائي أو أنشئ نسخة مطابقة له إذا كنت بحاجة إلى احتفاظ مستقر.
للاطلاع على المرجع الكامل للمعلمات، راجع وثائق Kling الرسمية.

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الجسم

application/json
effect_scene
string
مطلوب

Kling preset effect scene. Single-image effects use input.image; two-person interaction effects use input.images with exactly two images.

input
Single-image effect input · object
مطلوب

Effect-specific input payload. Single-image scenes require image and duration; two-person interaction scenes require exactly two images and duration.

callback_url
string

Webhook URL for task status notifications. The server sends a callback when the task status changes.

external_task_id
string

Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.

الاستجابة

200 - application/json

Task accepted.

code
integer
مطلوب

Error code; specific error code definition

message
string
مطلوب

Error message

data
object
مطلوب