텍스트 음성 변환의 일괄 처리 합성 속성

일괄 처리 합성 API는 대량의 텍스트 입력(길고 짧음)을 비동기식으로 합성할 수 있습니다. 게시자 및 오디오 콘텐츠 플랫폼은 일괄 처리로 긴 오디오 콘텐츠를 만들 수 있습니다. 예: 오디오 책, 뉴스 기사 및 문서 일괄 처리 합성 API는 10분 이상의 합성 오디오를 만들 수 있습니다.

새 일괄 처리 합성 작업을 만들 때 JSON 형식의 일부 속성이 필요합니다. 다른 속성은 선택 사항입니다. 일괄 처리 합성 응답에는 합성 상태와 결과에 대한 정보를 제공하는 다른 속성이 포함됩니다. 예를 들어 outputs.result 속성에는 오디오 출력과 로그가 있는 일괄 처리 합성 결과 파일의 위치가 포함됩니다.

일괄 처리 합성 속성

일괄 처리 합성 속성은 다음 표에 설명되어 있습니다.

일괄 처리 합성 대기 시간 및 모범 사례

합성된 음성을 생성하기 위해 일괄 처리 합성을 사용하는 경우 관련된 대기 시간을 고려하고 최적의 결과를 달성하기 위한 모범 사례를 따르는 것이 중요합니다.

일괄 처리 합성의 대기 시간

일괄 처리 합성의 대기 시간은 입력 텍스트의 복잡성, 일괄 처리의 입력 수 및 기본 하드웨어의 처리 기능을 비롯한 다양한 요인에 따라 달라집니다.

일괄 처리 합성의 대기 시간은 다음과 같습니다(대략).

• 합성된 음성 출력 50%에 대한 대기 시간은 10-20초 이내입니다.

• 합성된 음성 출력 95%에 대한 대기 시간은 120초 이내입니다.

모범 사례

애플리케이션에 대한 일괄 처리 합성을 고려할 때 대기 시간이 사용자 요구에 적합한지 여부를 평가하는 것이 좋습니다. 대기 시간이 원하는 성능과 일치하는 경우 일괄 처리 합성이 적합한 선택일 수 있습니다. 그러나 대기 시간이 사용자 요구 사항을 충족하지 못하면 실시간 API를 사용하는 것이 좋습니다.

HTTP 상태 코드

섹션에서는 일괄 처리 합성 API의 HTTP 응답 코드 및 메시지에 대해 자세히 설명합니다.

HTTP 200 OK

HTTP 200 OK는 요청이 성공했음을 나타냅니다.

HTTP 201 Created

HTTP 201 Created는 일괄 처리 합성 만들기 요청(HTTP POST를 통해)이 성공했음을 나타냅니다.

HTTP 204 오류

HTTP 204 오류는 요청이 성공했지만 리소스가 존재하지 않음을 나타냅니다. 예시:

• 존재하지 않는 합성 작업을 가져오거나 삭제하려고 했습니다.
• 합성 작업을 성공적으로 삭제했습니다.

HTTP 400 오류

다음은 400 오류가 발생할 수 있는 예입니다.

• outputFormat은 지원되지 않거나 유효하지 않습니다. 유효한 형식 값을 제공하거나 outputFormat을 비워 두어 기본 설정을 사용합니다.
• 요청된 텍스트 입력 수가 10,000개 제한을 초과했습니다.
• 성공적으로 배포되지 않은 잘못된 배포 ID 또는 Custom Voice를 사용하려고 했습니다. 음성 리소스가 Custom Voice에 액세스할 수 있고 Custom Voice가 성공적으로 배포되었는지 확인합니다. 또한 일괄 처리 합성 요청에서 {"your-custom-voice-name": "your-deployment-ID"}의 매핑이 올바른지 확인해야 합니다.
• F0 음성 리소스를 사용하려고 했지만 해당 지역은 표준 음성 리소스 가격 책정 계층만 지원합니다.

HTTP 404 오류

지정된 엔터티를 찾을 수 없습니다. 합성 ID가 올바른지 확인합니다.

HTTP 429 오류

최근 요청이 너무 많습니다. 각 클라이언트 애플리케이션은 각 음성 리소스에 대해 10초당 최대 100개의 요청을 제출할 수 있습니다. 초당 요청 수를 줄입니다.

HTTP 500 오류

HTTP 500 내부 서버 오류는 요청이 실패했음을 나타냅니다. 응답 본문에는 오류 메시지가 포함되어 있습니다.

HTTP 오류 예

다음은 작업을 만드는 데 inputs 속성이 필요하기 때문에 HTTP 400 오류가 발생하는 예제 요청입니다.

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

이 경우 응답 헤더에는 HTTP/1.1 400 Bad Request가 포함됩니다.

응답 본문은 다음 JSON 예제와 유사합니다.

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

다음 단계

• SSML(Speech Synthesis Markup Language)
• 텍스트 음성 변환 빠른 시작
• 일괄 처리 합성으로 마이그레이션