조합형 텍스트 음성 변환(Compose TTS)
여러 음성 구간과 쉼을 하나의 오디오 파일로 생성합니다. `segments` 배열에 `tts`와 `pause` 객체를 재생할 순서대로 넣으세요. 각 `tts` 세그먼트는 `POST /v1/text-to-speech`와 동일한 보이스, 모델, 감정, 출력 설정을 지원하며 세그먼트마다 다른 보이스와 모델을 사용할 수 있습니다.
제한 - 전체 세그먼트는 최대 50개이며 `tts` 세그먼트가 최소 1개 필요합니다. - 모든 `tts` 세그먼트의 텍스트 합은 최대 2,000자입니다. - 쉼은 개별 최대 10초, 전체 합계 최대 60초입니다. - 모든 `tts` 세그먼트의 `audio_format`은 같아야 합니다.
크레딧은 `tts` 텍스트 길이의 합만큼 차감되며 쉼에는 차감되지 않습니다. 세그먼트는 병렬로 합성된 뒤 입력 순서대로 반환됩니다. 하나라도 합성에 실패하면 전체 요청이 실패하며 크레딧은 차감되지 않습니다.
응답 성공하면 JSON이 아닌 합성된 오디오 바이너리 데이터를 직접 반환합니다. 응답의 `Content-Type`은 세그먼트에서 요청한 `audio_format`에 따라 `audio/wav` 또는 `audio/mpeg`입니다.
Authorizations
X-API-KEYstringheaderrequiredAPI key for authentication. You can obtain an API key from the Typecast API Console.
Body
application/json음성과 쉼 세그먼트를 순서대로 합성하여 하나의 오디오 파일로 반환하는 요청입니다.
segmentsobject[]required출력 순서대로 나열한 음성과 쉼 세그먼트입니다. 최소 1개, 최대 50개이며 tts 세그먼트가 적어도 하나 필요합니다.
Response
200요청한 `audio_format`에 맞는 바이너리 합성 오디오 데이터
401인증 실패
detailstring문제를 설명하는 오류 메시지
error_codestring구조화된 오류를 식별하는 코드
messagestring구조화된 오류에 대한 설명
402전체 텍스트 길이에 비해 크레딧이 부족한 경우
detailstring문제를 설명하는 오류 메시지
error_codestring구조화된 오류를 식별하는 코드
messagestring구조화된 오류에 대한 설명
422세그먼트가 올바르지 않거나 Compose 제한을 초과했거나 입력 텍스트를 합성할 수 없는 경우
detailstring문제를 설명하는 오류 메시지
error_codestring구조화된 오류를 식별하는 코드
messagestring구조화된 오류에 대한 설명
500하나 이상의 세그먼트를 합성하는 중 예상하지 못한 서버 오류가 발생한 경우
detailstring문제를 설명하는 오류 메시지
error_codestring구조화된 오류를 식별하는 코드
messagestring구조화된 오류에 대한 설명