Metinden Videoya

CometAPI üzerinden Kling ile metin Prompt’larından videolar oluşturmak için POST /kling/v1/videos/text2video kullanın, ardından görev durumunu izleyin ve sonuçları görev kimliğine göre alın.

POST /kling/v1/videos/text2video

Text to Video

cURL

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."
}
'

200

{
  "code": 123,
  "message": "<string>",
  "request_id": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "created_at": 123,
    "updated_at": 123
  }
}

Bu endpoint’i kullanarak bir Prompt’tan Kling metinden videoya görevi oluşturabilirsiniz. Tamamlanmış videoyu hemen döndürmek yerine async bir iş başlatır.

​

İlk çalışan istek

• Önce kısa bir Prompt gönderin
• aspect_ratio, duration veya mode parametrelerini yalnızca temel akış çalıştıktan sonra ekleyin
• Salt polling yerine push teslimat istiyorsanız callback_url ayarlayın

​

Görev akışı

1. Üretim isteğini gönderin

   Görevi bu endpoint üzerinden oluşturun ve döndürülen Kling görev kimliğini kaydedin.

2. Görev durumunu sorgulayın

   Görev terminal bir duruma ulaşana kadar ilerlemeyi Bireysel Sorgular üzerinden kontrol edin.

3. Sonucu kalıcı olarak saklayın

   Kling tamamlanmış varlık meta verilerini döndürdüğünde, uzun süreli saklama gerekiyorsa sonucu kendi depolamanıza taşıyın.

Tam parametre matrisi ve model kanalı ayrıntıları için resmi Kling dokümantasyonuna bakın.

Yetkilendirmeler

Authorization · string · header · gerekli

Bearer token authentication. Use your CometAPI key.

Başlıklar

Content-Type · string

Must be application/json.

Gövde

application/json

prompt · string · varsayılan: Hello · gerekli

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

Mevcut seçenekler: 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.

Show child attributes

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.

Yanıt

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

Show child attributes