Skip to main content
POST
cURL
استخدم نقطة النهاية هذه عندما لا تكفي صورة مصدر واحدة وتريد من Kling إنشاء الحركة من عدة صور مرجعية.

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

  • جهّز من 1 إلى 4 صور في image_list
  • استخدم صورًا تستوفي متطلبات البكسل الخاصة بـ Kling؛ إذ ترفض مهمة التوليد الصور المصغّرة الصغيرة جدًا
  • احذف model_name ما لم تكن بحاجة تحديدًا إلى اختيار model متوافق مع المسار
  • اجعل الاختبار الأول بسيطًا: Prompt قصير، وduration: 5، ومن دون أي إعدادات callback إضافية
  • لا ترسل حقول قناع image-to-video مثل static_mask أو dynamic_masks في هذا المسار

تدفق المهمة

1

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

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

استقصاء المهمة

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

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

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

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الجسم

application/json
image_list
object[]
مطلوب

Input image references. Provide 1 to 4 items that meet Kling pixel requirements; very small thumbnails are rejected.

Required array length: 1 - 4 elements
model_name
enum<string>
افتراضي:kling-v1-6

Kling model variant for multi-image video. Omit to use kling-v1-6.

الخيارات المتاحة:
kling-v1-6
prompt
string

Text prompt describing the desired motion and scene.

negative_prompt
string

Elements to avoid in the generated video.

mode
enum<string>
افتراضي:std

Generation mode. Use std or pro; omitted requests use std.

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

Output video length in seconds. Use 5 or 10; omitted requests use 5.

aspect_ratio
enum<string>

Requested frame aspect ratio when the model needs an explicit frame shape.

الخيارات المتاحة:
16:9,
9:16,
1:1
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
مطلوب

Error code; specifically define the error code

message
string
مطلوب

error message

data
object
مطلوب