Kling V1 - Text to Video

kling-v1-t2v

kling-v1-t2v Kling V1 - Text to Video kirin_v1_t2v kling

Basic image-to-video generation that adds natural motion to static visuals.

Примечание к API

kling-v1-t2v only supports camera control (camera_control) when mode is std and duration is 5 seconds

kling-v1-t2v generates videos at 720p resolution with 30fps frame rate for both std and pro modes

Эндпоинты

POST /v1/queue/kling-v1-t2v # Создать задачу

GET /v1/queue/kling-v1-t2v/requests/{request_id}/status # Проверить статус

GET /v1/queue/kling-v1-t2v/requests/{request_id}/response # Получить результат

PUT /v1/queue/kling-v1-t2v/requests/{request_id}/cancel # Отменить задачу

Совет

Добавляйте заголовок аутентификации в каждый запрос: Authorization: Bearer YOUR_API_KEY.

Параметры запроса

curl --request 'POST' 'https://odirouter.ai/model/v1/queue/kling-v1-t2v' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "prompt": "A cinematic drone shot over a misty mountain range at sunrise",
  "negative_prompt": "blurry, low quality, distorted",
  "cfg_scale": 0.5,
  "mode": "std"
}'

prompt string required

Video generation prompt, must be provided and length between 1-2500 characters

---

duration string

Video duration in seconds

Options: 5, 10

Default: 5

---

aspect_ratio string

Video aspect ratio (width:height)

Options: 16:9, 9:16, 1:1

Default: 16:9

---

negative_prompt string

Negative prompt for specifying content you don’t want in the generated video, max 2500 characters

---

cfg_scale number

Freedom of generated video; larger value means less model freedom, stronger correlation with user input prompt

Range: 0 - 1

Default: 0.5

---

mode string

Video generation mode

std: Standard mode, basic mode, high cost-performance pro: Expert mode (high quality), high performance mode, better generated video quality

Options: std, pro

Default: std

---

camera_control object

Parameter for controlling camera movement (if not specified, model will intelligently match based on input text/image)

type string

Predefined camera movement type

simple: Simple camera movement, can choose one of six movements in config down_back: Camera presses down and moves back → down and zoom out, no config needed forward_up: Camera moves forward and tilts up → push in and move up, no config needed right_turn_forward: First rotate right then move forward → right turn push in, no config needed left_turn_forward: First rotate left and move forward → left turn push in, no config needed

Options: simple, down_back, forward_up, right_turn_forward, left_turn_forward

config object

Contains six fields for specifying camera movement or changes in different directions

Required when type is simple, not needed for other types Choose one of the following 6 parameters, only one can be non-zero, others must be 0

horizontal number

Horizontal movement, controls camera horizontal movement (translation along x-axis)

Range: -10 - 10, negative moves left, positive moves right

vertical number

Vertical movement, controls camera vertical movement (translation along y-axis)

Range: -10 - 10, negative moves down, positive moves up

pan number

Horizontal pan, controls camera rotation on horizontal plane (rotation around y-axis)

Range: -10 - 10, negative rotates left, positive rotates right

tilt number

Vertical tilt, controls camera rotation on vertical plane (rotation around x-axis)

Range: -10 - 10, negative tilts down, positive tilts up

roll number

Roll movement, controls camera roll (rotation around z-axis)

Range: -10 - 10, negative rotates counter-clockwise, positive rotates clockwise

zoom number

Zoom, controls camera focal length change, affects field of view distance

Range: -10 - 10, negative zooms in (smaller FOV), positive zooms out (larger FOV)

---

watermark_info array

Whether to generate results with watermark simultaneously

Defined by enabled parameter, specific array format as follows:

"watermark_info": {
  "enabled": boolean // true for generation, false for no generation
}

Custom watermarks are not currently supported

---

callback_url string

Callback notification address for this task result. If configured, the server will actively notify when task status changes

---

external_task_id string

Custom task ID

User-defined task ID. Input will not overwrite system-generated task ID, but supports task query through this ID

Please note, must ensure uniqueness under a single user

Параметры ответа

{
  "request_id": "task_01hxyz...",
  "response_url": "https://odirouter.ai/model/v1/queue/kling-v1-t2v/requests/task_01hxyz.../response",
  "status_url": "https://odirouter.ai/model/v1/queue/kling-v1-t2v/requests/task_01hxyz.../status",
  "cancel_url": "https://odirouter.ai/model/v1/queue/kling-v1-t2v/requests/task_01hxyz.../cancel",
  "queue_position": 0
}

Поле	Тип	Описание
request_id	string	Идентификатор задачи для последующей проверки статуса, получения результата и отмены.
response_url	string	URL для получения итогового результата.
status_url	string	URL для проверки статуса задачи.
cancel_url	string	URL для отмены задачи.
queue_position	int	Текущая позиция в очереди.

Следующие операции

Проверить статус

Получить результат

Отменить задачу

Обработка ошибок