الانتقال إلى المحتوى الرئيسي
POST
/
kling
/
v1
/
videos
/
effects
Create a Kling video-effects task
curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/effects \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "effect_scene": "hug",
  "input": {
    "model_name": "kling-v1-6",
    "mode": "std",
    "images": [
      "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/c54e463c95816d959602f1f2541c62b2.png?x-kcdn-pid=112452",
      "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/5eef15e03a70e1fa80732808a2f50f3f.png?x-kcdn-pid=112452"
    ],
    "duration": "10"
  }
}
'
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "2032273960331935744",
    "task_status": "submitted",
    "task_info": {},
    "created_at": 1773366844624,
    "updated_at": 1773366844624
  }
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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

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

  • hug و kiss هما إعدادان جاهزان لتفاعل بين شخصين
  • fuzzyfuzzy و squish و expansion و heart_gesture هي تأثيرات جاهزة منمقة
  • يعتمد الشكل الدقيق للأصل على التأثير، لكن الطلب يغلّف دائمًا الإعدادات الخاصة بالمزوّد داخل input

سير المهمة

1

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

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

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

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

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

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

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الجسم

application/json
effect_scene
enum<string>
افتراضي:hug
مطلوب

Preset effect to apply. Each effect defines a specific animation or interaction style.

الخيارات المتاحة:
fuzzyfuzzy,
squish,
expansion,
hug,
kiss,
heart_gesture
input
object
مطلوب

Effect-specific input payload. Most interaction effects use one or more image URLs plus model settings.

callback_url
string
افتراضي:https://example.com/webhook

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

external_task_id
string
افتراضي:my-kling-effect-task-001

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
مطلوب