Kling TTS
kling-tts
Kling TTS преобразует текст в речевое аудио для озвучки, голосовых ассистентов и процессов создания озвученного контента.
Эндпоинты
POST /v1/queue/kling-tts # Создать задачуGET /v1/queue/kling-tts/requests/{request_id}/status # Проверить статусGET /v1/queue/kling-tts/requests/{request_id}/response # Получить результатPUT /v1/queue/kling-tts/requests/{request_id}/cancel # Отменить задачу
Параметры запроса
Заголовок раздела «Параметры запроса»curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/kling-tts' \ --header 'Authorization: Bearer YOUR_API_KEY' \ --header 'Content-Type: application/json' \ --location \ --data-raw '{ "text": "Throughout my time in college, several memorable event left a significant impact on my life", "voice_id": "oversea_male1", "voice_language": "en", "voice_speed": 1}'Текст для синтеза в аудио
Максимальная длина: 1000 символов. При превышении лимита возвращается ошибка.
Система проверяет содержимое текста и возвращает ошибку, если его нельзя обработать.
ID голоса
Доступно несколько голосов. ID голоса привязан к языку голоса; используйте ID, соответствующий значению voice_language.
Preview голоса использует фиксированный preview-текст и не поддерживает пользовательский preview-текст.
Правило именования preview-файла голоса: voice_name#voice_id#voice_language
Язык голоса
По умолчанию: zh
Варианты: zh, en
Язык голоса должен соответствовать выбранному voice_id.
Скорость речи
По умолчанию: 1.0
Допустимый диапазон: 0.8 - 2.0
Точность: 1 знак после запятой. Лишние знаки округляются автоматически.
URL обратного вызова
Пользовательский ID задачи. Он не заменяет системный ID задачи, но может использоваться для поиска задачи.
Примечание: значение должно быть уникальным для каждого пользователя.
Параметры ответа
Заголовок раздела «Параметры ответа»{ "request_id": "task_01hxyz...", "response_url": "https://api.odirouter.ai/model/v1/queue/kling-tts/requests/task_01hxyz.../response", "status_url": "https://api.odirouter.ai/model/v1/queue/kling-tts/requests/task_01hxyz.../status", "cancel_url": "https://api.odirouter.ai/model/v1/queue/kling-tts/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 | Текущая позиция в очереди. |