الانتقال إلى المحتوى الرئيسي
POST
/
kling
/
v1
/
videos
/
multi-image2video
Create a Kling multi-image-to-video task
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."
}
'
{
  "code": 0,
  "message": "SUCCEED",
  "data": {
    "task_id": "861309198188019719",
    "task_status": "submitted",
    "task_info": {},
    "created_at": 1773380633979,
    "updated_at": 1773380633979
  }
}

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.

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

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

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

​
سير المهمة

1

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

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

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

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

الاحتفاظ بالنتيجة

احفظ الفيديو النهائي إذا كنت بحاجة إلى الاحتفاظ به لما بعد رابط التسليم الخاص بالمزوّد.
للاطلاع على المرجع الكامل للمعلمات، راجع وثائق 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.

​
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.

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