Kling Custom Voices

kling-custom-voices Kling Custom Voices предназначен для клонирования голоса и создания пользовательских голосов.

Эндпоинты

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

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

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

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

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

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/kling-custom-voices' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "voice_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/out.mp3",
  "voice_name": "custom_voice"
}'

voice_name string required

Название голоса. Голоса, которые больше не нужны, можно удалить через API.

Примечание: максимальная длина — 20 символов

voice_url string

URL файла с голосовыми данными

Поддерживаемые форматы: .mp3 / .wav / .mp4 / .mov

Аудио должно содержать только один чистый человеческий голос без фонового шума; длительность должна быть от 5 до 30 секунд

video_id string

Исторический ID работы. Позволяет использовать аудиоматериал из ранее сгенерированной работы.

Для настройки голоса можно использовать только видео, соответствующие следующим условиям:

Видео, сгенерированные моделью V2.6 с параметром sound, установленным в on

Видео, сгенерированные через Lip Sync API

Примечание: Аудио должно содержать только один чистый человеческий голос без фонового шума; длительность должна быть от 5 до 30 секунд

callback_url string

URL обратного вызова

external_task_id string

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

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

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

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

Итоговый бизнес-результат находится в output[0].content[0].text как JSON-строка. Распарсите эту строку, чтобы получить следующие поля:

Поле	Тип	Описание
`voices`	array[object]	Список созданных или возвращенных голосов.
`voices[].voice_id`	string	ID голоса. Используйте это значение в последующих вызовах для выбора пользовательского голоса.
`voices[].voice_name`	string	Название голоса.
`voices[].status`	string	Статус обработки голоса, например `succeed` означает успешное создание.
`voices[].trial_url`	string	URL аудиофайла для прослушивания голоса.
`voices[].owned_by`	string	ID пользователя, которому принадлежит голос.

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