الانتقال إلى المحتوى الرئيسي
POST
/
kling
/
v1
/
videos
/
text2video
Text to Video
curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/text2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A happy scene of a vacation on the beach."
}
'
{
  "code": 123,
  "message": "<string>",
  "request_id": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "created_at": 123,
    "updated_at": 123
  }
}
استخدم نقطة النهاية هذه لإنشاء مهمة تحويل نص إلى فيديو في Kling انطلاقًا من prompt. وهي تبدأ مهمة async بدلًا من إعادة فيديو مكتمل فورًا.

​
أول طلب عملي

  • أرسل prompt قصيرًا أولًا
  • أضف aspect_ratio أو duration أو mode فقط بعد التأكد من عمل التدفق الأساسي
  • عيّن callback_url إذا كنت تريد التسليم عبر الدفع push بدلًا من polling فقط

​
تدفق المهمة

1

إرسال طلب الإنشاء

أنشئ المهمة عبر نقطة النهاية هذه واحفظ معرّف مهمة Kling المُعاد.
2

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

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

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

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

التفويضات

​
Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الترويسات

​
Content-Type
string

Must be application/json.

الجسم

application/json
​
prompt
string
افتراضي:Hello
مطلوب

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

​
negative_prompt
string

Elements to exclude from the video. Maximum 200 characters.

​
aspect_ratio
string

Output aspect ratio (width:height). Options: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3.

​
callback_url
string

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

​
model_name
string

Kling model variant to use. See the Models page for current options.

​
cfg_scale
number

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

​
mode
enum<string>

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

الخيارات المتاحة:
std,
pro
​
duration
string

Output video length in seconds. Options: 5, 10.

​
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.

الاستجابة

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