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

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

  • أرسل إما video_id أو video_url، ولكن ليس كليهما
  • استخدم video_url عندما لا يكون المقطع المصدر قد أتى من Kling في الأصل
  • اترك callback_url وexternal_task_id كخيارين اختياريين ما لم يكن تكاملك يحتاج إليهما

تدفق المهمة

1

إرسال الفيديو المصدر

أرسل إما video_id الخاص بـ Kling أو video_url يمكن الوصول إليه، ثم احفظ معرّف المهمة الذي يتم إرجاعه.
2

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

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

حفظ المخرجات

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

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الجسم

application/json
video_id
string
مطلوب

ID of a Kling-generated video. Only videos created within the last 30 days with a duration of 3–20 seconds are supported. Mutually exclusive with video_url — exactly one must be provided.

external_task_id
string

Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.

callback_url
string

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

video_url
string

Accessible URL of the source video. Accepted formats: MP4, MOV. Max 100 MB, 720p or 1080p resolution, duration 3–20 seconds. Mutually exclusive with video_id — exactly one must be provided.

الاستجابة

200 - application/json

Task accepted.

code
integer
مطلوب

Error code; specific error code definition

message
string
مطلوب

Error message

data
object
مطلوب