Kling Video to Audio

kling-video-to-audio Kling Video to Audio добавляет к видео длительностью 3–20 секунд звуковые эффекты и фоновую музыку по промптам, с опциональным ASMR-режимом для повышенной детализации.

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

Передайте ровно один основной видеоисточник: video_url или video_id. Они не могут быть пустыми одновременно и не могут передаваться вместе.

Эндпоинты

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

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

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

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

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

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/kling-video-to-audio' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "video_url": "https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/20fps-7s.mov",
  "sound_effect_prompt": "footsteps on wet pavement and distant city traffic",
  "bgm_prompt": "quiet cinematic piano background music",
  "asmr_mode": false,
  "external_task_id": "",
  "callback_url": ""
}'

video_url string required

Публичный URL видео для генерации аудио. video_url и video_id взаимоисключающие: нужно передать ровно одно из двух значений.

Форматы: mp4, mov

Максимальный размер файла: 100 MB

Длительность видео: 3.0 - 20.0 секунд

video_id string required

ID существующей видео задачи для генерации аудио. video_id и video_url взаимоисключающие: нужно передать ровно одно из двух значений.

Поддерживаются только видео Kling AI, созданные за последние 30 дней, с длительностью 3.0 - 20.0 секунд.

sound_effect_prompt string

Необязательный prompt с описанием нужных звуковых эффектов.

Максимальная длина: 200 символов.

bgm_prompt string

Необязательный prompt с описанием фоновой музыки.

Максимальная длина: 200 символов.

asmr_mode boolean

Включать ли режим ASMR. Этот режим усиливает детальные звуковые эффекты и подходит для иммерсивных сценариев.

true: включить ASMR

false: выключить ASMR

По умолчанию: false

callback_url string

Адрес обратного вызова для изменений статуса задачи. Если он задан, сервер отправляет уведомление о результате задачи.

external_task_id string

Пользовательский ID задачи. Он не заменяет системный ID, но может использоваться для поиска задачи.

Примечание: значение должно быть уникальным для пользователя.

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

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

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

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