Skip to main content
POST
cURL
Gunakan endpoint ini untuk menganimasikan satu gambar sumber menjadi video Kling.

Sebelum Anda memanggilnya

  • Sediakan satu URL gambar publik atau satu string gambar base64
  • Gunakan gambar yang memenuhi persyaratan piksel Kling; thumbnail yang sangat kecil akan ditolak oleh task generation
  • Mulailah dengan contoh default kling-v2-6, lalu pilih model_name lain dari enum OpenAPI saat Anda memerlukan track model yang berbeda
  • Buat request pertama tetap sederhana: satu gambar input, satu prompt, tanpa tail frame, tanpa motion mask
  • Gunakan dynamic_masks sebagai array objek mask-and-trajectory saat Anda memerlukan motion lokal yang terkontrol
  • Gunakan sound: off untuk request pertama tanpa audio yang deterministik pada track model yang mendukung generated sound

Penamaan model

Gunakan model ID video Kling biasa pada endpoint ini. Simpan model ID Omni untuk Omni Video.

Alur task

1

Kirim request image-to-video

Buat task dan simpan Kling task_id yang dikembalikan.
2

Poll task

Lanjutkan dengan Get a Kling task untuk mengikuti status task hingga output siap.
3

Simpan hasilnya

Simpan aset yang sudah selesai jika Anda memerlukan retensi melebihi URL pengiriman provider.
Untuk referensi parameter lengkap, lihat dokumen resmi Kling.

Otorisasi

Authorization
string
header
wajib

Bearer token authentication. Use your CometAPI key.

Body

application/json
image
string
wajib

Source image URL or base64 image string. Use an image that meets Kling pixel requirements; very small thumbnails are rejected. For base64 input, send the encoded image string as the field value.

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
enum<string>
default:std

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

Opsi yang tersedia:
std,
pro
model_name
enum<string>
default:kling-v1

Model ID for this image-to-video request. Use kling-v3 for new requests. Use Omni model IDs only with the Omni Video endpoint.

Opsi yang tersedia:
kling-v1,
kling-v1-5,
kling-v1-6,
kling-v2-master,
kling-v2-1,
kling-v2-1-master,
kling-v2-5-turbo,
kling-v2-6,
kling-v3
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
default:5

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

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[]

Optional motion masks. Each entry contains a mask image and an ordered trajectory list.

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.

Opsi yang tersedia:
on,
off

Respons

200 - application/json

Task accepted.

code
integer
wajib

Error code; specifically define the error code

message
string
wajib

error message

data
object
wajib