Свойства пакетного синтеза для текста в речь

API пакетного синтеза может асинхронно синтезировать большой объем ввода текста (как длинный, так и короткий). Издатели и платформы аудиоконтентов могут создавать длинное звуковое содержимое в пакете. Например: аудио книги, новостные статьи и документы. API пакетного синтеза может создавать синтезированный звук дольше 10 минут.

Некоторые свойства в формате JSON требуются при создании нового задания пакетного синтеза. Другие свойства являются необязательными. Ответ пакетного синтеза содержит другие свойства для предоставления сведений о состоянии синтеза и результатах. Например, outputs.result свойство содержит расположение файлов результатов пакетного синтеза с выходными данными звука и журналами.

Свойства пакетного синтеза

Свойства пакетного синтеза описаны в следующей таблице.

Задержка пакетного синтеза и лучшие практики

При использовании пакетного синтеза для создания синтезированного речи важно учитывать задержку и следовать рекомендациям по достижению оптимальных результатов.

Задержка в пакетном синтезе

Задержка в синтезе пакетов зависит от различных факторов, включая сложность входного текста, количество входных данных в пакете и возможности обработки базового оборудования.

Задержка для пакетного синтеза составляет следующее (приблизительно):

• Задержка в 50% от синтезированных выходных данных речи составляет от 10 до 20 секунд.

• Задержка в 95% случаев синтезированной речи не превышает 120 секунд.

Лучшие практики

При рассмотрении пакетного синтеза для приложения рекомендуется оценить, соответствует ли задержка вашим требованиям. Если задержка соответствует требуемой производительности, пакетный синтез может быть подходящим вариантом. Однако если задержка не соответствует вашим потребностям, можно рассмотреть возможность использования API в режиме реального времени.

Коды состояния HTTP

В разделе подробно описаны коды и сообщения HTTP-ответов из API пакетного синтеза.

HTTP 200 OK

HTTP 200 OK указывает, что запрос выполнен успешно.

Создано HTTP 201

HTTP 201 Создано указывает на успешное выполнение запроса на пакетный синтез (через HTTP POST).

Ошибка HTTP 204

Ошибка HTTP 204 указывает, что запрос выполнен успешно, но ресурс не существует. Например:

• Вы попытались получить или удалить задание синтеза, которое не существует.
• Задание синтеза успешно удалено.

Ошибка HTTP 400

Ниже приведены примеры, которые могут привести к ошибке 400:

• outputFormat не поддерживается или является недопустимым. Укажите допустимое значение формата или оставьте outputFormat пустым, чтобы использовать параметр по умолчанию.
• Число запрошенных текстовых входных данных превысило ограничение в 10 000.
• Вы попытались использовать недопустимый идентификатор развертывания или пользовательский голос, который не был успешно развернут. Убедитесь, что ресурс «Speech» имеет доступ к пользовательскому голосу и что он успешно развернут. Необходимо также убедиться, что в запросе пакетного синтеза сопоставление {"your-custom-voice-name": "your-deployment-ID"} правильно.
• Вы пытались использовать ресурс Речь F0, но регион поддерживает только ценовую категорию ресурсов Стандартная речь.

Ошибка HTTP 404

Не удается найти указанную сущность. Проверьте правильность идентификатора синтеза.

Ошибка HTTP 429

Слишком много последних запросов. Каждое клиентское приложение может отправлять до 100 запросов в 10 секунд для каждого ресурса службы "Речь". Уменьшите количество запросов в секунду.

Ошибка HTTP 500

Ошибка внутреннего сервера HTTP 500 указывает на сбой запроса. Текст ответа содержит сообщение об ошибке.

Пример ошибки HTTP

Ниже приведен пример запроса, который приводит к ошибке HTTP 400, так как inputs свойство требуется для создания задания.

curl -v -X PUT -H "Ocp-Apim-Subscription-Key: YourSpeechKey" -H "Content-Type: application/json" -d '{
    "inputKind": "SSML"
}'  "https://YourResourceName.cognitiveservices.azure.com/texttospeech/batchsyntheses/YourSynthesisId?api-version=2024-04-01"

В этом случае заголовки ответа включают HTTP/1.1 400 Bad Request.

Текст ответа похож на следующий пример JSON:

{
  "error": {
    "code": "BadRequest",
    "message": "The inputs is required."
  }
}

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

• Язык разметки синтеза речи (Speech Synthesis Markup Language, SSML)
• Быстрый старт работы с функции синтеза речи
• Миграция на пакетный синтез