Skip to main content
POST
cURL
استخدم هذا endpoint لتحريك صورة مصدر واحدة وتحويلها إلى فيديو Kling.

قبل استدعائه

  • قدّم عنوان URL عامًّا واحدًا للصورة أو سلسلة صورة واحدة بتنسيق base64
  • استخدم صورة تستوفي متطلبات البكسل الخاصة بـ Kling؛ إذ تُرفض الصور المصغّرة الصغيرة جدًا من مهمة الإنشاء
  • ابدأ بمثال kling-v2-6 الافتراضي، ثم اختر model_name آخر من enum في OpenAPI عندما تحتاج إلى مسار model مختلف
  • اجعل الطلب الأول بسيطًا: صورة إدخال واحدة، وPrompt واحد، ومن دون tail frame، ومن دون motion masks
  • استخدم dynamic_masks كمصفوفة من كائنات mask-and-trajectory عندما تحتاج إلى تحكم في الحركة الموضعية
  • استخدم sound: off لطلب أولي حتمي من دون صوت على مسارات model التي تدعم الصوت المُولَّد

تسمية النماذج

استخدم model ID العادية لفيديو Kling على هذا endpoint. واحتفظ بـ model ID الخاصة بـ Omni من أجل Omni Video.

تدفق المهمة

1

إرسال طلب تحويل الصورة إلى فيديو

أنشئ المهمة وخزّن قيمة Kling task_id المُعادة.
2

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

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

تخزين النتيجة

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

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الجسم

application/json
image
string
مطلوب

Source image URL or base64 image string. Use an image that meets Kling pixel requirements; very small thumbnails are rejected. For base64 input, send the encoded image string as the field value.

prompt
string

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
enum<string>
افتراضي:std

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

الخيارات المتاحة:
std,
pro
model_name
enum<string>
افتراضي:kling-v1

Model ID for this image-to-video request. Use kling-v3 for new requests. Use Omni model IDs only with the Omni Video endpoint.

الخيارات المتاحة:
kling-v1,
kling-v1-5,
kling-v1-6,
kling-v2-master,
kling-v2-1,
kling-v2-1-master,
kling-v2-5-turbo,
kling-v2-6,
kling-v3
image_tail
string

Tail-frame reference image as a Base64 string or public URL. Same format requirements as image. Controls the last frame of the generated video.

cfg_scale
number

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

duration
string
افتراضي:5

Output video length in seconds. Use 5 or 10; omit to use 5.

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[]

Optional motion masks. Each entry contains a mask image and an ordered trajectory list.

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.

sound
enum<string>

Optional generated-audio switch for models that support video sound. Use on or off, or omit the field for the model default.

الخيارات المتاحة:
on,
off

الاستجابة

200 - application/json

Task accepted.

code
integer
مطلوب

Error code; specifically define the error code

message
string
مطلوب

error message

data
object
مطلوب