تحويل صور متعددة إلى فيديو

أنشئ فيديوهات Kling من صور متعددة عبر CometAPI POST /kling/v1/videos/multi-image2video، مع التحكم في الحركة وإعدادات الإخراج لعملية التوليد.

POST /kling/v1/videos/multi-image2video

Create a Kling multi-image-to-video task

cURL

curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/multi-image2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model_name": "kling-v1-6",
  "duration": "5",
  "image_list": [
    {
      "image": "https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg"
    },
    {
      "image": "https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg"
    },
    {
      "image": "https://filesystem.site/cdn/20250414/chxiLc2O45zoLT8BCrQ6WQlTvGDDnK.png"
    },
    {
      "image": "https://filesystem.site/cdn/20250414/chxiLc2O45zoLT8BCrQ6WQlTvGDDnK.png"
    }
  ],
  "prompt": "The astronauts got up and left."
}
'

200

{
  "code": 0,
  "message": "SUCCEED",
  "data": {
    "task_id": "861309198188019719",
    "task_status": "submitted",
    "task_info": {},
    "created_at": 1773380633979,
    "updated_at": 1773380633979
  }
}

استخدم هذه النقطة الطرفية عندما لا تكون صورة مصدر واحدة كافية وتريد من Kling إنشاء الحركة بالاعتماد على عدة صور مرجعية.

​

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

• جهّز من 2 إلى 4 صور في image_list
• ابدأ باستخدام model_name: kling-v1-6 أو أي model حالي آخر قمت بالتحقق منه
• اجعل الاختبار الأول بسيطًا: Prompt قصير واحد، بدون أقنعة حركة، وبدون إعدادات callback إضافية

​

سير المهمة

1. إرسال طلب الصور المتعددة

   أرسل قائمة الصور وPrompt وduration، ثم احفظ قيمة task_id الخاصة بـ Kling التي يتم إرجاعها.

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

   تابع باستخدام الاستعلامات الفردية حتى تصل المهمة إلى حالة نهائية.

3. حفظ النتيجة

   احفظ الفيديو النهائي إذا كنت بحاجة إلى الاحتفاظ به لمدة تتجاوز رابط التسليم الخاص بموفر الخدمة.

أكد التحقق المباشر بتاريخ 2026-03-13 أنه تم قبول طلب أدنى مكوّن من صورتين وأعاد القيمة task_status: submitted.

للاطلاع على المرجع الكامل للمعلمات، راجع توثيق Kling الرسمي.

التفويضات

Authorization · string · header · مطلوب

Bearer token authentication. Use your CometAPI key.

الجسم

application/json

model_name · string · افتراضي: kling-v1-6 · مطلوب

Kling model variant to use. See the Models page for current options.

duration · string · افتراضي: 5 · مطلوب

Output video length in seconds. Options: 5, 10.

image_list · object[] · مطلوب

2 to 4 source images. Each item provides an image field as a public URL or Base64 string (without data: prefix). Accepted formats: JPG, JPEG, PNG. Maximum 10 MB per image, minimum 300×300 px, aspect ratio between 1:2.5 and 2.5:1.

Show child attributes

prompt · string · افتراضي: The cat turns its head and blinks. · مطلوب

Text prompt describing the desired motion. Maximum 500 characters.

negative_prompt · string

Elements to exclude from the video. Maximum 200 characters.

callback_url · string

Webhook URL to receive task status updates when the task completes.

mode · string

Generation mode. std for standard (faster), pro for professional (higher quality).

cfg_scale · number

Prompt adherence strength. Higher values follow the prompt more closely. Range: 0–1.

static_mask · string

Static brush mask image as a Base64 string or public URL. White areas are frozen in place during video generation. Must match the aspect ratio and resolution of the input image.

dynamic_masks · object

Dynamic brush configuration. Up to 6 groups, each containing a painted-area mask and a motion trajectory.

Show child attributes

external_task_id · string

Custom task id for your own tracking. Does not replace the system-generated task id but can be used to query tasks. Must be unique per user.

الاستجابة

200 - application/json

Task accepted.

code · integer · مطلوب

Error code; specifically define the error code

message · string · مطلوب

error message

data · object · مطلوب

Show child attributes