Kling V2.1 - Image to Video

kling-v2-1-i2v

kling-v2-1-i2v Kling V2.1 - Image to Video kirin_v2_1_i2v kling

Advanced image-to-video generation with refined motion control and higher output stability.

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

kling-v2-1-i2v does not support tail frame only.

kling-v2-1-i2v only supports both image and image_tail parameters when mode is pro.

kling-v2-1-i2v generates videos in std mode at 720p resolution with 24fps frame rate.

kling-v2-1-i2v generates videos in pro mode at 1080p resolution with 24fps frame rate.

Эндпоинты

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

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

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

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

Совет

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

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

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

image string required

Reference image

Supports Base64 encoded image or image URL (ensure accessible)

Please note, if you use Base64, ensure all image data parameters use Base64 encoding format. Do not add any prefix such as data:image/png;base64, before the Base64 string. The correct format should be the Base64 encoded string directly

Image requirements: Format: .jpg, .jpeg, .png Size: Less than 10MB Dimensions: Width and height at least 300px, aspect ratio between 1:2.5 and 2.5:1

---

prompt string

Video generation prompt (optional), maximum 2500 characters

---

duration string

Video duration in seconds

Options: 5, 10

Default: 5

---

mode string

Video generation mode

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

Options: std, pro

Default: std

---

negative_prompt string

Negative text prompt, maximum 2500 characters

---

image_tail string

Reference image - tail frame control

Supports Base64 encoded image or image URL (ensure accessible)

Please note, if you use Base64, ensure all image data parameters use Base64 encoding format. Do not add any prefix such as data:image/png;base64, before the Base64 string. The correct format should be the Base64 encoded string directly

Image requirements: Format: .jpg, .jpeg, .png Size: Less than 10MB Dimensions: Width and height at least 300px

---

watermark_info array

Whether to generate results with watermarks simultaneously

Defined via the enabled parameter, specific 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 the task status changes

---

external_task_id string

Custom task ID

User-defined task ID, will not overwrite the system-generated task ID when provided, but supports task query via this ID

Please note that uniqueness must be ensured under a single user

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

{
  "request_id": "task_01hxyz...",
  "response_url": "https://odirouter.ai/model/v1/queue/kling-v2-1-i2v/requests/task_01hxyz.../response",
  "status_url": "https://odirouter.ai/model/v1/queue/kling-v2-1-i2v/requests/task_01hxyz.../status",
  "cancel_url": "https://odirouter.ai/model/v1/queue/kling-v2-1-i2v/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	Текущая позиция в очереди.

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

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

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

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

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