Руководство Kling V1 TTS API по OdiRouter

Редакция OdiRouter

Люди, ищущие Kling V1 TTS API, обычно хотят преобразовать текст в речь, выбрать голос, установить скорость, отправить работу и получить аудиофайл. В документации OdiRouter описан рабочий процесс для конечной точки модели kling-tts. Прежде чем писать код, проверьте OdiRouter model catalog и Kling TTS model page для модели, доступной вашему API-ключу.

Целевая фраза помогает людям найти это руководство, однако одного названия модели недостаточно для определения интеграции. В документации OdiRouter указан маршрут kling-tts. Используйте этот идентификатор и поля на странице модели, не предполагая, что сервис с похожим названием принимает ту же полезную нагрузку или имеет те же ограничения.

Что требуется для рабочего процесса OdiRouter Kling TTS

Документированная модель преобразует текст в речь для закадровой озвучки, голосовых помощников и рабочих процессов с озвученным контентом. Для запроса требуются text, voice_id и voice_language. Можно задать voice_speed, добавить callback_url или включить external_task_id для отслеживания.

В актуальном справочнике модели установлен максимальный лимит в 1,000 символов для text. В нём указаны zh и en в качестве значений языка голоса, а выбранный voice_id должен соответствовать языку. Модель поддерживает скорость от 0.8 до 2.0. Встройте эти проверки в серверную валидацию, а затем, при обновлении рабочего процесса, просмотрите официальную страницу модели.

Создайте задачу TTS, поставленную в очередь.

API многомодальной модели OdiRouter использует базовый URL-адрес https://api.odirouter.ai/model. Маршрут Kling TTS создает задачу по адресу POST /v1/queue/kling-tts. Храните ключ в переменной окружения и выполняйте этот вызов из бэкенда, а не из кода браузера.

export ODIROUTER_API_KEY="replace-with-your-server-side-key"

curl --request POST \
  "https://api.odirouter.ai/model/v1/queue/kling-tts" \
  --header "Authorization: Bearer ${ODIROUTER_API_KEY}" \
  --header "Content-Type: application/json" \
  --data-raw '{
    "text": "Welcome to the audio generation workflow.",
    "voice_id": "oversea_male1",
    "voice_language": "en",
    "voice_speed": 1.0,
    "external_task_id": "your-unique-job-id"
  }'

Используйте голосовой идентификатор, указанный для запрашиваемого языка. Ответ содержит request_id и URL-адреса для проверки статуса, получения результата и отмены. Сохраните эти значения вместе с собственной записью о задаче, чтобы повторные попытки и расследования службы поддержки оставались привязаны к одной и той же задаче.

Проверяйте статус, затем получайте результат

Задачи преобразования текста в речь ставятся в очередь. Используйте возвращённый status_url или сформируйте документированный маршрут статуса как GET /v1/queue/kling-tts/requests/{request_id}/status. Общее руководство по опросу OdiRouter описывает IN_QUEUE и IN_PROGRESS как состояния, при которых всё ещё требуется опрос. Когда задача достигает состояния COMPLETED, проверьте ответ на наличие ошибки, прежде чем запрашивать результат по адресу GET /v1/queue/kling-tts/requests/{request_id}/response.

Для общих задач модели OdiRouter рекомендует интервал опроса от 2 до 5 секунд. Установите тайм-аут, соответствующий пользовательскому опыту вашего продукта, прекратите опрос при достижении конечных состояний и возвращайте вызывающей стороне понятную ошибку. Если пользователь отменяет задачу, используйте документированный маршрут отмены, а не оставляйте ненужную задачу выполняться.

Проверяйте входные данные перед запросом

Валидация на стороне сервера упрощает понимание причин сбоев TTS.

  • Отклоняйте пустой текст и разделяйте длинные сценарии, чтобы каждый запрос соответствовал документированному максимальному числу символов.

  • Проверьте voice_language и выберите voice_id из списка соответствующих языков.

  • Поддерживайте voice_speed в пределах документированного диапазона. Используйте значение по умолчанию только в том случае, если оно соответствует желаемому результату.

  • Делайте каждый external_task_id уникальным, если используете его для поиска или сверки.

  • Храните ключи API в переменных окружения, меняйте их при подозрении на компрометацию и вызывайте OdiRouter из бэкенд-сервиса.

Проверьте доступность и цены перед выпуском

Используйте GET https://api.odirouter.ai/v1/models/catalog, чтобы просмотреть каталог, доступный вашему ключу API. Каталог поддерживает фильтры по модели, поставщику, категории и типу, что помогает избежать развертывания с использованием предполагаемого идентификатора.

Стоимость аудиомоделей может зависеть от количества секунд, входных символов или вызовов. В OdiRouter pricing guidance указано, что страница модели является источником достоверной информации о применимой спецификации цен. Проверьте эту страницу, прежде чем оценивать затраты на эксплуатацию или указывать цену пользователям.

Доступен ли Kling V1 TTS через OdiRouter?

Официальная документация модели OdiRouter определяет этот маршрут преобразования текста в речь как kling-tts. В поисковых запросах могут использоваться другие обозначения версий, поэтому проверьте model catalog с помощью ключа API, который будет выполнять вызов. Каталог и страница модели надёжнее, чем скопированное название модели.

Следующие шаги

Создайте учётную запись OdiRouter, сгенерируйте ключ API и начните с quick-start guide. Затем используйте Kling TTS reference для получения сведений о полях запроса, контракте ответа и актуальных данных модели.

Источники

#API преобразования текста в речь#Kling TTS#Kling V1 TTS API#OdiRouter