Skip to main content
POST
cURL
استخدم هذا endpoint لإنشاء مهمة Kling لتحويل النص إلى فيديو من Prompt. يبدأ هذا Job غير متزامن بدلًا من إرجاع فيديو مكتمل فورًا.

أول طلب يعمل

  • أرسل 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.

المدة ونسبة الأبعاد

لا يوفّر هذا endpoint رمز دقة منفصلًا أو حقل size دقيقًا. تتحكم نسبة الأبعاد المطلوبة في شكل إطار الإخراج.

تدفق المهمة

1

إرسال طلب التوليد

أنشئ المهمة عبر هذا endpoint واحفظ Kling task id المُعاد.
2

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

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

حفظ النتيجة

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

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الترويسات

Content-Type
string

Must be application/json.

الجسم

application/json
prompt
string
مطلوب

Text prompt describing the video to generate. Maximum 500 characters.

negative_prompt
string

Elements to exclude from the video. Maximum 200 characters.

aspect_ratio
enum<string>

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
callback_url
string

Webhook URL to receive task status updates when the task completes.

model_name
enum<string>
افتراضي:kling-v1

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
cfg_scale
number

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

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

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

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

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

camera_control
object

Camera motion preset or manual configuration. Omit for automatic camera movement.

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

Successful Response

code
integer

Error code; specifically define the error code

message
string

error message

request_id
string

Request ID, system-generated, for tracking requests, troubleshooting issues

data
object