Skip to main content
POST
cURL
Gunakan endpoint ini untuk membuat task text-to-video Kling dari sebuah prompt. Endpoint ini memulai job async alih-alih langsung mengembalikan video yang sudah selesai.

Permintaan pertama yang berfungsi

  • Kirim prompt singkat terlebih dahulu
  • Mulai dengan contoh kling-v3, lalu pilih model_name lain dari enum OpenAPI saat Anda memerlukan jalur model yang berbeda
  • Tambahkan aspect_ratio, duration, mode, atau sound hanya setelah alur dasar berfungsi
  • Setel callback_url jika Anda ingin pengiriman push alih-alih murni polling
  • Gunakan sound: off saat Anda menginginkan permintaan pertama tanpa audio yang deterministik pada model yang mendukung suara yang dihasilkan

Penamaan model

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

Durasi dan rasio aspek

Endpoint ini tidak mengekspos token resolusi terpisah atau field size yang presisi. Rasio aspek yang diminta mengontrol bentuk frame output.

Alur task

1

Submit the generation request

Buat task melalui endpoint ini dan simpan task id Kling yang dikembalikan.
2

Poll the task state

Periksa progres melalui Get a Kling task hingga task mencapai status terminal.
3

Persist the result

Setelah Kling mengembalikan metadata aset yang sudah selesai, pindahkan hasilnya ke penyimpanan Anda sendiri jika Anda memerlukan retensi jangka panjang.
Untuk matriks parameter lengkap dan detail jalur model, lihat dokumentasi resmi Kling.

Otorisasi

Authorization
string
header
wajib

Bearer token authentication. Use your CometAPI key.

Header

Content-Type
string

Must be application/json.

Body

application/json
prompt
string
wajib

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.

Opsi yang tersedia:
16:9,
9:16,
1:1
callback_url
string

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

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

Opsi yang tersedia:
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>
default:std

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

Opsi yang tersedia:
std,
pro
duration
string
default: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.

Opsi yang tersedia:
on,
off

Respons

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