Görüntüden Videoya

Tek bir görüntüyü, asenkron görev oluşturma ve task ID ile ilerleme takibiyle, CometAPI POST /kling/v1/videos/image2video üzerinden bir Kling videosuna dönüştürün.

POST /kling/v1/videos/image2video

cURL

kling-v1

curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/image2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "image": "https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg"
}
'

200

{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "2032273942220931072",
    "task_status": "submitted",
    "task_info": {},
    "created_at": 1773366840306,
    "updated_at": 1773366840306
  }
}

Bu endpoint’i kullanarak tek bir kaynak görüntüyü bir Kling videosuna dönüştürebilirsiniz.

​

Çağırmadan önce

• Bir genel image URL’si veya bir base64 image string sağlayın
• Minimal modern bir istek için model_name: kling-v2-master ile başlayın
• İlk isteği basit tutun: bir input image, bir prompt, tail frame yok, motion mask yok

​

Görev akışı

1. Görüntüden videoya isteğini gönderin

   Görevi oluşturun ve döndürülen Kling task_id değerini saklayın.

2. Görevi sorgulayın

   Çıktı hazır olana kadar görev durumunu takip etmek için Individual Queries ile devam edin.

3. Sonucu saklayın

   Sağlayıcının teslim URL’sinin ötesinde saklama ihtiyacınız varsa tamamlanmış varlığı kalıcı olarak kaydedin.

Tam parametre referansı için resmî Kling dokümanına bakın.

Yetkilendirmeler

Authorization · string · header · gerekli

Bearer token authentication. Use your CometAPI key.

Gövde

application/json

image · string · varsayılan: example · gerekli

Source image as a Base64 string or public URL. Accepted formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300×300 px.

prompt · string

Text prompt describing the desired motion. Maximum 500 characters.

negative_prompt · string

Elements to exclude from the video. Maximum 200 characters.

callback_url · string

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

mode · string

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

model_name · string

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

image_tail · string

Tail-frame reference image as a Base64 string or public URL. Same format requirements as image. Controls the last frame of the generated video.

cfg_scale · number

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

duration · string

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

static_mask · string

Static brush mask image as a Base64 string or public URL. White areas are frozen in place during video generation. Must match the aspect ratio and resolution of the input image.

dynamic_masks · object

Dynamic brush configuration. Up to 6 groups, each containing a painted-area mask and a motion trajectory.

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

Task accepted.

code · integer · gerekli

Error code; specifically define the error code

message · string · gerekli

error message

data · object · gerekli

Show child attributes