إنشاء مهمة Kling لتحويل النص إلى فيديو
أنشئ مقاطع فيديو من أوامر نصية باستخدام Kling عبر CometAPI POST /kling/v1/videos/text2video، ثم تتبّع حالة المهمة واسترجع النتائج بواسطة task ID.
أول طلب يعمل
- أرسل Prompt قصيرًا أولًا
- ابدأ بمثال
kling-v3، ثم اخترmodel_nameآخر من OpenAPI enum عندما تحتاج إلى مسار model مختلف - أضف
aspect_ratioأوdurationأوmodeأوsoundفقط بعد أن يعمل التدفق الأساسي - عيّن
callback_urlإذا كنت تريد تسليمًا عبر push بدلًا من polling فقط - استخدم
sound: offعندما تريد طلبًا أوليًا حتميًا بدون صوت على النماذج التي تدعم الصوت المُولَّد
تسمية النماذج
استخدم model ID العادية لنماذج فيديو Kling على هذا endpoint. احتفِظ بـ model ID الخاصة بـ Omni من أجل Omni Video.المدة ونسبة الأبعاد
size دقيقًا. تتحكم نسبة الأبعاد المطلوبة في شكل إطار الإخراج.
تدفق المهمة
إرسال طلب التوليد
استطلاع حالة المهمة
حفظ النتيجة
التفويضات
Bearer token authentication. Use your CometAPI key.
الترويسات
Must be application/json.
الجسم
Text prompt describing the video to generate. Maximum 500 characters.
Elements to exclude from the video. Maximum 200 characters.
Aspect ratio request. Typical rendered sizes are 1280x720 for 16:9, 720x1280 for 9:16, and 960x960 for 1:1. This endpoint does not expose an exact size field.
16:9, 9:16, 1:1 Webhook URL to receive task status updates when the task completes.
Model ID for this text-to-video request. Use an ordinary Kling video model ID; use Omni model IDs only with the Omni Video endpoint.
kling-v1, kling-v1-6, kling-v2-master, kling-v2-1-master, kling-v2-5-turbo, kling-v2-6, kling-v3 Prompt adherence strength. Higher values follow the prompt more closely. Range: 0–1.
Generation mode. std for standard (faster), pro for professional (higher quality). The default is std.
std, pro Output video length in seconds. Use 5 or 10; omit to use 5.
Camera motion preset or manual configuration. Omit for automatic camera movement.
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.
Optional generated-audio switch for models that support video sound. Use on or off, or omit the field for the model default.
on, off