{"openapi":"3.0.3","info":{"title":"APICK 한국어 AI 내레이션 TTS","version":"1.0.0","description":"한국어 대본을 보내면 음성(MP3)과 발화 시각이 맞춰진 ASS 자막을 함께 만들어 줍니다. 작업을 접수한 뒤 상태를 확인하고, 완료되면 두 파일을 내려받는 방식입니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/tts/jobs":{"post":{"summary":"한국어 AI 내레이션 TTS","description":"한국어 대본을 보내면 음성(MP3)과 발화 시각이 맞춰진 ASS 자막을 함께 만들어 줍니다. 작업을 접수한 뒤 상태를 확인하고, 완료되면 두 파일을 내려받는 방식입니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"202":{"description":"작업 접수 완료. 반환된 job_id로 상태를 조회합니다.","content":{"application/json":{"schema":{"type":"object","description":"공개 JSON 응답.","properties":{"data":{"type":"object","properties":{"job_id":{"type":"string","description":"접수 응답에서 받은 작업 ID. 같은 계정의 작업에만 접근할 수 있습니다."},"status":{"type":"string","description":"접수 완료.","enum":["waiting"]},"voice_id":{"type":"string","description":"선택한 목소리 ID."},"character_count":{"type":"integer","description":"공백·문장부호를 포함한 합성 글자 수."}}},"api":{"type":"object","description":"호출 메타데이터.","properties":{"success":{"type":"boolean","description":"API 공통 처리 여부. HTTP 상태·업무 결과와 함께 확인합니다."},"cost":{"type":"number","description":"이번 호출에서 차감한 포인트. 무료 조회·재전송은 0."},"pl_id":{"type":"integer","description":"과금 기록 ID. 과금 기록이 있을 때만 포함합니다."}}}}}}}},"default":{"description":"TTS_REQUEST_INVALID (400·413·422): 목소리·문자 수·발화 구조·입력 크기를 확인하세요.\nTTS_AUTH_FAILED (401): 인증키를 확인하세요.\nTTS_ACCESS_DISABLED (403): 계정의 API 이용 제한 상태를 확인하세요.\nTTS_PAYMENT_REQUIRED (403): 최초 결제를 완료한 뒤 이용하세요.\nTTS_INSUFFICIENT_POINTS (402): 필요한 포인트를 충전하세요.\nTTS_NOT_FOUND (404): 작업·후보 ID와 소유 계정을 확인하세요.\nTTS_JOB_CONFLICT (409): 작업 상태·재시도 회차·같은 멱등 키의 요청 내용을 확인하세요.\nTTS_GENERATION_FAILED (409): 실패 상태를 확인하고 입력을 수정하거나 새 작업을 접수하세요.\nTTS_RESULT_UNAVAILABLE (410): 파일이 이미 다운로드됐거나 보관 기간이 만료됐습니다.\nTTS_TEMPORARILY_UNAVAILABLE (429·503): Retry-After 이후 다시 시도하세요. 재시도 요청에는 같은 멱등 키를 사용하세요.\nTTS_BILLING_FAILED (424): 결제를 완료하지 못했습니다. Retry-After 이후 다시 시도하세요.\nTTS_INTERNAL_ERROR (500): 잠시 후 다시 시도하세요.","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":false,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"합성할 한국어 본문. text와 utterances 중 하나만 사용합니다. 정규화(normalize_text)를 쓰면 1~2,000자, 끄면 8,000자까지입니다(공백·줄바꿈 포함). (string)","example":"오늘 기온은 5℃입니다."},"voice_id":{"type":"string","description":"사용할 목소리의 ID입니다. 목소리 목록에서 고른 값을 넣으며, 생략하면 엔진 기본 목소리로 합성됩니다. 목소리별로 억양·속도·성별이 다릅니다. (string)","example":"Kore"},"style":{"type":"string","description":"자유 서술 낭독 스타일 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"따뜻하고 또렷하게"},"emotion":{"type":"string","description":"감정 표현. 생략 시 기본 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 12가지입니다. neutral = 감정을 넣지 않은 담담한 표현입니다. 안내·낭독의 기본값으로 쓰기 좋습니다. calm = 차분하고 낮은 감정입니다. 안정감이 필요한 안내에 적합합니다. cheerful = 밝고 경쾌한 감정입니다. 광고·환영 문구에 적합합니다. excited = 들뜨고 활기찬 감정입니다. 이벤트·강조 문장에 적합합니다. sad = 슬프고 가라앉은 감정입니다. 서사·추모 문구에 적합합니다. serious = 진지하고 단호한 감정입니다. 공지·경고 문구에 적합합니다. friendly = 친근하고 부드러운 감정입니다. 고객 응대에 적합합니다. empathetic = 공감하고 위로하는 감정입니다. 상담·안내에 적합합니다. confident = 확신에 찬 감정입니다. 발표·제안에 적합합니다. gentle = 조용하고 온화한 감정입니다. 수면·명상 콘텐츠에 적합합니다. whisper = 속삭이듯 작은 목소리입니다. ASMR·몰입형 콘텐츠에 적합합니다. narration = 낭독·해설에 맞춘 톤입니다. 문장 사이 쉼이 자연스럽습니다. (string)","enum":["neutral","calm","cheerful","excited","sad","serious","friendly","empathetic","confident","gentle","whisper","narration"]},"tone":{"type":"string","description":"용도·톤. 생략 시 기본 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 9가지입니다. narration = 낭독·해설에 맞춘 톤입니다. 문장 사이 쉼이 자연스럽습니다. news = 뉴스 앵커처럼 또렷하고 일정한 톤입니다. audiobook = 오디오북 낭독 톤입니다. 긴 문장을 안정적으로 읽습니다. documentary = 다큐멘터리 해설 톤입니다. 차분하고 설명적입니다. ad = 광고 카피에 맞춘 톤입니다. 짧고 리듬감 있게 읽습니다. conversation = 대화하듯 자연스러운 톤입니다. announcement = 안내 방송 톤입니다. 또렷하고 전달력이 좋습니다. tutorial = 설명·강의 톤입니다. 단계 설명에 적합합니다. storytelling = 이야기 들려주는 톤입니다. 감정 변화를 살립니다. (string)","enum":["narration","news","audiobook","documentary","ad","conversation","announcement","tutorial","storytelling"]},"accent":{"type":"string","description":"억양. 생략 시 표준어 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 5가지입니다. standard = 지역색이 없는 표준어 억양입니다. seoul = 서울·수도권 억양입니다. gyeongsang = 경상도 억양입니다. jeolla = 전라도 억양입니다. chungcheong = 충청도 억양입니다. (string)","enum":["standard","seoul","gyeongsang","jeolla","chungcheong"]},"pace":{"type":"string","description":"말 속도 배율 0.5~2.0. 1이 기본 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (number)"},"pitch":{"type":"string","description":"음높이 -12~12 반음. 0이 기본 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (number)"},"volume_gain_db":{"type":"string","description":"음량 보정 -12~12 dB. 0이 기본 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (number)"},"normalize_text":{"type":"string","description":"기본 true true/false로 보내며, 생략하면 서버 기본값이 적용됩니다. true = 이 필드가 나타내는 조건이 성립한 경우, false = 성립하지 않은 경우입니다. 두 값 모두 정상 응답에 올 수 있으며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. (boolean)","example":"true"},"multi_speaker":{"type":"string","description":"멀티화자. Gemini는 화자 2명까지 한 호출, ChatGPT는 발화별 목소리 대화 true = 이 필드가 나타내는 조건이 성립한 경우, false = 성립하지 않은 경우입니다. 두 값 모두 정상 응답에 올 수 있으며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. (boolean)"},"utterances[0][text]":{"type":"string","description":"발화 본문. text와 utterances 중 하나만 사용합니다. 최대 100개 발화입니다. 본문 합계는 정규화(normalize_text)를 쓰면 2,000자, 끄면 8,000자까지입니다. (string)"},"utterances[0][voice_id]":{"type":"string","description":"이 발화에만 쓸 목소리 ID입니다. 생략하면 화자 설정, 그다음 최상위 voice_id를 씁니다. (string)"}},"oneOf":[{"required":["text"],"not":{"required":["utterances[0][text]"]}},{"required":["utterances[0][text]"],"not":{"required":["text"]}}]}}}}}},"/rest/tts/gemini/jobs":{"post":{"summary":"한국어 AI 내레이션 TTS","description":"한국어 대본을 보내면 음성(MP3)과 발화 시각이 맞춰진 ASS 자막을 함께 만들어 줍니다. 작업을 접수한 뒤 상태를 확인하고, 완료되면 두 파일을 내려받는 방식입니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"202":{"description":"작업 접수 완료. 반환된 job_id로 상태를 조회합니다.","content":{"application/json":{"schema":{"type":"object","description":"공개 JSON 응답.","properties":{"data":{"type":"object","properties":{"job_id":{"type":"string","description":"접수 응답에서 받은 작업 ID. 같은 계정의 작업에만 접근할 수 있습니다."},"status":{"type":"string","description":"접수 완료.","enum":["waiting"]},"voice_id":{"type":"string","description":"선택한 목소리 ID."},"character_count":{"type":"integer","description":"공백·문장부호를 포함한 합성 글자 수."}}},"api":{"type":"object","description":"호출 메타데이터.","properties":{"success":{"type":"boolean","description":"API 공통 처리 여부. HTTP 상태·업무 결과와 함께 확인합니다."},"cost":{"type":"number","description":"이번 호출에서 차감한 포인트. 무료 조회·재전송은 0."},"pl_id":{"type":"integer","description":"과금 기록 ID. 과금 기록이 있을 때만 포함합니다."}}}}}}}},"default":{"description":"TTS_REQUEST_INVALID (400·413·422): 목소리·문자 수·발화 구조·입력 크기를 확인하세요.\nTTS_AUTH_FAILED (401): 인증키를 확인하세요.\nTTS_ACCESS_DISABLED (403): 계정의 API 이용 제한 상태를 확인하세요.\nTTS_PAYMENT_REQUIRED (403): 최초 결제를 완료한 뒤 이용하세요.\nTTS_INSUFFICIENT_POINTS (402): 필요한 포인트를 충전하세요.\nTTS_NOT_FOUND (404): 작업·후보 ID와 소유 계정을 확인하세요.\nTTS_JOB_CONFLICT (409): 작업 상태·재시도 회차·같은 멱등 키의 요청 내용을 확인하세요.\nTTS_GENERATION_FAILED (409): 실패 상태를 확인하고 입력을 수정하거나 새 작업을 접수하세요.\nTTS_RESULT_UNAVAILABLE (410): 파일이 이미 다운로드됐거나 보관 기간이 만료됐습니다.\nTTS_TEMPORARILY_UNAVAILABLE (429·503): Retry-After 이후 다시 시도하세요. 재시도 요청에는 같은 멱등 키를 사용하세요.\nTTS_BILLING_FAILED (424): 결제를 완료하지 못했습니다. Retry-After 이후 다시 시도하세요.\nTTS_INTERNAL_ERROR (500): 잠시 후 다시 시도하세요.","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":false,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"합성할 한국어 본문. text와 utterances 중 하나만 사용합니다. 정규화(normalize_text)를 쓰면 1~2,000자, 끄면 8,000자까지입니다(공백·줄바꿈 포함). (string)"},"voice_id":{"type":"string","description":"사용할 목소리의 ID입니다. 목소리 목록에서 고른 값을 넣으며, 생략하면 엔진 기본 목소리로 합성됩니다. 목소리별로 억양·속도·성별이 다릅니다. (string)"},"style":{"type":"string","description":"자유 서술 낭독 스타일 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"emotion":{"type":"string","description":"감정 표현. 생략 시 기본 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 12가지입니다. neutral = 감정을 넣지 않은 담담한 표현입니다. 안내·낭독의 기본값으로 쓰기 좋습니다. calm = 차분하고 낮은 감정입니다. 안정감이 필요한 안내에 적합합니다. cheerful = 밝고 경쾌한 감정입니다. 광고·환영 문구에 적합합니다. excited = 들뜨고 활기찬 감정입니다. 이벤트·강조 문장에 적합합니다. sad = 슬프고 가라앉은 감정입니다. 서사·추모 문구에 적합합니다. serious = 진지하고 단호한 감정입니다. 공지·경고 문구에 적합합니다. friendly = 친근하고 부드러운 감정입니다. 고객 응대에 적합합니다. empathetic = 공감하고 위로하는 감정입니다. 상담·안내에 적합합니다. confident = 확신에 찬 감정입니다. 발표·제안에 적합합니다. gentle = 조용하고 온화한 감정입니다. 수면·명상 콘텐츠에 적합합니다. whisper = 속삭이듯 작은 목소리입니다. ASMR·몰입형 콘텐츠에 적합합니다. narration = 낭독·해설에 맞춘 톤입니다. 문장 사이 쉼이 자연스럽습니다. (string)","enum":["neutral","calm","cheerful","excited","sad","serious","friendly","empathetic","confident","gentle","whisper","narration"]},"tone":{"type":"string","description":"용도·톤. 생략 시 기본 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 9가지입니다. narration = 낭독·해설에 맞춘 톤입니다. 문장 사이 쉼이 자연스럽습니다. news = 뉴스 앵커처럼 또렷하고 일정한 톤입니다. audiobook = 오디오북 낭독 톤입니다. 긴 문장을 안정적으로 읽습니다. documentary = 다큐멘터리 해설 톤입니다. 차분하고 설명적입니다. ad = 광고 카피에 맞춘 톤입니다. 짧고 리듬감 있게 읽습니다. conversation = 대화하듯 자연스러운 톤입니다. announcement = 안내 방송 톤입니다. 또렷하고 전달력이 좋습니다. tutorial = 설명·강의 톤입니다. 단계 설명에 적합합니다. storytelling = 이야기 들려주는 톤입니다. 감정 변화를 살립니다. (string)","enum":["narration","news","audiobook","documentary","ad","conversation","announcement","tutorial","storytelling"]},"accent":{"type":"string","description":"억양. 생략 시 표준어 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 5가지입니다. standard = 지역색이 없는 표준어 억양입니다. seoul = 서울·수도권 억양입니다. gyeongsang = 경상도 억양입니다. jeolla = 전라도 억양입니다. chungcheong = 충청도 억양입니다. (string)","enum":["standard","seoul","gyeongsang","jeolla","chungcheong"]},"pace":{"type":"string","description":"말 속도 배율 0.5~2.0. 1이 기본 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (number)"},"pitch":{"type":"string","description":"음높이 -12~12 반음. 0이 기본 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (number)"},"volume_gain_db":{"type":"string","description":"음량 보정 -12~12 dB. 0이 기본 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (number)"},"normalize_text":{"type":"string","description":"기본 true true/false로 보내며, 생략하면 서버 기본값이 적용됩니다. true = 이 필드가 나타내는 조건이 성립한 경우, false = 성립하지 않은 경우입니다. 두 값 모두 정상 응답에 올 수 있으며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. (boolean)"},"multi_speaker":{"type":"string","description":"멀티화자. Gemini는 화자 2명까지 한 호출, ChatGPT는 발화별 목소리 대화 true = 이 필드가 나타내는 조건이 성립한 경우, false = 성립하지 않은 경우입니다. 두 값 모두 정상 응답에 올 수 있으며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. (boolean)"},"utterances[0][text]":{"type":"string","description":"발화 본문. text와 utterances 중 하나만 사용합니다. 최대 100개 발화입니다. 본문 합계는 정규화(normalize_text)를 쓰면 2,000자, 끄면 8,000자까지입니다. (string)"},"utterances[0][voice_id]":{"type":"string","description":"이 발화에만 쓸 목소리 ID입니다. 생략하면 화자 설정, 그다음 최상위 voice_id를 씁니다. (string)"}}}}}}}},"/rest/tts/openai/jobs":{"post":{"summary":"한국어 AI 내레이션 TTS","description":"한국어 대본을 보내면 음성(MP3)과 발화 시각이 맞춰진 ASS 자막을 함께 만들어 줍니다. 작업을 접수한 뒤 상태를 확인하고, 완료되면 두 파일을 내려받는 방식입니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"202":{"description":"작업 접수 완료. 반환된 job_id로 상태를 조회합니다.","content":{"application/json":{"schema":{"type":"object","description":"공개 JSON 응답.","properties":{"data":{"type":"object","properties":{"job_id":{"type":"string","description":"접수 응답에서 받은 작업 ID. 같은 계정의 작업에만 접근할 수 있습니다."},"status":{"type":"string","description":"접수 완료.","enum":["waiting"]},"voice_id":{"type":"string","description":"선택한 목소리 ID."},"character_count":{"type":"integer","description":"공백·문장부호를 포함한 합성 글자 수."}}},"api":{"type":"object","description":"호출 메타데이터.","properties":{"success":{"type":"boolean","description":"API 공통 처리 여부. HTTP 상태·업무 결과와 함께 확인합니다."},"cost":{"type":"number","description":"이번 호출에서 차감한 포인트. 무료 조회·재전송은 0."},"pl_id":{"type":"integer","description":"과금 기록 ID. 과금 기록이 있을 때만 포함합니다."}}}}}}}},"default":{"description":"TTS_REQUEST_INVALID (400·413·422): 목소리·문자 수·발화 구조·입력 크기를 확인하세요.\nTTS_AUTH_FAILED (401): 인증키를 확인하세요.\nTTS_ACCESS_DISABLED (403): 계정의 API 이용 제한 상태를 확인하세요.\nTTS_PAYMENT_REQUIRED (403): 최초 결제를 완료한 뒤 이용하세요.\nTTS_INSUFFICIENT_POINTS (402): 필요한 포인트를 충전하세요.\nTTS_NOT_FOUND (404): 작업·후보 ID와 소유 계정을 확인하세요.\nTTS_JOB_CONFLICT (409): 작업 상태·재시도 회차·같은 멱등 키의 요청 내용을 확인하세요.\nTTS_GENERATION_FAILED (409): 실패 상태를 확인하고 입력을 수정하거나 새 작업을 접수하세요.\nTTS_RESULT_UNAVAILABLE (410): 파일이 이미 다운로드됐거나 보관 기간이 만료됐습니다.\nTTS_TEMPORARILY_UNAVAILABLE (429·503): Retry-After 이후 다시 시도하세요. 재시도 요청에는 같은 멱등 키를 사용하세요.\nTTS_BILLING_FAILED (424): 결제를 완료하지 못했습니다. Retry-After 이후 다시 시도하세요.\nTTS_INTERNAL_ERROR (500): 잠시 후 다시 시도하세요.","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":false,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"합성할 한국어 본문. text와 utterances 중 하나만 사용합니다. 정규화(normalize_text)를 쓰면 1~2,000자, 끄면 8,000자까지입니다(공백·줄바꿈 포함). (string)"},"voice_id":{"type":"string","description":"사용할 목소리의 ID입니다. 목소리 목록에서 고른 값을 넣으며, 생략하면 엔진 기본 목소리로 합성됩니다. 목소리별로 억양·속도·성별이 다릅니다. (string)"},"style":{"type":"string","description":"자유 서술 낭독 스타일 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"emotion":{"type":"string","description":"감정 표현. 생략 시 기본 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 12가지입니다. neutral = 감정을 넣지 않은 담담한 표현입니다. 안내·낭독의 기본값으로 쓰기 좋습니다. calm = 차분하고 낮은 감정입니다. 안정감이 필요한 안내에 적합합니다. cheerful = 밝고 경쾌한 감정입니다. 광고·환영 문구에 적합합니다. excited = 들뜨고 활기찬 감정입니다. 이벤트·강조 문장에 적합합니다. sad = 슬프고 가라앉은 감정입니다. 서사·추모 문구에 적합합니다. serious = 진지하고 단호한 감정입니다. 공지·경고 문구에 적합합니다. friendly = 친근하고 부드러운 감정입니다. 고객 응대에 적합합니다. empathetic = 공감하고 위로하는 감정입니다. 상담·안내에 적합합니다. confident = 확신에 찬 감정입니다. 발표·제안에 적합합니다. gentle = 조용하고 온화한 감정입니다. 수면·명상 콘텐츠에 적합합니다. whisper = 속삭이듯 작은 목소리입니다. ASMR·몰입형 콘텐츠에 적합합니다. narration = 낭독·해설에 맞춘 톤입니다. 문장 사이 쉼이 자연스럽습니다. (string)","enum":["neutral","calm","cheerful","excited","sad","serious","friendly","empathetic","confident","gentle","whisper","narration"]},"tone":{"type":"string","description":"용도·톤. 생략 시 기본 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 9가지입니다. narration = 낭독·해설에 맞춘 톤입니다. 문장 사이 쉼이 자연스럽습니다. news = 뉴스 앵커처럼 또렷하고 일정한 톤입니다. audiobook = 오디오북 낭독 톤입니다. 긴 문장을 안정적으로 읽습니다. documentary = 다큐멘터리 해설 톤입니다. 차분하고 설명적입니다. ad = 광고 카피에 맞춘 톤입니다. 짧고 리듬감 있게 읽습니다. conversation = 대화하듯 자연스러운 톤입니다. announcement = 안내 방송 톤입니다. 또렷하고 전달력이 좋습니다. tutorial = 설명·강의 톤입니다. 단계 설명에 적합합니다. storytelling = 이야기 들려주는 톤입니다. 감정 변화를 살립니다. (string)","enum":["narration","news","audiobook","documentary","ad","conversation","announcement","tutorial","storytelling"]},"accent":{"type":"string","description":"억양. 생략 시 표준어 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 5가지입니다. standard = 지역색이 없는 표준어 억양입니다. seoul = 서울·수도권 억양입니다. gyeongsang = 경상도 억양입니다. jeolla = 전라도 억양입니다. chungcheong = 충청도 억양입니다. (string)","enum":["standard","seoul","gyeongsang","jeolla","chungcheong"]},"pace":{"type":"string","description":"말 속도 배율 0.5~2.0. 1이 기본 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (number)"},"pitch":{"type":"string","description":"음높이 -12~12 반음. 0이 기본 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (number)"},"volume_gain_db":{"type":"string","description":"음량 보정 -12~12 dB. 0이 기본 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (number)"},"normalize_text":{"type":"string","description":"기본 true true/false로 보내며, 생략하면 서버 기본값이 적용됩니다. true = 이 필드가 나타내는 조건이 성립한 경우, false = 성립하지 않은 경우입니다. 두 값 모두 정상 응답에 올 수 있으며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. (boolean)"},"multi_speaker":{"type":"string","description":"멀티화자. Gemini는 화자 2명까지 한 호출, ChatGPT는 발화별 목소리 대화 true = 이 필드가 나타내는 조건이 성립한 경우, false = 성립하지 않은 경우입니다. 두 값 모두 정상 응답에 올 수 있으며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. (boolean)"},"utterances[0][text]":{"type":"string","description":"발화 본문. text와 utterances 중 하나만 사용합니다. 최대 100개 발화입니다. 본문 합계는 정규화(normalize_text)를 쓰면 2,000자, 끄면 8,000자까지입니다. (string)"},"utterances[0][voice_id]":{"type":"string","description":"이 발화에만 쓸 목소리 ID입니다. 생략하면 화자 설정, 그다음 최상위 voice_id를 씁니다. (string)"}}}}}}}},"/rest/tts/jobs/{job_id}":{"get":{"summary":"한국어 AI 내레이션 TTS","description":"한국어 대본을 보내면 음성(MP3)과 발화 시각이 맞춰진 ASS 자막을 함께 만들어 줍니다. 작업을 접수한 뒤 상태를 확인하고, 완료되면 두 파일을 내려받는 방식입니다.","security":[{"bearerAuth":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"서비스 응답","content":{"application/json":{"schema":{"type":"object","description":"공개 JSON 응답.","properties":{"data":{"type":"object","properties":{"job_id":{"type":"string","description":"접수 응답에서 받은 작업 ID. 같은 계정의 작업에만 접근할 수 있습니다."},"status":{"type":"string","description":"작업 진행 상태. 완료 여부와 다운로드 가능 여부를 함께 확인합니다.","enum":["waiting","processing","completed","cancelled","failed"]},"result_available":{"type":"boolean","description":"최종 MP3를 내려받을 수 있는지 여부."},"subtitles_available":{"type":"boolean","description":"자막을 내려받을 수 있는지 여부."},"resume_revision":{"type":"integer","description":"재시도 회차. 0은 최초 생성이며 재시도할 때 증가합니다.","minimum":0},"quality":{"type":"object","description":"품질 상세. 아직 검사 전이면 null이거나 생략됩니다.","properties":{"schema_version":{"type":"string","description":"품질 결과 JSON의 규격 버전입니다. 필드 구성이 바뀔 때 증가하며, 클라이언트는 이 값을 기준으로 호환성을 판단할 수 있습니다."},"attempt":{"type":"integer","description":"현재 품질 검사가 몇 번째 시도인지 나타냅니다. 재검사할 때마다 증가하며, 후보별 attempt와 다를 수 있습니다."},"phase":{"type":"string","description":"작업이 현재 어느 처리 단계에 있는지 나타냅니다. waiting·processing·completed·failed 같은 값으로 진행 상태를 구분합니다."},"accepted_utterances":{"type":"integer","description":"품질 검사를 통과한 발화 수입니다. 전체 발화 수와 비교해 실패·미검사 발화를 파악하세요."},"failed_utterances":{"type":"integer","description":"품질 검사에서 실패한 발화 수입니다. 0이 아니면 실패 사유와 재시도 필요 여부를 함께 확인하세요."},"total_utterances":{"type":"integer","description":"이 작업에 포함된 전체 발화 수입니다. accepted_utterances + failed_utterances와 같거나, 아직 검사 전인 발화가 있으면 더 클 수 있습니다."},"expires_at":{"type":"string","description":"후보 음원·검사 결과를 보관하는 만료 시각입니다. 이 시각이 지나면 후보 다운로드가 불가능할 수 있으며, 검사 전에는 null입니다.","nullable":true},"queue_elapsed_sec":{"type":"number","description":"작업이 대기열에서 기다린 시간(초)입니다. 생성 시간과 분리해 지연 원인을 파악할 때 사용합니다."},"generation_elapsed_sec":{"type":"number","description":"실제 음성 생성에 걸린 시간(초)입니다. 대기 시간을 제외한 처리 시간입니다."},"utterances":{"type":"array","description":"발화별 품질 검사 결과 목록입니다. 각 항목은 발화 ID·후보 ID·속도·반복·참조 검사 값을 포함합니다.","items":{"type":"object","description":"발화·음원 후보별 공개 검사 결과. 단계별로 제공되는 항목만 포함합니다.","properties":{"id":{"type":"string","description":"이 검사 항목의 식별자입니다. 같은 응답 안에서 항목을 구분할 때 사용하며, 발화 ID와 다를 수 있습니다."},"utterance_id":{"type":"string","description":"검사 대상 발화의 식별자입니다. 요청의 utterances 순서대로 u001·u002처럼 부여되며, 같은 발화의 여러 후보를 묶을 때 사용합니다."},"candidate_id":{"type":"string","description":"생성된 음성 후보의 식별자입니다. 같은 발화에 후보가 여러 개일 때 각 후보를 구분하며, 후보 오디오 경로에 사용합니다."},"status":{"type":"string","description":"이 항목의 처리·검사 상태입니다. waiting·processing·completed·failed 같은 값이 들어가며, 실패 사유는 reasons에서 확인하세요."},"attempt":{"type":"integer","description":"이 후보를 생성한 시도 회차입니다. 1부터 시작하며 재생성할 때마다 증가합니다."},"voice_id":{"type":"string","description":"합성에 사용한 공개 목소리 ID입니다. 요청의 voice_id와 같으며, 목소리 목록 API에서 확인한 값을 그대로 반영합니다."},"created_at":{"type":"string","description":"이 발화·후보가 생성된 시각입니다. ISO 8601 형식이며 시간대가 포함됩니다."},"elapsed_sec":{"type":"number","description":"이 항목의 생성·검사에 걸린 경과 시간(초)입니다. 대기열에서 기다린 시간은 포함하지 않을 수 있습니다."},"reasons":{"type":"array","description":"검사·실패 사유 목록입니다. 통과·주의·실패 판정의 근거가 문장으로 들어가며, 사유가 없으면 빈 배열입니다.","items":{"type":"string","description":"검사 결과 사유."}},"speech_rate":{"type":"object","description":"발화 속도 검사. 검사 단계에 따라 일부 필드는 생략됩니다.","properties":{"characters":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. 공백과 문장부호를 포함하며, chars와 같은 값을 다른 이름으로 제공합니다."},"chars":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. characters와 동일한 값이며, 기존 클라이언트 호환을 위해 함께 제공됩니다."},"duration_sec":{"type":"number","description":"측정된 음성의 실제 길이(초)입니다. 무음 구간이 포함될 수 있고, 초당 글자 수 계산의 기준이 됩니다."},"duration_ms":{"type":"number","description":"측정된 음성의 실제 길이(밀리초)입니다. duration_sec와 같은 값을 단위만 바꿔 제공합니다."},"cps":{"type":"number","description":"초당 발화 글자 수입니다. 값이 높을수록 빠르게 말한 것이며, min_cps보다 낮으면 지나치게 느린 발화로 판정될 수 있습니다."},"expected_sec":{"type":"number","description":"같은 글자 수를 기준 속도로 읽었을 때 예상되는 발화 길이(초)입니다. 실제 길이와 비교해 속도 편차를 계산합니다."},"expected_duration_ms":{"type":"number","description":"예상 발화 길이(밀리초)입니다. expected_sec와 같은 값을 단위만 바꿔 제공합니다."},"duration_ratio":{"type":"number","description":"실제 음성 길이를 예상 길이로 나눈 비율입니다. 1보다 크면 예상보다 느리고, 1보다 작으면 빠릅니다. 계산할 수 없으면 null입니다.","nullable":true},"min_cps":{"type":"number","description":"이 검사에서 허용하는 최소 초당 글자 수입니다. cps가 이 값보다 낮으면 속도 검사에서 주의·실패로 표시됩니다."},"minimum_characters":{"type":"integer","description":"속도 검사를 수행하는 데 필요한 최소 글자 수입니다. 이보다 짧은 발화는 속도 판정을 생략할 수 있습니다."},"status":{"type":"string","description":"속도 검사 결과입니다. 통과·주의·실패 같은 판정 값이 들어가며, 상세 사유는 같은 항목의 reasons를 확인하세요."}}},"audio_sha256":{"type":"string","description":"후보 음원의 SHA-256 해시입니다. 같은 음원인지 무결성을 비교할 때 사용하며, 음원이 없으면 생략됩니다."},"audio_duration_ms":{"type":"number","description":"후보 음원의 실제 길이(밀리초)입니다. 발화 속도·무음 구간 검사의 기준 값으로 사용됩니다."},"audio_available":{"type":"boolean","description":"이 후보의 음원을 다운로드할 수 있는지 여부입니다. false면 생성 실패·보관 만료 등으로 파일이 없습니다."},"transcript":{"type":"string","description":"후보 음원에서 음성 인식으로 얻은 텍스트입니다. 원문과 비교해 CER·coverage를 계산합니다."},"cer":{"type":"number","description":"문자 오류율(Character Error Rate)입니다. 0에 가까울수록 원문과 정확히 일치하며, 1 이상이면 많은 문자가 틀렸다는 뜻입니다."},"coverage":{"type":"number","description":"원문 글자 중 음성에서 실제로 인식된 비율입니다. 1에 가까울수록 원문을 빠짐없이 읽었습니다."},"repeat":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"reference_intrusion":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"text_qa_status":{"type":"string","description":"합성 텍스트와 인식 텍스트의 일치 검사 상태입니다. 통과·주의·실패 값이 들어가며, 상세 사유는 reasons를 확인하세요."},"active_start_ms":{"type":"number","description":"음원에서 실제 발화가 시작된 위치(밀리초)입니다. 앞부분 무음 구간을 제외한 유효 음성의 시작점입니다."},"active_end_ms":{"type":"number","description":"음원에서 실제 발화가 끝난 위치(밀리초)입니다. 뒷부분 무음·보호 구간을 제외한 유효 음성의 끝점입니다."},"tail_guard_attached":{"type":"boolean","description":"끝부분 잘림을 확인하기 위한 보호 구간이 음원에 붙었는지 여부입니다. 검사용으로만 쓰며 최종 음원에는 포함되지 않습니다."},"tail_verified":{"type":"boolean","description":"끝부분까지 정상적으로 생성됐는지 검증을 마쳤는지 여부입니다. false면 끝단 검사가 아직 끝나지 않았습니다."},"tail_verified_at_ms":{"type":"number","description":"끝부분 검증을 수행한 시각(밀리초)입니다. 검증 전에는 null이며, 값이 있으면 tail_verified와 함께 확인하세요.","nullable":true},"tail_body_end_at_ms":{"type":"number","description":"보호 구간을 제외한 실제 본문의 끝 위치(밀리초)입니다. 잘림 판정의 기준점으로 사용됩니다.","nullable":true},"tail_guard_attached_chunk_ids":{"type":"array","description":"보호 구간이 붙은 음성 구간 ID 목록입니다. 어느 구간까지 끝단 검사를 적용했는지 확인할 때 사용합니다.","items":{"type":"string","description":"확인한 구간 ID."}},"generation_budget_exhausted":{"type":"boolean","description":"이 발화의 자동 생성 시도 한도를 모두 사용했는지 여부입니다. true면 같은 조건으로는 더 이상 자동 재생성되지 않습니다."},"retry_requires_new_regeneration_key":{"type":"boolean","description":"재시도에 새 재생성 키가 필요한 상태인지 여부입니다. true면 기존 요청을 반복해도 새 후보가 생성되지 않습니다."},"candidate_revision":{"type":"integer","description":"재시도 회차. 0은 최초 생성이며 재시도할 때 증가합니다.","minimum":0}}}},"candidates":{"type":"array","description":"음성 후보별 품질 검사 결과 목록입니다. 같은 발화의 여러 후보를 비교해 최종 후보를 고를 때 사용합니다.","items":{"type":"object","description":"발화·음원 후보별 공개 검사 결과. 단계별로 제공되는 항목만 포함합니다.","properties":{"id":{"type":"string","description":"이 검사 항목의 식별자입니다. 같은 응답 안에서 항목을 구분할 때 사용하며, 발화 ID와 다를 수 있습니다."},"utterance_id":{"type":"string","description":"검사 대상 발화의 식별자입니다. 요청의 utterances 순서대로 u001·u002처럼 부여되며, 같은 발화의 여러 후보를 묶을 때 사용합니다."},"candidate_id":{"type":"string","description":"생성된 음성 후보의 식별자입니다. 같은 발화에 후보가 여러 개일 때 각 후보를 구분하며, 후보 오디오 경로에 사용합니다."},"status":{"type":"string","description":"이 항목의 처리·검사 상태입니다. waiting·processing·completed·failed 같은 값이 들어가며, 실패 사유는 reasons에서 확인하세요."},"attempt":{"type":"integer","description":"이 후보를 생성한 시도 회차입니다. 1부터 시작하며 재생성할 때마다 증가합니다."},"voice_id":{"type":"string","description":"합성에 사용한 공개 목소리 ID입니다. 요청의 voice_id와 같으며, 목소리 목록 API에서 확인한 값을 그대로 반영합니다."},"created_at":{"type":"string","description":"이 발화·후보가 생성된 시각입니다. ISO 8601 형식이며 시간대가 포함됩니다."},"elapsed_sec":{"type":"number","description":"이 항목의 생성·검사에 걸린 경과 시간(초)입니다. 대기열에서 기다린 시간은 포함하지 않을 수 있습니다."},"reasons":{"type":"array","description":"검사·실패 사유 목록입니다. 통과·주의·실패 판정의 근거가 문장으로 들어가며, 사유가 없으면 빈 배열입니다.","items":{"type":"string","description":"검사 결과 사유."}},"speech_rate":{"type":"object","description":"발화 속도 검사. 검사 단계에 따라 일부 필드는 생략됩니다.","properties":{"characters":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. 공백과 문장부호를 포함하며, chars와 같은 값을 다른 이름으로 제공합니다."},"chars":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. characters와 동일한 값이며, 기존 클라이언트 호환을 위해 함께 제공됩니다."},"duration_sec":{"type":"number","description":"측정된 음성의 실제 길이(초)입니다. 무음 구간이 포함될 수 있고, 초당 글자 수 계산의 기준이 됩니다."},"duration_ms":{"type":"number","description":"측정된 음성의 실제 길이(밀리초)입니다. duration_sec와 같은 값을 단위만 바꿔 제공합니다."},"cps":{"type":"number","description":"초당 발화 글자 수입니다. 값이 높을수록 빠르게 말한 것이며, min_cps보다 낮으면 지나치게 느린 발화로 판정될 수 있습니다."},"expected_sec":{"type":"number","description":"같은 글자 수를 기준 속도로 읽었을 때 예상되는 발화 길이(초)입니다. 실제 길이와 비교해 속도 편차를 계산합니다."},"expected_duration_ms":{"type":"number","description":"예상 발화 길이(밀리초)입니다. expected_sec와 같은 값을 단위만 바꿔 제공합니다."},"duration_ratio":{"type":"number","description":"실제 음성 길이를 예상 길이로 나눈 비율입니다. 1보다 크면 예상보다 느리고, 1보다 작으면 빠릅니다. 계산할 수 없으면 null입니다.","nullable":true},"min_cps":{"type":"number","description":"이 검사에서 허용하는 최소 초당 글자 수입니다. cps가 이 값보다 낮으면 속도 검사에서 주의·실패로 표시됩니다."},"minimum_characters":{"type":"integer","description":"속도 검사를 수행하는 데 필요한 최소 글자 수입니다. 이보다 짧은 발화는 속도 판정을 생략할 수 있습니다."},"status":{"type":"string","description":"속도 검사 결과입니다. 통과·주의·실패 같은 판정 값이 들어가며, 상세 사유는 같은 항목의 reasons를 확인하세요."}}},"audio_sha256":{"type":"string","description":"후보 음원의 SHA-256 해시입니다. 같은 음원인지 무결성을 비교할 때 사용하며, 음원이 없으면 생략됩니다."},"audio_duration_ms":{"type":"number","description":"후보 음원의 실제 길이(밀리초)입니다. 발화 속도·무음 구간 검사의 기준 값으로 사용됩니다."},"audio_available":{"type":"boolean","description":"이 후보의 음원을 다운로드할 수 있는지 여부입니다. false면 생성 실패·보관 만료 등으로 파일이 없습니다."},"transcript":{"type":"string","description":"후보 음원에서 음성 인식으로 얻은 텍스트입니다. 원문과 비교해 CER·coverage를 계산합니다."},"cer":{"type":"number","description":"문자 오류율(Character Error Rate)입니다. 0에 가까울수록 원문과 정확히 일치하며, 1 이상이면 많은 문자가 틀렸다는 뜻입니다."},"coverage":{"type":"number","description":"원문 글자 중 음성에서 실제로 인식된 비율입니다. 1에 가까울수록 원문을 빠짐없이 읽었습니다."},"repeat":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"reference_intrusion":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"text_qa_status":{"type":"string","description":"합성 텍스트와 인식 텍스트의 일치 검사 상태입니다. 통과·주의·실패 값이 들어가며, 상세 사유는 reasons를 확인하세요."},"active_start_ms":{"type":"number","description":"음원에서 실제 발화가 시작된 위치(밀리초)입니다. 앞부분 무음 구간을 제외한 유효 음성의 시작점입니다."},"active_end_ms":{"type":"number","description":"음원에서 실제 발화가 끝난 위치(밀리초)입니다. 뒷부분 무음·보호 구간을 제외한 유효 음성의 끝점입니다."},"tail_guard_attached":{"type":"boolean","description":"끝부분 잘림을 확인하기 위한 보호 구간이 음원에 붙었는지 여부입니다. 검사용으로만 쓰며 최종 음원에는 포함되지 않습니다."},"tail_verified":{"type":"boolean","description":"끝부분까지 정상적으로 생성됐는지 검증을 마쳤는지 여부입니다. false면 끝단 검사가 아직 끝나지 않았습니다."},"tail_verified_at_ms":{"type":"number","description":"끝부분 검증을 수행한 시각(밀리초)입니다. 검증 전에는 null이며, 값이 있으면 tail_verified와 함께 확인하세요.","nullable":true},"tail_body_end_at_ms":{"type":"number","description":"보호 구간을 제외한 실제 본문의 끝 위치(밀리초)입니다. 잘림 판정의 기준점으로 사용됩니다.","nullable":true},"tail_guard_attached_chunk_ids":{"type":"array","description":"보호 구간이 붙은 음성 구간 ID 목록입니다. 어느 구간까지 끝단 검사를 적용했는지 확인할 때 사용합니다.","items":{"type":"string","description":"확인한 구간 ID."}},"generation_budget_exhausted":{"type":"boolean","description":"이 발화의 자동 생성 시도 한도를 모두 사용했는지 여부입니다. true면 같은 조건으로는 더 이상 자동 재생성되지 않습니다."},"retry_requires_new_regeneration_key":{"type":"boolean","description":"재시도에 새 재생성 키가 필요한 상태인지 여부입니다. true면 기존 요청을 반복해도 새 후보가 생성되지 않습니다."},"candidate_revision":{"type":"integer","description":"재시도 회차. 0은 최초 생성이며 재시도할 때 증가합니다.","minimum":0}}}},"final_quality":{"type":"object","description":"최종 선택된 음원의 품질 검사 결과입니다. 최종 검사 전에는 null이거나 생략됩니다.","properties":{"schema_version":{"type":"string","description":"품질 결과 JSON의 규격 버전입니다. 필드 구성이 바뀔 때 증가하며, 클라이언트는 이 값을 기준으로 호환성을 판단할 수 있습니다."},"attempt":{"type":"integer","description":"현재 품질 검사가 몇 번째 시도인지 나타냅니다. 재검사할 때마다 증가하며, 후보별 attempt와 다를 수 있습니다."},"phase":{"type":"string","description":"작업이 현재 어느 처리 단계에 있는지 나타냅니다. waiting·processing·completed·failed 같은 값으로 진행 상태를 구분합니다."},"accepted_utterances":{"type":"integer","description":"품질 검사를 통과한 발화 수입니다. 전체 발화 수와 비교해 실패·미검사 발화를 파악하세요."},"failed_utterances":{"type":"integer","description":"품질 검사에서 실패한 발화 수입니다. 0이 아니면 실패 사유와 재시도 필요 여부를 함께 확인하세요."},"total_utterances":{"type":"integer","description":"이 작업에 포함된 전체 발화 수입니다. accepted_utterances + failed_utterances와 같거나, 아직 검사 전인 발화가 있으면 더 클 수 있습니다."},"expires_at":{"type":"string","description":"후보 음원·검사 결과를 보관하는 만료 시각입니다. 이 시각이 지나면 후보 다운로드가 불가능할 수 있으며, 검사 전에는 null입니다.","nullable":true},"queue_elapsed_sec":{"type":"number","description":"작업이 대기열에서 기다린 시간(초)입니다. 생성 시간과 분리해 지연 원인을 파악할 때 사용합니다."},"generation_elapsed_sec":{"type":"number","description":"실제 음성 생성에 걸린 시간(초)입니다. 대기 시간을 제외한 처리 시간입니다."},"utterances":{"type":"array","description":"발화별 품질 검사 결과 목록입니다. 각 항목은 발화 ID·후보 ID·속도·반복·참조 검사 값을 포함합니다.","items":{"type":"object","description":"발화·음원 후보별 공개 검사 결과. 단계별로 제공되는 항목만 포함합니다.","properties":{"id":{"type":"string","description":"이 검사 항목의 식별자입니다. 같은 응답 안에서 항목을 구분할 때 사용하며, 발화 ID와 다를 수 있습니다."},"utterance_id":{"type":"string","description":"검사 대상 발화의 식별자입니다. 요청의 utterances 순서대로 u001·u002처럼 부여되며, 같은 발화의 여러 후보를 묶을 때 사용합니다."},"candidate_id":{"type":"string","description":"생성된 음성 후보의 식별자입니다. 같은 발화에 후보가 여러 개일 때 각 후보를 구분하며, 후보 오디오 경로에 사용합니다."},"status":{"type":"string","description":"이 항목의 처리·검사 상태입니다. waiting·processing·completed·failed 같은 값이 들어가며, 실패 사유는 reasons에서 확인하세요."},"attempt":{"type":"integer","description":"이 후보를 생성한 시도 회차입니다. 1부터 시작하며 재생성할 때마다 증가합니다."},"voice_id":{"type":"string","description":"합성에 사용한 공개 목소리 ID입니다. 요청의 voice_id와 같으며, 목소리 목록 API에서 확인한 값을 그대로 반영합니다."},"created_at":{"type":"string","description":"이 발화·후보가 생성된 시각입니다. ISO 8601 형식이며 시간대가 포함됩니다."},"elapsed_sec":{"type":"number","description":"이 항목의 생성·검사에 걸린 경과 시간(초)입니다. 대기열에서 기다린 시간은 포함하지 않을 수 있습니다."},"reasons":{"type":"array","description":"검사·실패 사유 목록입니다. 통과·주의·실패 판정의 근거가 문장으로 들어가며, 사유가 없으면 빈 배열입니다.","items":{"type":"string","description":"검사 결과 사유."}},"speech_rate":{"type":"object","description":"발화 속도 검사. 검사 단계에 따라 일부 필드는 생략됩니다.","properties":{"characters":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. 공백과 문장부호를 포함하며, chars와 같은 값을 다른 이름으로 제공합니다."},"chars":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. characters와 동일한 값이며, 기존 클라이언트 호환을 위해 함께 제공됩니다."},"duration_sec":{"type":"number","description":"측정된 음성의 실제 길이(초)입니다. 무음 구간이 포함될 수 있고, 초당 글자 수 계산의 기준이 됩니다."},"duration_ms":{"type":"number","description":"측정된 음성의 실제 길이(밀리초)입니다. duration_sec와 같은 값을 단위만 바꿔 제공합니다."},"cps":{"type":"number","description":"초당 발화 글자 수입니다. 값이 높을수록 빠르게 말한 것이며, min_cps보다 낮으면 지나치게 느린 발화로 판정될 수 있습니다."},"expected_sec":{"type":"number","description":"같은 글자 수를 기준 속도로 읽었을 때 예상되는 발화 길이(초)입니다. 실제 길이와 비교해 속도 편차를 계산합니다."},"expected_duration_ms":{"type":"number","description":"예상 발화 길이(밀리초)입니다. expected_sec와 같은 값을 단위만 바꿔 제공합니다."},"duration_ratio":{"type":"number","description":"실제 음성 길이를 예상 길이로 나눈 비율입니다. 1보다 크면 예상보다 느리고, 1보다 작으면 빠릅니다. 계산할 수 없으면 null입니다.","nullable":true},"min_cps":{"type":"number","description":"이 검사에서 허용하는 최소 초당 글자 수입니다. cps가 이 값보다 낮으면 속도 검사에서 주의·실패로 표시됩니다."},"minimum_characters":{"type":"integer","description":"속도 검사를 수행하는 데 필요한 최소 글자 수입니다. 이보다 짧은 발화는 속도 판정을 생략할 수 있습니다."},"status":{"type":"string","description":"속도 검사 결과입니다. 통과·주의·실패 같은 판정 값이 들어가며, 상세 사유는 같은 항목의 reasons를 확인하세요."}}},"audio_sha256":{"type":"string","description":"후보 음원의 SHA-256 해시입니다. 같은 음원인지 무결성을 비교할 때 사용하며, 음원이 없으면 생략됩니다."},"audio_duration_ms":{"type":"number","description":"후보 음원의 실제 길이(밀리초)입니다. 발화 속도·무음 구간 검사의 기준 값으로 사용됩니다."},"audio_available":{"type":"boolean","description":"이 후보의 음원을 다운로드할 수 있는지 여부입니다. false면 생성 실패·보관 만료 등으로 파일이 없습니다."},"transcript":{"type":"string","description":"후보 음원에서 음성 인식으로 얻은 텍스트입니다. 원문과 비교해 CER·coverage를 계산합니다."},"cer":{"type":"number","description":"문자 오류율(Character Error Rate)입니다. 0에 가까울수록 원문과 정확히 일치하며, 1 이상이면 많은 문자가 틀렸다는 뜻입니다."},"coverage":{"type":"number","description":"원문 글자 중 음성에서 실제로 인식된 비율입니다. 1에 가까울수록 원문을 빠짐없이 읽었습니다."},"repeat":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"reference_intrusion":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"text_qa_status":{"type":"string","description":"합성 텍스트와 인식 텍스트의 일치 검사 상태입니다. 통과·주의·실패 값이 들어가며, 상세 사유는 reasons를 확인하세요."},"active_start_ms":{"type":"number","description":"음원에서 실제 발화가 시작된 위치(밀리초)입니다. 앞부분 무음 구간을 제외한 유효 음성의 시작점입니다."},"active_end_ms":{"type":"number","description":"음원에서 실제 발화가 끝난 위치(밀리초)입니다. 뒷부분 무음·보호 구간을 제외한 유효 음성의 끝점입니다."},"tail_guard_attached":{"type":"boolean","description":"끝부분 잘림을 확인하기 위한 보호 구간이 음원에 붙었는지 여부입니다. 검사용으로만 쓰며 최종 음원에는 포함되지 않습니다."},"tail_verified":{"type":"boolean","description":"끝부분까지 정상적으로 생성됐는지 검증을 마쳤는지 여부입니다. false면 끝단 검사가 아직 끝나지 않았습니다."},"tail_verified_at_ms":{"type":"number","description":"끝부분 검증을 수행한 시각(밀리초)입니다. 검증 전에는 null이며, 값이 있으면 tail_verified와 함께 확인하세요.","nullable":true},"tail_body_end_at_ms":{"type":"number","description":"보호 구간을 제외한 실제 본문의 끝 위치(밀리초)입니다. 잘림 판정의 기준점으로 사용됩니다.","nullable":true},"tail_guard_attached_chunk_ids":{"type":"array","description":"보호 구간이 붙은 음성 구간 ID 목록입니다. 어느 구간까지 끝단 검사를 적용했는지 확인할 때 사용합니다.","items":{"type":"string","description":"확인한 구간 ID."}},"generation_budget_exhausted":{"type":"boolean","description":"이 발화의 자동 생성 시도 한도를 모두 사용했는지 여부입니다. true면 같은 조건으로는 더 이상 자동 재생성되지 않습니다."},"retry_requires_new_regeneration_key":{"type":"boolean","description":"재시도에 새 재생성 키가 필요한 상태인지 여부입니다. true면 기존 요청을 반복해도 새 후보가 생성되지 않습니다."},"candidate_revision":{"type":"integer","description":"재시도 회차. 0은 최초 생성이며 재시도할 때 증가합니다.","minimum":0}}}},"candidates":{"type":"array","description":"음성 후보별 품질 검사 결과 목록입니다. 같은 발화의 여러 후보를 비교해 최종 후보를 고를 때 사용합니다.","items":{"type":"object","description":"발화·음원 후보별 공개 검사 결과. 단계별로 제공되는 항목만 포함합니다.","properties":{"id":{"type":"string","description":"이 검사 항목의 식별자입니다. 같은 응답 안에서 항목을 구분할 때 사용하며, 발화 ID와 다를 수 있습니다."},"utterance_id":{"type":"string","description":"검사 대상 발화의 식별자입니다. 요청의 utterances 순서대로 u001·u002처럼 부여되며, 같은 발화의 여러 후보를 묶을 때 사용합니다."},"candidate_id":{"type":"string","description":"생성된 음성 후보의 식별자입니다. 같은 발화에 후보가 여러 개일 때 각 후보를 구분하며, 후보 오디오 경로에 사용합니다."},"status":{"type":"string","description":"이 항목의 처리·검사 상태입니다. waiting·processing·completed·failed 같은 값이 들어가며, 실패 사유는 reasons에서 확인하세요."},"attempt":{"type":"integer","description":"이 후보를 생성한 시도 회차입니다. 1부터 시작하며 재생성할 때마다 증가합니다."},"voice_id":{"type":"string","description":"합성에 사용한 공개 목소리 ID입니다. 요청의 voice_id와 같으며, 목소리 목록 API에서 확인한 값을 그대로 반영합니다."},"created_at":{"type":"string","description":"이 발화·후보가 생성된 시각입니다. ISO 8601 형식이며 시간대가 포함됩니다."},"elapsed_sec":{"type":"number","description":"이 항목의 생성·검사에 걸린 경과 시간(초)입니다. 대기열에서 기다린 시간은 포함하지 않을 수 있습니다."},"reasons":{"type":"array","description":"검사·실패 사유 목록입니다. 통과·주의·실패 판정의 근거가 문장으로 들어가며, 사유가 없으면 빈 배열입니다.","items":{"type":"string","description":"검사 결과 사유."}},"speech_rate":{"type":"object","description":"발화 속도 검사. 검사 단계에 따라 일부 필드는 생략됩니다.","properties":{"characters":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. 공백과 문장부호를 포함하며, chars와 같은 값을 다른 이름으로 제공합니다."},"chars":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. characters와 동일한 값이며, 기존 클라이언트 호환을 위해 함께 제공됩니다."},"duration_sec":{"type":"number","description":"측정된 음성의 실제 길이(초)입니다. 무음 구간이 포함될 수 있고, 초당 글자 수 계산의 기준이 됩니다."},"duration_ms":{"type":"number","description":"측정된 음성의 실제 길이(밀리초)입니다. duration_sec와 같은 값을 단위만 바꿔 제공합니다."},"cps":{"type":"number","description":"초당 발화 글자 수입니다. 값이 높을수록 빠르게 말한 것이며, min_cps보다 낮으면 지나치게 느린 발화로 판정될 수 있습니다."},"expected_sec":{"type":"number","description":"같은 글자 수를 기준 속도로 읽었을 때 예상되는 발화 길이(초)입니다. 실제 길이와 비교해 속도 편차를 계산합니다."},"expected_duration_ms":{"type":"number","description":"예상 발화 길이(밀리초)입니다. expected_sec와 같은 값을 단위만 바꿔 제공합니다."},"duration_ratio":{"type":"number","description":"실제 음성 길이를 예상 길이로 나눈 비율입니다. 1보다 크면 예상보다 느리고, 1보다 작으면 빠릅니다. 계산할 수 없으면 null입니다.","nullable":true},"min_cps":{"type":"number","description":"이 검사에서 허용하는 최소 초당 글자 수입니다. cps가 이 값보다 낮으면 속도 검사에서 주의·실패로 표시됩니다."},"minimum_characters":{"type":"integer","description":"속도 검사를 수행하는 데 필요한 최소 글자 수입니다. 이보다 짧은 발화는 속도 판정을 생략할 수 있습니다."},"status":{"type":"string","description":"속도 검사 결과입니다. 통과·주의·실패 같은 판정 값이 들어가며, 상세 사유는 같은 항목의 reasons를 확인하세요."}}},"audio_sha256":{"type":"string","description":"후보 음원의 SHA-256 해시입니다. 같은 음원인지 무결성을 비교할 때 사용하며, 음원이 없으면 생략됩니다."},"audio_duration_ms":{"type":"number","description":"후보 음원의 실제 길이(밀리초)입니다. 발화 속도·무음 구간 검사의 기준 값으로 사용됩니다."},"audio_available":{"type":"boolean","description":"이 후보의 음원을 다운로드할 수 있는지 여부입니다. false면 생성 실패·보관 만료 등으로 파일이 없습니다."},"transcript":{"type":"string","description":"후보 음원에서 음성 인식으로 얻은 텍스트입니다. 원문과 비교해 CER·coverage를 계산합니다."},"cer":{"type":"number","description":"문자 오류율(Character Error Rate)입니다. 0에 가까울수록 원문과 정확히 일치하며, 1 이상이면 많은 문자가 틀렸다는 뜻입니다."},"coverage":{"type":"number","description":"원문 글자 중 음성에서 실제로 인식된 비율입니다. 1에 가까울수록 원문을 빠짐없이 읽었습니다."},"repeat":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"reference_intrusion":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"text_qa_status":{"type":"string","description":"합성 텍스트와 인식 텍스트의 일치 검사 상태입니다. 통과·주의·실패 값이 들어가며, 상세 사유는 reasons를 확인하세요."},"active_start_ms":{"type":"number","description":"음원에서 실제 발화가 시작된 위치(밀리초)입니다. 앞부분 무음 구간을 제외한 유효 음성의 시작점입니다."},"active_end_ms":{"type":"number","description":"음원에서 실제 발화가 끝난 위치(밀리초)입니다. 뒷부분 무음·보호 구간을 제외한 유효 음성의 끝점입니다."},"tail_guard_attached":{"type":"boolean","description":"끝부분 잘림을 확인하기 위한 보호 구간이 음원에 붙었는지 여부입니다. 검사용으로만 쓰며 최종 음원에는 포함되지 않습니다."},"tail_verified":{"type":"boolean","description":"끝부분까지 정상적으로 생성됐는지 검증을 마쳤는지 여부입니다. false면 끝단 검사가 아직 끝나지 않았습니다."},"tail_verified_at_ms":{"type":"number","description":"끝부분 검증을 수행한 시각(밀리초)입니다. 검증 전에는 null이며, 값이 있으면 tail_verified와 함께 확인하세요.","nullable":true},"tail_body_end_at_ms":{"type":"number","description":"보호 구간을 제외한 실제 본문의 끝 위치(밀리초)입니다. 잘림 판정의 기준점으로 사용됩니다.","nullable":true},"tail_guard_attached_chunk_ids":{"type":"array","description":"보호 구간이 붙은 음성 구간 ID 목록입니다. 어느 구간까지 끝단 검사를 적용했는지 확인할 때 사용합니다.","items":{"type":"string","description":"확인한 구간 ID."}},"generation_budget_exhausted":{"type":"boolean","description":"이 발화의 자동 생성 시도 한도를 모두 사용했는지 여부입니다. true면 같은 조건으로는 더 이상 자동 재생성되지 않습니다."},"retry_requires_new_regeneration_key":{"type":"boolean","description":"재시도에 새 재생성 키가 필요한 상태인지 여부입니다. true면 기존 요청을 반복해도 새 후보가 생성되지 않습니다."},"candidate_revision":{"type":"integer","description":"재시도 회차. 0은 최초 생성이며 재시도할 때 증가합니다.","minimum":0}}}},"status":{"type":"string","description":"최종 선택된 음원의 검사 상태입니다. 통과·주의·실패 값을 확인해 다운로드 가능 여부를 판단하세요."},"audio_sha256":{"type":"string","description":"최종 선택된 음원의 SHA-256 해시입니다. 다운로드한 파일의 무결성을 확인할 때 사용합니다."}}}},"nullable":true},"error":{"type":"object","description":"실패 상태일 때 포함합니다.","properties":{"code":{"type":"string","description":"실패한 작업의 공개 오류코드."},"message":{"type":"string","description":"오류 설명."}}}}},"api":{"type":"object","description":"호출 메타데이터.","properties":{"success":{"type":"boolean","description":"API 공통 처리 여부. HTTP 상태·업무 결과와 함께 확인합니다."},"cost":{"type":"number","description":"이번 호출에서 차감한 포인트. 무료 조회·재전송은 0."},"pl_id":{"type":"integer","description":"과금 기록 ID. 과금 기록이 있을 때만 포함합니다."}}}}}}}},"default":{"description":"TTS_REQUEST_INVALID (400·413·422): 목소리·문자 수·발화 구조·입력 크기를 확인하세요.\nTTS_AUTH_FAILED (401): 인증키를 확인하세요.\nTTS_ACCESS_DISABLED (403): 계정의 API 이용 제한 상태를 확인하세요.\nTTS_PAYMENT_REQUIRED (403): 최초 결제를 완료한 뒤 이용하세요.\nTTS_INSUFFICIENT_POINTS (402): 필요한 포인트를 충전하세요.\nTTS_NOT_FOUND (404): 작업·후보 ID와 소유 계정을 확인하세요.\nTTS_JOB_CONFLICT (409): 작업 상태·재시도 회차·같은 멱등 키의 요청 내용을 확인하세요.\nTTS_GENERATION_FAILED (409): 실패 상태를 확인하고 입력을 수정하거나 새 작업을 접수하세요.\nTTS_RESULT_UNAVAILABLE (410): 파일이 이미 다운로드됐거나 보관 기간이 만료됐습니다.\nTTS_TEMPORARILY_UNAVAILABLE (429·503): Retry-After 이후 다시 시도하세요. 재시도 요청에는 같은 멱등 키를 사용하세요.\nTTS_BILLING_FAILED (424): 결제를 완료하지 못했습니다. Retry-After 이후 다시 시도하세요.\nTTS_INTERNAL_ERROR (500): 잠시 후 다시 시도하세요.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/rest/tts/jobs/{job_id}/cancel":{"post":{"summary":"한국어 AI 내레이션 TTS","description":"한국어 대본을 보내면 음성(MP3)과 발화 시각이 맞춰진 ASS 자막을 함께 만들어 줍니다. 작업을 접수한 뒤 상태를 확인하고, 완료되면 두 파일을 내려받는 방식입니다.","security":[{"bearerAuth":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"서비스 응답","content":{"application/json":{"schema":{"type":"object","description":"공개 JSON 응답.","properties":{"data":{"type":"object","properties":{"job_id":{"type":"string","description":"접수 응답에서 받은 작업 ID. 같은 계정의 작업에만 접근할 수 있습니다."},"status":{"type":"string","description":"취소 완료 상태.","enum":["cancelled"]}}},"api":{"type":"object","description":"호출 메타데이터.","properties":{"success":{"type":"boolean","description":"API 공통 처리 여부. HTTP 상태·업무 결과와 함께 확인합니다."},"cost":{"type":"number","description":"이번 호출에서 차감한 포인트. 무료 조회·재전송은 0."},"pl_id":{"type":"integer","description":"과금 기록 ID. 과금 기록이 있을 때만 포함합니다."}}}}}}}},"default":{"description":"TTS_REQUEST_INVALID (400·413·422): 목소리·문자 수·발화 구조·입력 크기를 확인하세요.\nTTS_AUTH_FAILED (401): 인증키를 확인하세요.\nTTS_ACCESS_DISABLED (403): 계정의 API 이용 제한 상태를 확인하세요.\nTTS_PAYMENT_REQUIRED (403): 최초 결제를 완료한 뒤 이용하세요.\nTTS_INSUFFICIENT_POINTS (402): 필요한 포인트를 충전하세요.\nTTS_NOT_FOUND (404): 작업·후보 ID와 소유 계정을 확인하세요.\nTTS_JOB_CONFLICT (409): 작업 상태·재시도 회차·같은 멱등 키의 요청 내용을 확인하세요.\nTTS_GENERATION_FAILED (409): 실패 상태를 확인하고 입력을 수정하거나 새 작업을 접수하세요.\nTTS_RESULT_UNAVAILABLE (410): 파일이 이미 다운로드됐거나 보관 기간이 만료됐습니다.\nTTS_TEMPORARILY_UNAVAILABLE (429·503): Retry-After 이후 다시 시도하세요. 재시도 요청에는 같은 멱등 키를 사용하세요.\nTTS_BILLING_FAILED (424): 결제를 완료하지 못했습니다. Retry-After 이후 다시 시도하세요.\nTTS_INTERNAL_ERROR (500): 잠시 후 다시 시도하세요.","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":false,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{}}}}}}},"/rest/tts/jobs/{job_id}/result":{"get":{"summary":"한국어 AI 내레이션 TTS","description":"한국어 대본을 보내면 음성(MP3)과 발화 시각이 맞춰진 ASS 자막을 함께 만들어 줍니다. 작업을 접수한 뒤 상태를 확인하고, 완료되면 두 파일을 내려받는 방식입니다.","security":[{"bearerAuth":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"파일 직접 응답","content":{"audio/mpeg":{"schema":{"type":"string","format":"binary"}}}},"default":{"description":"TTS_REQUEST_INVALID (400·413·422): 목소리·문자 수·발화 구조·입력 크기를 확인하세요.\nTTS_AUTH_FAILED (401): 인증키를 확인하세요.\nTTS_ACCESS_DISABLED (403): 계정의 API 이용 제한 상태를 확인하세요.\nTTS_PAYMENT_REQUIRED (403): 최초 결제를 완료한 뒤 이용하세요.\nTTS_INSUFFICIENT_POINTS (402): 필요한 포인트를 충전하세요.\nTTS_NOT_FOUND (404): 작업·후보 ID와 소유 계정을 확인하세요.\nTTS_JOB_CONFLICT (409): 작업 상태·재시도 회차·같은 멱등 키의 요청 내용을 확인하세요.\nTTS_GENERATION_FAILED (409): 실패 상태를 확인하고 입력을 수정하거나 새 작업을 접수하세요.\nTTS_RESULT_UNAVAILABLE (410): 파일이 이미 다운로드됐거나 보관 기간이 만료됐습니다.\nTTS_TEMPORARILY_UNAVAILABLE (429·503): Retry-After 이후 다시 시도하세요. 재시도 요청에는 같은 멱등 키를 사용하세요.\nTTS_BILLING_FAILED (424): 결제를 완료하지 못했습니다. Retry-After 이후 다시 시도하세요.\nTTS_INTERNAL_ERROR (500): 잠시 후 다시 시도하세요.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/rest/tts/jobs/{job_id}/subtitles":{"get":{"summary":"한국어 AI 내레이션 TTS","description":"한국어 대본을 보내면 음성(MP3)과 발화 시각이 맞춰진 ASS 자막을 함께 만들어 줍니다. 작업을 접수한 뒤 상태를 확인하고, 완료되면 두 파일을 내려받는 방식입니다.","security":[{"bearerAuth":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"파일 직접 응답","content":{"text/plain":{"schema":{"type":"string","format":"binary"}}}},"default":{"description":"TTS_REQUEST_INVALID (400·413·422): 목소리·문자 수·발화 구조·입력 크기를 확인하세요.\nTTS_AUTH_FAILED (401): 인증키를 확인하세요.\nTTS_ACCESS_DISABLED (403): 계정의 API 이용 제한 상태를 확인하세요.\nTTS_PAYMENT_REQUIRED (403): 최초 결제를 완료한 뒤 이용하세요.\nTTS_INSUFFICIENT_POINTS (402): 필요한 포인트를 충전하세요.\nTTS_NOT_FOUND (404): 작업·후보 ID와 소유 계정을 확인하세요.\nTTS_JOB_CONFLICT (409): 작업 상태·재시도 회차·같은 멱등 키의 요청 내용을 확인하세요.\nTTS_GENERATION_FAILED (409): 실패 상태를 확인하고 입력을 수정하거나 새 작업을 접수하세요.\nTTS_RESULT_UNAVAILABLE (410): 파일이 이미 다운로드됐거나 보관 기간이 만료됐습니다.\nTTS_TEMPORARILY_UNAVAILABLE (429·503): Retry-After 이후 다시 시도하세요. 재시도 요청에는 같은 멱등 키를 사용하세요.\nTTS_BILLING_FAILED (424): 결제를 완료하지 못했습니다. Retry-After 이후 다시 시도하세요.\nTTS_INTERNAL_ERROR (500): 잠시 후 다시 시도하세요.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/rest/tts/gemini/voices":{"get":{"summary":"한국어 AI 내레이션 TTS","description":"한국어 대본을 보내면 음성(MP3)과 발화 시각이 맞춰진 ASS 자막을 함께 만들어 줍니다. 작업을 접수한 뒤 상태를 확인하고, 완료되면 두 파일을 내려받는 방식입니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스 응답","content":{"application/json":{"schema":{"type":"object","description":"공개 JSON 응답.","properties":{"data":{"type":"object","properties":{"job_id":{"type":"string","description":"접수 응답에서 받은 작업 ID. 같은 계정의 작업에만 접근할 수 있습니다."},"status":{"type":"string","description":"작업 진행 상태. 완료 여부와 다운로드 가능 여부를 함께 확인합니다.","enum":["waiting","processing","completed","cancelled","failed"]},"result_available":{"type":"boolean","description":"최종 MP3를 내려받을 수 있는지 여부."},"subtitles_available":{"type":"boolean","description":"자막을 내려받을 수 있는지 여부."},"resume_revision":{"type":"integer","description":"재시도 회차. 0은 최초 생성이며 재시도할 때 증가합니다.","minimum":0},"quality":{"type":"object","description":"품질 상세. 아직 검사 전이면 null이거나 생략됩니다.","properties":{"schema_version":{"type":"string","description":"품질 결과 JSON의 규격 버전입니다. 필드 구성이 바뀔 때 증가하며, 클라이언트는 이 값을 기준으로 호환성을 판단할 수 있습니다."},"attempt":{"type":"integer","description":"현재 품질 검사가 몇 번째 시도인지 나타냅니다. 재검사할 때마다 증가하며, 후보별 attempt와 다를 수 있습니다."},"phase":{"type":"string","description":"작업이 현재 어느 처리 단계에 있는지 나타냅니다. waiting·processing·completed·failed 같은 값으로 진행 상태를 구분합니다."},"accepted_utterances":{"type":"integer","description":"품질 검사를 통과한 발화 수입니다. 전체 발화 수와 비교해 실패·미검사 발화를 파악하세요."},"failed_utterances":{"type":"integer","description":"품질 검사에서 실패한 발화 수입니다. 0이 아니면 실패 사유와 재시도 필요 여부를 함께 확인하세요."},"total_utterances":{"type":"integer","description":"이 작업에 포함된 전체 발화 수입니다. accepted_utterances + failed_utterances와 같거나, 아직 검사 전인 발화가 있으면 더 클 수 있습니다."},"expires_at":{"type":"string","description":"후보 음원·검사 결과를 보관하는 만료 시각입니다. 이 시각이 지나면 후보 다운로드가 불가능할 수 있으며, 검사 전에는 null입니다.","nullable":true},"queue_elapsed_sec":{"type":"number","description":"작업이 대기열에서 기다린 시간(초)입니다. 생성 시간과 분리해 지연 원인을 파악할 때 사용합니다."},"generation_elapsed_sec":{"type":"number","description":"실제 음성 생성에 걸린 시간(초)입니다. 대기 시간을 제외한 처리 시간입니다."},"utterances":{"type":"array","description":"발화별 품질 검사 결과 목록입니다. 각 항목은 발화 ID·후보 ID·속도·반복·참조 검사 값을 포함합니다.","items":{"type":"object","description":"발화·음원 후보별 공개 검사 결과. 단계별로 제공되는 항목만 포함합니다.","properties":{"id":{"type":"string","description":"이 검사 항목의 식별자입니다. 같은 응답 안에서 항목을 구분할 때 사용하며, 발화 ID와 다를 수 있습니다."},"utterance_id":{"type":"string","description":"검사 대상 발화의 식별자입니다. 요청의 utterances 순서대로 u001·u002처럼 부여되며, 같은 발화의 여러 후보를 묶을 때 사용합니다."},"candidate_id":{"type":"string","description":"생성된 음성 후보의 식별자입니다. 같은 발화에 후보가 여러 개일 때 각 후보를 구분하며, 후보 오디오 경로에 사용합니다."},"status":{"type":"string","description":"이 항목의 처리·검사 상태입니다. waiting·processing·completed·failed 같은 값이 들어가며, 실패 사유는 reasons에서 확인하세요."},"attempt":{"type":"integer","description":"이 후보를 생성한 시도 회차입니다. 1부터 시작하며 재생성할 때마다 증가합니다."},"voice_id":{"type":"string","description":"합성에 사용한 공개 목소리 ID입니다. 요청의 voice_id와 같으며, 목소리 목록 API에서 확인한 값을 그대로 반영합니다."},"created_at":{"type":"string","description":"이 발화·후보가 생성된 시각입니다. ISO 8601 형식이며 시간대가 포함됩니다."},"elapsed_sec":{"type":"number","description":"이 항목의 생성·검사에 걸린 경과 시간(초)입니다. 대기열에서 기다린 시간은 포함하지 않을 수 있습니다."},"reasons":{"type":"array","description":"검사·실패 사유 목록입니다. 통과·주의·실패 판정의 근거가 문장으로 들어가며, 사유가 없으면 빈 배열입니다.","items":{"type":"string","description":"검사 결과 사유."}},"speech_rate":{"type":"object","description":"발화 속도 검사. 검사 단계에 따라 일부 필드는 생략됩니다.","properties":{"characters":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. 공백과 문장부호를 포함하며, chars와 같은 값을 다른 이름으로 제공합니다."},"chars":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. characters와 동일한 값이며, 기존 클라이언트 호환을 위해 함께 제공됩니다."},"duration_sec":{"type":"number","description":"측정된 음성의 실제 길이(초)입니다. 무음 구간이 포함될 수 있고, 초당 글자 수 계산의 기준이 됩니다."},"duration_ms":{"type":"number","description":"측정된 음성의 실제 길이(밀리초)입니다. duration_sec와 같은 값을 단위만 바꿔 제공합니다."},"cps":{"type":"number","description":"초당 발화 글자 수입니다. 값이 높을수록 빠르게 말한 것이며, min_cps보다 낮으면 지나치게 느린 발화로 판정될 수 있습니다."},"expected_sec":{"type":"number","description":"같은 글자 수를 기준 속도로 읽었을 때 예상되는 발화 길이(초)입니다. 실제 길이와 비교해 속도 편차를 계산합니다."},"expected_duration_ms":{"type":"number","description":"예상 발화 길이(밀리초)입니다. expected_sec와 같은 값을 단위만 바꿔 제공합니다."},"duration_ratio":{"type":"number","description":"실제 음성 길이를 예상 길이로 나눈 비율입니다. 1보다 크면 예상보다 느리고, 1보다 작으면 빠릅니다. 계산할 수 없으면 null입니다.","nullable":true},"min_cps":{"type":"number","description":"이 검사에서 허용하는 최소 초당 글자 수입니다. cps가 이 값보다 낮으면 속도 검사에서 주의·실패로 표시됩니다."},"minimum_characters":{"type":"integer","description":"속도 검사를 수행하는 데 필요한 최소 글자 수입니다. 이보다 짧은 발화는 속도 판정을 생략할 수 있습니다."},"status":{"type":"string","description":"속도 검사 결과입니다. 통과·주의·실패 같은 판정 값이 들어가며, 상세 사유는 같은 항목의 reasons를 확인하세요."}}},"audio_sha256":{"type":"string","description":"후보 음원의 SHA-256 해시입니다. 같은 음원인지 무결성을 비교할 때 사용하며, 음원이 없으면 생략됩니다."},"audio_duration_ms":{"type":"number","description":"후보 음원의 실제 길이(밀리초)입니다. 발화 속도·무음 구간 검사의 기준 값으로 사용됩니다."},"audio_available":{"type":"boolean","description":"이 후보의 음원을 다운로드할 수 있는지 여부입니다. false면 생성 실패·보관 만료 등으로 파일이 없습니다."},"transcript":{"type":"string","description":"후보 음원에서 음성 인식으로 얻은 텍스트입니다. 원문과 비교해 CER·coverage를 계산합니다."},"cer":{"type":"number","description":"문자 오류율(Character Error Rate)입니다. 0에 가까울수록 원문과 정확히 일치하며, 1 이상이면 많은 문자가 틀렸다는 뜻입니다."},"coverage":{"type":"number","description":"원문 글자 중 음성에서 실제로 인식된 비율입니다. 1에 가까울수록 원문을 빠짐없이 읽었습니다."},"repeat":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"reference_intrusion":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"text_qa_status":{"type":"string","description":"합성 텍스트와 인식 텍스트의 일치 검사 상태입니다. 통과·주의·실패 값이 들어가며, 상세 사유는 reasons를 확인하세요."},"active_start_ms":{"type":"number","description":"음원에서 실제 발화가 시작된 위치(밀리초)입니다. 앞부분 무음 구간을 제외한 유효 음성의 시작점입니다."},"active_end_ms":{"type":"number","description":"음원에서 실제 발화가 끝난 위치(밀리초)입니다. 뒷부분 무음·보호 구간을 제외한 유효 음성의 끝점입니다."},"tail_guard_attached":{"type":"boolean","description":"끝부분 잘림을 확인하기 위한 보호 구간이 음원에 붙었는지 여부입니다. 검사용으로만 쓰며 최종 음원에는 포함되지 않습니다."},"tail_verified":{"type":"boolean","description":"끝부분까지 정상적으로 생성됐는지 검증을 마쳤는지 여부입니다. false면 끝단 검사가 아직 끝나지 않았습니다."},"tail_verified_at_ms":{"type":"number","description":"끝부분 검증을 수행한 시각(밀리초)입니다. 검증 전에는 null이며, 값이 있으면 tail_verified와 함께 확인하세요.","nullable":true},"tail_body_end_at_ms":{"type":"number","description":"보호 구간을 제외한 실제 본문의 끝 위치(밀리초)입니다. 잘림 판정의 기준점으로 사용됩니다.","nullable":true},"tail_guard_attached_chunk_ids":{"type":"array","description":"보호 구간이 붙은 음성 구간 ID 목록입니다. 어느 구간까지 끝단 검사를 적용했는지 확인할 때 사용합니다.","items":{"type":"string","description":"확인한 구간 ID."}},"generation_budget_exhausted":{"type":"boolean","description":"이 발화의 자동 생성 시도 한도를 모두 사용했는지 여부입니다. true면 같은 조건으로는 더 이상 자동 재생성되지 않습니다."},"retry_requires_new_regeneration_key":{"type":"boolean","description":"재시도에 새 재생성 키가 필요한 상태인지 여부입니다. true면 기존 요청을 반복해도 새 후보가 생성되지 않습니다."},"candidate_revision":{"type":"integer","description":"재시도 회차. 0은 최초 생성이며 재시도할 때 증가합니다.","minimum":0}}}},"candidates":{"type":"array","description":"음성 후보별 품질 검사 결과 목록입니다. 같은 발화의 여러 후보를 비교해 최종 후보를 고를 때 사용합니다.","items":{"type":"object","description":"발화·음원 후보별 공개 검사 결과. 단계별로 제공되는 항목만 포함합니다.","properties":{"id":{"type":"string","description":"이 검사 항목의 식별자입니다. 같은 응답 안에서 항목을 구분할 때 사용하며, 발화 ID와 다를 수 있습니다."},"utterance_id":{"type":"string","description":"검사 대상 발화의 식별자입니다. 요청의 utterances 순서대로 u001·u002처럼 부여되며, 같은 발화의 여러 후보를 묶을 때 사용합니다."},"candidate_id":{"type":"string","description":"생성된 음성 후보의 식별자입니다. 같은 발화에 후보가 여러 개일 때 각 후보를 구분하며, 후보 오디오 경로에 사용합니다."},"status":{"type":"string","description":"이 항목의 처리·검사 상태입니다. waiting·processing·completed·failed 같은 값이 들어가며, 실패 사유는 reasons에서 확인하세요."},"attempt":{"type":"integer","description":"이 후보를 생성한 시도 회차입니다. 1부터 시작하며 재생성할 때마다 증가합니다."},"voice_id":{"type":"string","description":"합성에 사용한 공개 목소리 ID입니다. 요청의 voice_id와 같으며, 목소리 목록 API에서 확인한 값을 그대로 반영합니다."},"created_at":{"type":"string","description":"이 발화·후보가 생성된 시각입니다. ISO 8601 형식이며 시간대가 포함됩니다."},"elapsed_sec":{"type":"number","description":"이 항목의 생성·검사에 걸린 경과 시간(초)입니다. 대기열에서 기다린 시간은 포함하지 않을 수 있습니다."},"reasons":{"type":"array","description":"검사·실패 사유 목록입니다. 통과·주의·실패 판정의 근거가 문장으로 들어가며, 사유가 없으면 빈 배열입니다.","items":{"type":"string","description":"검사 결과 사유."}},"speech_rate":{"type":"object","description":"발화 속도 검사. 검사 단계에 따라 일부 필드는 생략됩니다.","properties":{"characters":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. 공백과 문장부호를 포함하며, chars와 같은 값을 다른 이름으로 제공합니다."},"chars":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. characters와 동일한 값이며, 기존 클라이언트 호환을 위해 함께 제공됩니다."},"duration_sec":{"type":"number","description":"측정된 음성의 실제 길이(초)입니다. 무음 구간이 포함될 수 있고, 초당 글자 수 계산의 기준이 됩니다."},"duration_ms":{"type":"number","description":"측정된 음성의 실제 길이(밀리초)입니다. duration_sec와 같은 값을 단위만 바꿔 제공합니다."},"cps":{"type":"number","description":"초당 발화 글자 수입니다. 값이 높을수록 빠르게 말한 것이며, min_cps보다 낮으면 지나치게 느린 발화로 판정될 수 있습니다."},"expected_sec":{"type":"number","description":"같은 글자 수를 기준 속도로 읽었을 때 예상되는 발화 길이(초)입니다. 실제 길이와 비교해 속도 편차를 계산합니다."},"expected_duration_ms":{"type":"number","description":"예상 발화 길이(밀리초)입니다. expected_sec와 같은 값을 단위만 바꿔 제공합니다."},"duration_ratio":{"type":"number","description":"실제 음성 길이를 예상 길이로 나눈 비율입니다. 1보다 크면 예상보다 느리고, 1보다 작으면 빠릅니다. 계산할 수 없으면 null입니다.","nullable":true},"min_cps":{"type":"number","description":"이 검사에서 허용하는 최소 초당 글자 수입니다. cps가 이 값보다 낮으면 속도 검사에서 주의·실패로 표시됩니다."},"minimum_characters":{"type":"integer","description":"속도 검사를 수행하는 데 필요한 최소 글자 수입니다. 이보다 짧은 발화는 속도 판정을 생략할 수 있습니다."},"status":{"type":"string","description":"속도 검사 결과입니다. 통과·주의·실패 같은 판정 값이 들어가며, 상세 사유는 같은 항목의 reasons를 확인하세요."}}},"audio_sha256":{"type":"string","description":"후보 음원의 SHA-256 해시입니다. 같은 음원인지 무결성을 비교할 때 사용하며, 음원이 없으면 생략됩니다."},"audio_duration_ms":{"type":"number","description":"후보 음원의 실제 길이(밀리초)입니다. 발화 속도·무음 구간 검사의 기준 값으로 사용됩니다."},"audio_available":{"type":"boolean","description":"이 후보의 음원을 다운로드할 수 있는지 여부입니다. false면 생성 실패·보관 만료 등으로 파일이 없습니다."},"transcript":{"type":"string","description":"후보 음원에서 음성 인식으로 얻은 텍스트입니다. 원문과 비교해 CER·coverage를 계산합니다."},"cer":{"type":"number","description":"문자 오류율(Character Error Rate)입니다. 0에 가까울수록 원문과 정확히 일치하며, 1 이상이면 많은 문자가 틀렸다는 뜻입니다."},"coverage":{"type":"number","description":"원문 글자 중 음성에서 실제로 인식된 비율입니다. 1에 가까울수록 원문을 빠짐없이 읽었습니다."},"repeat":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"reference_intrusion":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"text_qa_status":{"type":"string","description":"합성 텍스트와 인식 텍스트의 일치 검사 상태입니다. 통과·주의·실패 값이 들어가며, 상세 사유는 reasons를 확인하세요."},"active_start_ms":{"type":"number","description":"음원에서 실제 발화가 시작된 위치(밀리초)입니다. 앞부분 무음 구간을 제외한 유효 음성의 시작점입니다."},"active_end_ms":{"type":"number","description":"음원에서 실제 발화가 끝난 위치(밀리초)입니다. 뒷부분 무음·보호 구간을 제외한 유효 음성의 끝점입니다."},"tail_guard_attached":{"type":"boolean","description":"끝부분 잘림을 확인하기 위한 보호 구간이 음원에 붙었는지 여부입니다. 검사용으로만 쓰며 최종 음원에는 포함되지 않습니다."},"tail_verified":{"type":"boolean","description":"끝부분까지 정상적으로 생성됐는지 검증을 마쳤는지 여부입니다. false면 끝단 검사가 아직 끝나지 않았습니다."},"tail_verified_at_ms":{"type":"number","description":"끝부분 검증을 수행한 시각(밀리초)입니다. 검증 전에는 null이며, 값이 있으면 tail_verified와 함께 확인하세요.","nullable":true},"tail_body_end_at_ms":{"type":"number","description":"보호 구간을 제외한 실제 본문의 끝 위치(밀리초)입니다. 잘림 판정의 기준점으로 사용됩니다.","nullable":true},"tail_guard_attached_chunk_ids":{"type":"array","description":"보호 구간이 붙은 음성 구간 ID 목록입니다. 어느 구간까지 끝단 검사를 적용했는지 확인할 때 사용합니다.","items":{"type":"string","description":"확인한 구간 ID."}},"generation_budget_exhausted":{"type":"boolean","description":"이 발화의 자동 생성 시도 한도를 모두 사용했는지 여부입니다. true면 같은 조건으로는 더 이상 자동 재생성되지 않습니다."},"retry_requires_new_regeneration_key":{"type":"boolean","description":"재시도에 새 재생성 키가 필요한 상태인지 여부입니다. true면 기존 요청을 반복해도 새 후보가 생성되지 않습니다."},"candidate_revision":{"type":"integer","description":"재시도 회차. 0은 최초 생성이며 재시도할 때 증가합니다.","minimum":0}}}},"final_quality":{"type":"object","description":"최종 선택된 음원의 품질 검사 결과입니다. 최종 검사 전에는 null이거나 생략됩니다.","properties":{"schema_version":{"type":"string","description":"품질 결과 JSON의 규격 버전입니다. 필드 구성이 바뀔 때 증가하며, 클라이언트는 이 값을 기준으로 호환성을 판단할 수 있습니다."},"attempt":{"type":"integer","description":"현재 품질 검사가 몇 번째 시도인지 나타냅니다. 재검사할 때마다 증가하며, 후보별 attempt와 다를 수 있습니다."},"phase":{"type":"string","description":"작업이 현재 어느 처리 단계에 있는지 나타냅니다. waiting·processing·completed·failed 같은 값으로 진행 상태를 구분합니다."},"accepted_utterances":{"type":"integer","description":"품질 검사를 통과한 발화 수입니다. 전체 발화 수와 비교해 실패·미검사 발화를 파악하세요."},"failed_utterances":{"type":"integer","description":"품질 검사에서 실패한 발화 수입니다. 0이 아니면 실패 사유와 재시도 필요 여부를 함께 확인하세요."},"total_utterances":{"type":"integer","description":"이 작업에 포함된 전체 발화 수입니다. accepted_utterances + failed_utterances와 같거나, 아직 검사 전인 발화가 있으면 더 클 수 있습니다."},"expires_at":{"type":"string","description":"후보 음원·검사 결과를 보관하는 만료 시각입니다. 이 시각이 지나면 후보 다운로드가 불가능할 수 있으며, 검사 전에는 null입니다.","nullable":true},"queue_elapsed_sec":{"type":"number","description":"작업이 대기열에서 기다린 시간(초)입니다. 생성 시간과 분리해 지연 원인을 파악할 때 사용합니다."},"generation_elapsed_sec":{"type":"number","description":"실제 음성 생성에 걸린 시간(초)입니다. 대기 시간을 제외한 처리 시간입니다."},"utterances":{"type":"array","description":"발화별 품질 검사 결과 목록입니다. 각 항목은 발화 ID·후보 ID·속도·반복·참조 검사 값을 포함합니다.","items":{"type":"object","description":"발화·음원 후보별 공개 검사 결과. 단계별로 제공되는 항목만 포함합니다.","properties":{"id":{"type":"string","description":"이 검사 항목의 식별자입니다. 같은 응답 안에서 항목을 구분할 때 사용하며, 발화 ID와 다를 수 있습니다."},"utterance_id":{"type":"string","description":"검사 대상 발화의 식별자입니다. 요청의 utterances 순서대로 u001·u002처럼 부여되며, 같은 발화의 여러 후보를 묶을 때 사용합니다."},"candidate_id":{"type":"string","description":"생성된 음성 후보의 식별자입니다. 같은 발화에 후보가 여러 개일 때 각 후보를 구분하며, 후보 오디오 경로에 사용합니다."},"status":{"type":"string","description":"이 항목의 처리·검사 상태입니다. waiting·processing·completed·failed 같은 값이 들어가며, 실패 사유는 reasons에서 확인하세요."},"attempt":{"type":"integer","description":"이 후보를 생성한 시도 회차입니다. 1부터 시작하며 재생성할 때마다 증가합니다."},"voice_id":{"type":"string","description":"합성에 사용한 공개 목소리 ID입니다. 요청의 voice_id와 같으며, 목소리 목록 API에서 확인한 값을 그대로 반영합니다."},"created_at":{"type":"string","description":"이 발화·후보가 생성된 시각입니다. ISO 8601 형식이며 시간대가 포함됩니다."},"elapsed_sec":{"type":"number","description":"이 항목의 생성·검사에 걸린 경과 시간(초)입니다. 대기열에서 기다린 시간은 포함하지 않을 수 있습니다."},"reasons":{"type":"array","description":"검사·실패 사유 목록입니다. 통과·주의·실패 판정의 근거가 문장으로 들어가며, 사유가 없으면 빈 배열입니다.","items":{"type":"string","description":"검사 결과 사유."}},"speech_rate":{"type":"object","description":"발화 속도 검사. 검사 단계에 따라 일부 필드는 생략됩니다.","properties":{"characters":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. 공백과 문장부호를 포함하며, chars와 같은 값을 다른 이름으로 제공합니다."},"chars":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. characters와 동일한 값이며, 기존 클라이언트 호환을 위해 함께 제공됩니다."},"duration_sec":{"type":"number","description":"측정된 음성의 실제 길이(초)입니다. 무음 구간이 포함될 수 있고, 초당 글자 수 계산의 기준이 됩니다."},"duration_ms":{"type":"number","description":"측정된 음성의 실제 길이(밀리초)입니다. duration_sec와 같은 값을 단위만 바꿔 제공합니다."},"cps":{"type":"number","description":"초당 발화 글자 수입니다. 값이 높을수록 빠르게 말한 것이며, min_cps보다 낮으면 지나치게 느린 발화로 판정될 수 있습니다."},"expected_sec":{"type":"number","description":"같은 글자 수를 기준 속도로 읽었을 때 예상되는 발화 길이(초)입니다. 실제 길이와 비교해 속도 편차를 계산합니다."},"expected_duration_ms":{"type":"number","description":"예상 발화 길이(밀리초)입니다. expected_sec와 같은 값을 단위만 바꿔 제공합니다."},"duration_ratio":{"type":"number","description":"실제 음성 길이를 예상 길이로 나눈 비율입니다. 1보다 크면 예상보다 느리고, 1보다 작으면 빠릅니다. 계산할 수 없으면 null입니다.","nullable":true},"min_cps":{"type":"number","description":"이 검사에서 허용하는 최소 초당 글자 수입니다. cps가 이 값보다 낮으면 속도 검사에서 주의·실패로 표시됩니다."},"minimum_characters":{"type":"integer","description":"속도 검사를 수행하는 데 필요한 최소 글자 수입니다. 이보다 짧은 발화는 속도 판정을 생략할 수 있습니다."},"status":{"type":"string","description":"속도 검사 결과입니다. 통과·주의·실패 같은 판정 값이 들어가며, 상세 사유는 같은 항목의 reasons를 확인하세요."}}},"audio_sha256":{"type":"string","description":"후보 음원의 SHA-256 해시입니다. 같은 음원인지 무결성을 비교할 때 사용하며, 음원이 없으면 생략됩니다."},"audio_duration_ms":{"type":"number","description":"후보 음원의 실제 길이(밀리초)입니다. 발화 속도·무음 구간 검사의 기준 값으로 사용됩니다."},"audio_available":{"type":"boolean","description":"이 후보의 음원을 다운로드할 수 있는지 여부입니다. false면 생성 실패·보관 만료 등으로 파일이 없습니다."},"transcript":{"type":"string","description":"후보 음원에서 음성 인식으로 얻은 텍스트입니다. 원문과 비교해 CER·coverage를 계산합니다."},"cer":{"type":"number","description":"문자 오류율(Character Error Rate)입니다. 0에 가까울수록 원문과 정확히 일치하며, 1 이상이면 많은 문자가 틀렸다는 뜻입니다."},"coverage":{"type":"number","description":"원문 글자 중 음성에서 실제로 인식된 비율입니다. 1에 가까울수록 원문을 빠짐없이 읽었습니다."},"repeat":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"reference_intrusion":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"text_qa_status":{"type":"string","description":"합성 텍스트와 인식 텍스트의 일치 검사 상태입니다. 통과·주의·실패 값이 들어가며, 상세 사유는 reasons를 확인하세요."},"active_start_ms":{"type":"number","description":"음원에서 실제 발화가 시작된 위치(밀리초)입니다. 앞부분 무음 구간을 제외한 유효 음성의 시작점입니다."},"active_end_ms":{"type":"number","description":"음원에서 실제 발화가 끝난 위치(밀리초)입니다. 뒷부분 무음·보호 구간을 제외한 유효 음성의 끝점입니다."},"tail_guard_attached":{"type":"boolean","description":"끝부분 잘림을 확인하기 위한 보호 구간이 음원에 붙었는지 여부입니다. 검사용으로만 쓰며 최종 음원에는 포함되지 않습니다."},"tail_verified":{"type":"boolean","description":"끝부분까지 정상적으로 생성됐는지 검증을 마쳤는지 여부입니다. false면 끝단 검사가 아직 끝나지 않았습니다."},"tail_verified_at_ms":{"type":"number","description":"끝부분 검증을 수행한 시각(밀리초)입니다. 검증 전에는 null이며, 값이 있으면 tail_verified와 함께 확인하세요.","nullable":true},"tail_body_end_at_ms":{"type":"number","description":"보호 구간을 제외한 실제 본문의 끝 위치(밀리초)입니다. 잘림 판정의 기준점으로 사용됩니다.","nullable":true},"tail_guard_attached_chunk_ids":{"type":"array","description":"보호 구간이 붙은 음성 구간 ID 목록입니다. 어느 구간까지 끝단 검사를 적용했는지 확인할 때 사용합니다.","items":{"type":"string","description":"확인한 구간 ID."}},"generation_budget_exhausted":{"type":"boolean","description":"이 발화의 자동 생성 시도 한도를 모두 사용했는지 여부입니다. true면 같은 조건으로는 더 이상 자동 재생성되지 않습니다."},"retry_requires_new_regeneration_key":{"type":"boolean","description":"재시도에 새 재생성 키가 필요한 상태인지 여부입니다. true면 기존 요청을 반복해도 새 후보가 생성되지 않습니다."},"candidate_revision":{"type":"integer","description":"재시도 회차. 0은 최초 생성이며 재시도할 때 증가합니다.","minimum":0}}}},"candidates":{"type":"array","description":"음성 후보별 품질 검사 결과 목록입니다. 같은 발화의 여러 후보를 비교해 최종 후보를 고를 때 사용합니다.","items":{"type":"object","description":"발화·음원 후보별 공개 검사 결과. 단계별로 제공되는 항목만 포함합니다.","properties":{"id":{"type":"string","description":"이 검사 항목의 식별자입니다. 같은 응답 안에서 항목을 구분할 때 사용하며, 발화 ID와 다를 수 있습니다."},"utterance_id":{"type":"string","description":"검사 대상 발화의 식별자입니다. 요청의 utterances 순서대로 u001·u002처럼 부여되며, 같은 발화의 여러 후보를 묶을 때 사용합니다."},"candidate_id":{"type":"string","description":"생성된 음성 후보의 식별자입니다. 같은 발화에 후보가 여러 개일 때 각 후보를 구분하며, 후보 오디오 경로에 사용합니다."},"status":{"type":"string","description":"이 항목의 처리·검사 상태입니다. waiting·processing·completed·failed 같은 값이 들어가며, 실패 사유는 reasons에서 확인하세요."},"attempt":{"type":"integer","description":"이 후보를 생성한 시도 회차입니다. 1부터 시작하며 재생성할 때마다 증가합니다."},"voice_id":{"type":"string","description":"합성에 사용한 공개 목소리 ID입니다. 요청의 voice_id와 같으며, 목소리 목록 API에서 확인한 값을 그대로 반영합니다."},"created_at":{"type":"string","description":"이 발화·후보가 생성된 시각입니다. ISO 8601 형식이며 시간대가 포함됩니다."},"elapsed_sec":{"type":"number","description":"이 항목의 생성·검사에 걸린 경과 시간(초)입니다. 대기열에서 기다린 시간은 포함하지 않을 수 있습니다."},"reasons":{"type":"array","description":"검사·실패 사유 목록입니다. 통과·주의·실패 판정의 근거가 문장으로 들어가며, 사유가 없으면 빈 배열입니다.","items":{"type":"string","description":"검사 결과 사유."}},"speech_rate":{"type":"object","description":"발화 속도 검사. 검사 단계에 따라 일부 필드는 생략됩니다.","properties":{"characters":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. 공백과 문장부호를 포함하며, chars와 같은 값을 다른 이름으로 제공합니다."},"chars":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. characters와 동일한 값이며, 기존 클라이언트 호환을 위해 함께 제공됩니다."},"duration_sec":{"type":"number","description":"측정된 음성의 실제 길이(초)입니다. 무음 구간이 포함될 수 있고, 초당 글자 수 계산의 기준이 됩니다."},"duration_ms":{"type":"number","description":"측정된 음성의 실제 길이(밀리초)입니다. duration_sec와 같은 값을 단위만 바꿔 제공합니다."},"cps":{"type":"number","description":"초당 발화 글자 수입니다. 값이 높을수록 빠르게 말한 것이며, min_cps보다 낮으면 지나치게 느린 발화로 판정될 수 있습니다."},"expected_sec":{"type":"number","description":"같은 글자 수를 기준 속도로 읽었을 때 예상되는 발화 길이(초)입니다. 실제 길이와 비교해 속도 편차를 계산합니다."},"expected_duration_ms":{"type":"number","description":"예상 발화 길이(밀리초)입니다. expected_sec와 같은 값을 단위만 바꿔 제공합니다."},"duration_ratio":{"type":"number","description":"실제 음성 길이를 예상 길이로 나눈 비율입니다. 1보다 크면 예상보다 느리고, 1보다 작으면 빠릅니다. 계산할 수 없으면 null입니다.","nullable":true},"min_cps":{"type":"number","description":"이 검사에서 허용하는 최소 초당 글자 수입니다. cps가 이 값보다 낮으면 속도 검사에서 주의·실패로 표시됩니다."},"minimum_characters":{"type":"integer","description":"속도 검사를 수행하는 데 필요한 최소 글자 수입니다. 이보다 짧은 발화는 속도 판정을 생략할 수 있습니다."},"status":{"type":"string","description":"속도 검사 결과입니다. 통과·주의·실패 같은 판정 값이 들어가며, 상세 사유는 같은 항목의 reasons를 확인하세요."}}},"audio_sha256":{"type":"string","description":"후보 음원의 SHA-256 해시입니다. 같은 음원인지 무결성을 비교할 때 사용하며, 음원이 없으면 생략됩니다."},"audio_duration_ms":{"type":"number","description":"후보 음원의 실제 길이(밀리초)입니다. 발화 속도·무음 구간 검사의 기준 값으로 사용됩니다."},"audio_available":{"type":"boolean","description":"이 후보의 음원을 다운로드할 수 있는지 여부입니다. false면 생성 실패·보관 만료 등으로 파일이 없습니다."},"transcript":{"type":"string","description":"후보 음원에서 음성 인식으로 얻은 텍스트입니다. 원문과 비교해 CER·coverage를 계산합니다."},"cer":{"type":"number","description":"문자 오류율(Character Error Rate)입니다. 0에 가까울수록 원문과 정확히 일치하며, 1 이상이면 많은 문자가 틀렸다는 뜻입니다."},"coverage":{"type":"number","description":"원문 글자 중 음성에서 실제로 인식된 비율입니다. 1에 가까울수록 원문을 빠짐없이 읽었습니다."},"repeat":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"reference_intrusion":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"text_qa_status":{"type":"string","description":"합성 텍스트와 인식 텍스트의 일치 검사 상태입니다. 통과·주의·실패 값이 들어가며, 상세 사유는 reasons를 확인하세요."},"active_start_ms":{"type":"number","description":"음원에서 실제 발화가 시작된 위치(밀리초)입니다. 앞부분 무음 구간을 제외한 유효 음성의 시작점입니다."},"active_end_ms":{"type":"number","description":"음원에서 실제 발화가 끝난 위치(밀리초)입니다. 뒷부분 무음·보호 구간을 제외한 유효 음성의 끝점입니다."},"tail_guard_attached":{"type":"boolean","description":"끝부분 잘림을 확인하기 위한 보호 구간이 음원에 붙었는지 여부입니다. 검사용으로만 쓰며 최종 음원에는 포함되지 않습니다."},"tail_verified":{"type":"boolean","description":"끝부분까지 정상적으로 생성됐는지 검증을 마쳤는지 여부입니다. false면 끝단 검사가 아직 끝나지 않았습니다."},"tail_verified_at_ms":{"type":"number","description":"끝부분 검증을 수행한 시각(밀리초)입니다. 검증 전에는 null이며, 값이 있으면 tail_verified와 함께 확인하세요.","nullable":true},"tail_body_end_at_ms":{"type":"number","description":"보호 구간을 제외한 실제 본문의 끝 위치(밀리초)입니다. 잘림 판정의 기준점으로 사용됩니다.","nullable":true},"tail_guard_attached_chunk_ids":{"type":"array","description":"보호 구간이 붙은 음성 구간 ID 목록입니다. 어느 구간까지 끝단 검사를 적용했는지 확인할 때 사용합니다.","items":{"type":"string","description":"확인한 구간 ID."}},"generation_budget_exhausted":{"type":"boolean","description":"이 발화의 자동 생성 시도 한도를 모두 사용했는지 여부입니다. true면 같은 조건으로는 더 이상 자동 재생성되지 않습니다."},"retry_requires_new_regeneration_key":{"type":"boolean","description":"재시도에 새 재생성 키가 필요한 상태인지 여부입니다. true면 기존 요청을 반복해도 새 후보가 생성되지 않습니다."},"candidate_revision":{"type":"integer","description":"재시도 회차. 0은 최초 생성이며 재시도할 때 증가합니다.","minimum":0}}}},"status":{"type":"string","description":"최종 선택된 음원의 검사 상태입니다. 통과·주의·실패 값을 확인해 다운로드 가능 여부를 판단하세요."},"audio_sha256":{"type":"string","description":"최종 선택된 음원의 SHA-256 해시입니다. 다운로드한 파일의 무결성을 확인할 때 사용합니다."}}}},"nullable":true},"error":{"type":"object","description":"실패 상태일 때 포함합니다.","properties":{"code":{"type":"string","description":"실패한 작업의 공개 오류코드."},"message":{"type":"string","description":"오류 설명."}}}}},"api":{"type":"object","description":"호출 메타데이터.","properties":{"success":{"type":"boolean","description":"API 공통 처리 여부. HTTP 상태·업무 결과와 함께 확인합니다."},"cost":{"type":"number","description":"이번 호출에서 차감한 포인트. 무료 조회·재전송은 0."},"pl_id":{"type":"integer","description":"과금 기록 ID. 과금 기록이 있을 때만 포함합니다."}}}}}}}},"default":{"description":"TTS_REQUEST_INVALID (400·413·422): 목소리·문자 수·발화 구조·입력 크기를 확인하세요.\nTTS_AUTH_FAILED (401): 인증키를 확인하세요.\nTTS_ACCESS_DISABLED (403): 계정의 API 이용 제한 상태를 확인하세요.\nTTS_PAYMENT_REQUIRED (403): 최초 결제를 완료한 뒤 이용하세요.\nTTS_INSUFFICIENT_POINTS (402): 필요한 포인트를 충전하세요.\nTTS_NOT_FOUND (404): 작업·후보 ID와 소유 계정을 확인하세요.\nTTS_JOB_CONFLICT (409): 작업 상태·재시도 회차·같은 멱등 키의 요청 내용을 확인하세요.\nTTS_GENERATION_FAILED (409): 실패 상태를 확인하고 입력을 수정하거나 새 작업을 접수하세요.\nTTS_RESULT_UNAVAILABLE (410): 파일이 이미 다운로드됐거나 보관 기간이 만료됐습니다.\nTTS_TEMPORARILY_UNAVAILABLE (429·503): Retry-After 이후 다시 시도하세요. 재시도 요청에는 같은 멱등 키를 사용하세요.\nTTS_BILLING_FAILED (424): 결제를 완료하지 못했습니다. Retry-After 이후 다시 시도하세요.\nTTS_INTERNAL_ERROR (500): 잠시 후 다시 시도하세요.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/rest/tts/openai/voices":{"get":{"summary":"한국어 AI 내레이션 TTS","description":"한국어 대본을 보내면 음성(MP3)과 발화 시각이 맞춰진 ASS 자막을 함께 만들어 줍니다. 작업을 접수한 뒤 상태를 확인하고, 완료되면 두 파일을 내려받는 방식입니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스 응답","content":{"application/json":{"schema":{"type":"object","description":"공개 JSON 응답.","properties":{"data":{"type":"object","properties":{"job_id":{"type":"string","description":"접수 응답에서 받은 작업 ID. 같은 계정의 작업에만 접근할 수 있습니다."},"status":{"type":"string","description":"작업 진행 상태. 완료 여부와 다운로드 가능 여부를 함께 확인합니다.","enum":["waiting","processing","completed","cancelled","failed"]},"result_available":{"type":"boolean","description":"최종 MP3를 내려받을 수 있는지 여부."},"subtitles_available":{"type":"boolean","description":"자막을 내려받을 수 있는지 여부."},"resume_revision":{"type":"integer","description":"재시도 회차. 0은 최초 생성이며 재시도할 때 증가합니다.","minimum":0},"quality":{"type":"object","description":"품질 상세. 아직 검사 전이면 null이거나 생략됩니다.","properties":{"schema_version":{"type":"string","description":"품질 결과 JSON의 규격 버전입니다. 필드 구성이 바뀔 때 증가하며, 클라이언트는 이 값을 기준으로 호환성을 판단할 수 있습니다."},"attempt":{"type":"integer","description":"현재 품질 검사가 몇 번째 시도인지 나타냅니다. 재검사할 때마다 증가하며, 후보별 attempt와 다를 수 있습니다."},"phase":{"type":"string","description":"작업이 현재 어느 처리 단계에 있는지 나타냅니다. waiting·processing·completed·failed 같은 값으로 진행 상태를 구분합니다."},"accepted_utterances":{"type":"integer","description":"품질 검사를 통과한 발화 수입니다. 전체 발화 수와 비교해 실패·미검사 발화를 파악하세요."},"failed_utterances":{"type":"integer","description":"품질 검사에서 실패한 발화 수입니다. 0이 아니면 실패 사유와 재시도 필요 여부를 함께 확인하세요."},"total_utterances":{"type":"integer","description":"이 작업에 포함된 전체 발화 수입니다. accepted_utterances + failed_utterances와 같거나, 아직 검사 전인 발화가 있으면 더 클 수 있습니다."},"expires_at":{"type":"string","description":"후보 음원·검사 결과를 보관하는 만료 시각입니다. 이 시각이 지나면 후보 다운로드가 불가능할 수 있으며, 검사 전에는 null입니다.","nullable":true},"queue_elapsed_sec":{"type":"number","description":"작업이 대기열에서 기다린 시간(초)입니다. 생성 시간과 분리해 지연 원인을 파악할 때 사용합니다."},"generation_elapsed_sec":{"type":"number","description":"실제 음성 생성에 걸린 시간(초)입니다. 대기 시간을 제외한 처리 시간입니다."},"utterances":{"type":"array","description":"발화별 품질 검사 결과 목록입니다. 각 항목은 발화 ID·후보 ID·속도·반복·참조 검사 값을 포함합니다.","items":{"type":"object","description":"발화·음원 후보별 공개 검사 결과. 단계별로 제공되는 항목만 포함합니다.","properties":{"id":{"type":"string","description":"이 검사 항목의 식별자입니다. 같은 응답 안에서 항목을 구분할 때 사용하며, 발화 ID와 다를 수 있습니다."},"utterance_id":{"type":"string","description":"검사 대상 발화의 식별자입니다. 요청의 utterances 순서대로 u001·u002처럼 부여되며, 같은 발화의 여러 후보를 묶을 때 사용합니다."},"candidate_id":{"type":"string","description":"생성된 음성 후보의 식별자입니다. 같은 발화에 후보가 여러 개일 때 각 후보를 구분하며, 후보 오디오 경로에 사용합니다."},"status":{"type":"string","description":"이 항목의 처리·검사 상태입니다. waiting·processing·completed·failed 같은 값이 들어가며, 실패 사유는 reasons에서 확인하세요."},"attempt":{"type":"integer","description":"이 후보를 생성한 시도 회차입니다. 1부터 시작하며 재생성할 때마다 증가합니다."},"voice_id":{"type":"string","description":"합성에 사용한 공개 목소리 ID입니다. 요청의 voice_id와 같으며, 목소리 목록 API에서 확인한 값을 그대로 반영합니다."},"created_at":{"type":"string","description":"이 발화·후보가 생성된 시각입니다. ISO 8601 형식이며 시간대가 포함됩니다."},"elapsed_sec":{"type":"number","description":"이 항목의 생성·검사에 걸린 경과 시간(초)입니다. 대기열에서 기다린 시간은 포함하지 않을 수 있습니다."},"reasons":{"type":"array","description":"검사·실패 사유 목록입니다. 통과·주의·실패 판정의 근거가 문장으로 들어가며, 사유가 없으면 빈 배열입니다.","items":{"type":"string","description":"검사 결과 사유."}},"speech_rate":{"type":"object","description":"발화 속도 검사. 검사 단계에 따라 일부 필드는 생략됩니다.","properties":{"characters":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. 공백과 문장부호를 포함하며, chars와 같은 값을 다른 이름으로 제공합니다."},"chars":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. characters와 동일한 값이며, 기존 클라이언트 호환을 위해 함께 제공됩니다."},"duration_sec":{"type":"number","description":"측정된 음성의 실제 길이(초)입니다. 무음 구간이 포함될 수 있고, 초당 글자 수 계산의 기준이 됩니다."},"duration_ms":{"type":"number","description":"측정된 음성의 실제 길이(밀리초)입니다. duration_sec와 같은 값을 단위만 바꿔 제공합니다."},"cps":{"type":"number","description":"초당 발화 글자 수입니다. 값이 높을수록 빠르게 말한 것이며, min_cps보다 낮으면 지나치게 느린 발화로 판정될 수 있습니다."},"expected_sec":{"type":"number","description":"같은 글자 수를 기준 속도로 읽었을 때 예상되는 발화 길이(초)입니다. 실제 길이와 비교해 속도 편차를 계산합니다."},"expected_duration_ms":{"type":"number","description":"예상 발화 길이(밀리초)입니다. expected_sec와 같은 값을 단위만 바꿔 제공합니다."},"duration_ratio":{"type":"number","description":"실제 음성 길이를 예상 길이로 나눈 비율입니다. 1보다 크면 예상보다 느리고, 1보다 작으면 빠릅니다. 계산할 수 없으면 null입니다.","nullable":true},"min_cps":{"type":"number","description":"이 검사에서 허용하는 최소 초당 글자 수입니다. cps가 이 값보다 낮으면 속도 검사에서 주의·실패로 표시됩니다."},"minimum_characters":{"type":"integer","description":"속도 검사를 수행하는 데 필요한 최소 글자 수입니다. 이보다 짧은 발화는 속도 판정을 생략할 수 있습니다."},"status":{"type":"string","description":"속도 검사 결과입니다. 통과·주의·실패 같은 판정 값이 들어가며, 상세 사유는 같은 항목의 reasons를 확인하세요."}}},"audio_sha256":{"type":"string","description":"후보 음원의 SHA-256 해시입니다. 같은 음원인지 무결성을 비교할 때 사용하며, 음원이 없으면 생략됩니다."},"audio_duration_ms":{"type":"number","description":"후보 음원의 실제 길이(밀리초)입니다. 발화 속도·무음 구간 검사의 기준 값으로 사용됩니다."},"audio_available":{"type":"boolean","description":"이 후보의 음원을 다운로드할 수 있는지 여부입니다. false면 생성 실패·보관 만료 등으로 파일이 없습니다."},"transcript":{"type":"string","description":"후보 음원에서 음성 인식으로 얻은 텍스트입니다. 원문과 비교해 CER·coverage를 계산합니다."},"cer":{"type":"number","description":"문자 오류율(Character Error Rate)입니다. 0에 가까울수록 원문과 정확히 일치하며, 1 이상이면 많은 문자가 틀렸다는 뜻입니다."},"coverage":{"type":"number","description":"원문 글자 중 음성에서 실제로 인식된 비율입니다. 1에 가까울수록 원문을 빠짐없이 읽었습니다."},"repeat":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"reference_intrusion":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"text_qa_status":{"type":"string","description":"합성 텍스트와 인식 텍스트의 일치 검사 상태입니다. 통과·주의·실패 값이 들어가며, 상세 사유는 reasons를 확인하세요."},"active_start_ms":{"type":"number","description":"음원에서 실제 발화가 시작된 위치(밀리초)입니다. 앞부분 무음 구간을 제외한 유효 음성의 시작점입니다."},"active_end_ms":{"type":"number","description":"음원에서 실제 발화가 끝난 위치(밀리초)입니다. 뒷부분 무음·보호 구간을 제외한 유효 음성의 끝점입니다."},"tail_guard_attached":{"type":"boolean","description":"끝부분 잘림을 확인하기 위한 보호 구간이 음원에 붙었는지 여부입니다. 검사용으로만 쓰며 최종 음원에는 포함되지 않습니다."},"tail_verified":{"type":"boolean","description":"끝부분까지 정상적으로 생성됐는지 검증을 마쳤는지 여부입니다. false면 끝단 검사가 아직 끝나지 않았습니다."},"tail_verified_at_ms":{"type":"number","description":"끝부분 검증을 수행한 시각(밀리초)입니다. 검증 전에는 null이며, 값이 있으면 tail_verified와 함께 확인하세요.","nullable":true},"tail_body_end_at_ms":{"type":"number","description":"보호 구간을 제외한 실제 본문의 끝 위치(밀리초)입니다. 잘림 판정의 기준점으로 사용됩니다.","nullable":true},"tail_guard_attached_chunk_ids":{"type":"array","description":"보호 구간이 붙은 음성 구간 ID 목록입니다. 어느 구간까지 끝단 검사를 적용했는지 확인할 때 사용합니다.","items":{"type":"string","description":"확인한 구간 ID."}},"generation_budget_exhausted":{"type":"boolean","description":"이 발화의 자동 생성 시도 한도를 모두 사용했는지 여부입니다. true면 같은 조건으로는 더 이상 자동 재생성되지 않습니다."},"retry_requires_new_regeneration_key":{"type":"boolean","description":"재시도에 새 재생성 키가 필요한 상태인지 여부입니다. true면 기존 요청을 반복해도 새 후보가 생성되지 않습니다."},"candidate_revision":{"type":"integer","description":"재시도 회차. 0은 최초 생성이며 재시도할 때 증가합니다.","minimum":0}}}},"candidates":{"type":"array","description":"음성 후보별 품질 검사 결과 목록입니다. 같은 발화의 여러 후보를 비교해 최종 후보를 고를 때 사용합니다.","items":{"type":"object","description":"발화·음원 후보별 공개 검사 결과. 단계별로 제공되는 항목만 포함합니다.","properties":{"id":{"type":"string","description":"이 검사 항목의 식별자입니다. 같은 응답 안에서 항목을 구분할 때 사용하며, 발화 ID와 다를 수 있습니다."},"utterance_id":{"type":"string","description":"검사 대상 발화의 식별자입니다. 요청의 utterances 순서대로 u001·u002처럼 부여되며, 같은 발화의 여러 후보를 묶을 때 사용합니다."},"candidate_id":{"type":"string","description":"생성된 음성 후보의 식별자입니다. 같은 발화에 후보가 여러 개일 때 각 후보를 구분하며, 후보 오디오 경로에 사용합니다."},"status":{"type":"string","description":"이 항목의 처리·검사 상태입니다. waiting·processing·completed·failed 같은 값이 들어가며, 실패 사유는 reasons에서 확인하세요."},"attempt":{"type":"integer","description":"이 후보를 생성한 시도 회차입니다. 1부터 시작하며 재생성할 때마다 증가합니다."},"voice_id":{"type":"string","description":"합성에 사용한 공개 목소리 ID입니다. 요청의 voice_id와 같으며, 목소리 목록 API에서 확인한 값을 그대로 반영합니다."},"created_at":{"type":"string","description":"이 발화·후보가 생성된 시각입니다. ISO 8601 형식이며 시간대가 포함됩니다."},"elapsed_sec":{"type":"number","description":"이 항목의 생성·검사에 걸린 경과 시간(초)입니다. 대기열에서 기다린 시간은 포함하지 않을 수 있습니다."},"reasons":{"type":"array","description":"검사·실패 사유 목록입니다. 통과·주의·실패 판정의 근거가 문장으로 들어가며, 사유가 없으면 빈 배열입니다.","items":{"type":"string","description":"검사 결과 사유."}},"speech_rate":{"type":"object","description":"발화 속도 검사. 검사 단계에 따라 일부 필드는 생략됩니다.","properties":{"characters":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. 공백과 문장부호를 포함하며, chars와 같은 값을 다른 이름으로 제공합니다."},"chars":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. characters와 동일한 값이며, 기존 클라이언트 호환을 위해 함께 제공됩니다."},"duration_sec":{"type":"number","description":"측정된 음성의 실제 길이(초)입니다. 무음 구간이 포함될 수 있고, 초당 글자 수 계산의 기준이 됩니다."},"duration_ms":{"type":"number","description":"측정된 음성의 실제 길이(밀리초)입니다. duration_sec와 같은 값을 단위만 바꿔 제공합니다."},"cps":{"type":"number","description":"초당 발화 글자 수입니다. 값이 높을수록 빠르게 말한 것이며, min_cps보다 낮으면 지나치게 느린 발화로 판정될 수 있습니다."},"expected_sec":{"type":"number","description":"같은 글자 수를 기준 속도로 읽었을 때 예상되는 발화 길이(초)입니다. 실제 길이와 비교해 속도 편차를 계산합니다."},"expected_duration_ms":{"type":"number","description":"예상 발화 길이(밀리초)입니다. expected_sec와 같은 값을 단위만 바꿔 제공합니다."},"duration_ratio":{"type":"number","description":"실제 음성 길이를 예상 길이로 나눈 비율입니다. 1보다 크면 예상보다 느리고, 1보다 작으면 빠릅니다. 계산할 수 없으면 null입니다.","nullable":true},"min_cps":{"type":"number","description":"이 검사에서 허용하는 최소 초당 글자 수입니다. cps가 이 값보다 낮으면 속도 검사에서 주의·실패로 표시됩니다."},"minimum_characters":{"type":"integer","description":"속도 검사를 수행하는 데 필요한 최소 글자 수입니다. 이보다 짧은 발화는 속도 판정을 생략할 수 있습니다."},"status":{"type":"string","description":"속도 검사 결과입니다. 통과·주의·실패 같은 판정 값이 들어가며, 상세 사유는 같은 항목의 reasons를 확인하세요."}}},"audio_sha256":{"type":"string","description":"후보 음원의 SHA-256 해시입니다. 같은 음원인지 무결성을 비교할 때 사용하며, 음원이 없으면 생략됩니다."},"audio_duration_ms":{"type":"number","description":"후보 음원의 실제 길이(밀리초)입니다. 발화 속도·무음 구간 검사의 기준 값으로 사용됩니다."},"audio_available":{"type":"boolean","description":"이 후보의 음원을 다운로드할 수 있는지 여부입니다. false면 생성 실패·보관 만료 등으로 파일이 없습니다."},"transcript":{"type":"string","description":"후보 음원에서 음성 인식으로 얻은 텍스트입니다. 원문과 비교해 CER·coverage를 계산합니다."},"cer":{"type":"number","description":"문자 오류율(Character Error Rate)입니다. 0에 가까울수록 원문과 정확히 일치하며, 1 이상이면 많은 문자가 틀렸다는 뜻입니다."},"coverage":{"type":"number","description":"원문 글자 중 음성에서 실제로 인식된 비율입니다. 1에 가까울수록 원문을 빠짐없이 읽었습니다."},"repeat":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"reference_intrusion":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"text_qa_status":{"type":"string","description":"합성 텍스트와 인식 텍스트의 일치 검사 상태입니다. 통과·주의·실패 값이 들어가며, 상세 사유는 reasons를 확인하세요."},"active_start_ms":{"type":"number","description":"음원에서 실제 발화가 시작된 위치(밀리초)입니다. 앞부분 무음 구간을 제외한 유효 음성의 시작점입니다."},"active_end_ms":{"type":"number","description":"음원에서 실제 발화가 끝난 위치(밀리초)입니다. 뒷부분 무음·보호 구간을 제외한 유효 음성의 끝점입니다."},"tail_guard_attached":{"type":"boolean","description":"끝부분 잘림을 확인하기 위한 보호 구간이 음원에 붙었는지 여부입니다. 검사용으로만 쓰며 최종 음원에는 포함되지 않습니다."},"tail_verified":{"type":"boolean","description":"끝부분까지 정상적으로 생성됐는지 검증을 마쳤는지 여부입니다. false면 끝단 검사가 아직 끝나지 않았습니다."},"tail_verified_at_ms":{"type":"number","description":"끝부분 검증을 수행한 시각(밀리초)입니다. 검증 전에는 null이며, 값이 있으면 tail_verified와 함께 확인하세요.","nullable":true},"tail_body_end_at_ms":{"type":"number","description":"보호 구간을 제외한 실제 본문의 끝 위치(밀리초)입니다. 잘림 판정의 기준점으로 사용됩니다.","nullable":true},"tail_guard_attached_chunk_ids":{"type":"array","description":"보호 구간이 붙은 음성 구간 ID 목록입니다. 어느 구간까지 끝단 검사를 적용했는지 확인할 때 사용합니다.","items":{"type":"string","description":"확인한 구간 ID."}},"generation_budget_exhausted":{"type":"boolean","description":"이 발화의 자동 생성 시도 한도를 모두 사용했는지 여부입니다. true면 같은 조건으로는 더 이상 자동 재생성되지 않습니다."},"retry_requires_new_regeneration_key":{"type":"boolean","description":"재시도에 새 재생성 키가 필요한 상태인지 여부입니다. true면 기존 요청을 반복해도 새 후보가 생성되지 않습니다."},"candidate_revision":{"type":"integer","description":"재시도 회차. 0은 최초 생성이며 재시도할 때 증가합니다.","minimum":0}}}},"final_quality":{"type":"object","description":"최종 선택된 음원의 품질 검사 결과입니다. 최종 검사 전에는 null이거나 생략됩니다.","properties":{"schema_version":{"type":"string","description":"품질 결과 JSON의 규격 버전입니다. 필드 구성이 바뀔 때 증가하며, 클라이언트는 이 값을 기준으로 호환성을 판단할 수 있습니다."},"attempt":{"type":"integer","description":"현재 품질 검사가 몇 번째 시도인지 나타냅니다. 재검사할 때마다 증가하며, 후보별 attempt와 다를 수 있습니다."},"phase":{"type":"string","description":"작업이 현재 어느 처리 단계에 있는지 나타냅니다. waiting·processing·completed·failed 같은 값으로 진행 상태를 구분합니다."},"accepted_utterances":{"type":"integer","description":"품질 검사를 통과한 발화 수입니다. 전체 발화 수와 비교해 실패·미검사 발화를 파악하세요."},"failed_utterances":{"type":"integer","description":"품질 검사에서 실패한 발화 수입니다. 0이 아니면 실패 사유와 재시도 필요 여부를 함께 확인하세요."},"total_utterances":{"type":"integer","description":"이 작업에 포함된 전체 발화 수입니다. accepted_utterances + failed_utterances와 같거나, 아직 검사 전인 발화가 있으면 더 클 수 있습니다."},"expires_at":{"type":"string","description":"후보 음원·검사 결과를 보관하는 만료 시각입니다. 이 시각이 지나면 후보 다운로드가 불가능할 수 있으며, 검사 전에는 null입니다.","nullable":true},"queue_elapsed_sec":{"type":"number","description":"작업이 대기열에서 기다린 시간(초)입니다. 생성 시간과 분리해 지연 원인을 파악할 때 사용합니다."},"generation_elapsed_sec":{"type":"number","description":"실제 음성 생성에 걸린 시간(초)입니다. 대기 시간을 제외한 처리 시간입니다."},"utterances":{"type":"array","description":"발화별 품질 검사 결과 목록입니다. 각 항목은 발화 ID·후보 ID·속도·반복·참조 검사 값을 포함합니다.","items":{"type":"object","description":"발화·음원 후보별 공개 검사 결과. 단계별로 제공되는 항목만 포함합니다.","properties":{"id":{"type":"string","description":"이 검사 항목의 식별자입니다. 같은 응답 안에서 항목을 구분할 때 사용하며, 발화 ID와 다를 수 있습니다."},"utterance_id":{"type":"string","description":"검사 대상 발화의 식별자입니다. 요청의 utterances 순서대로 u001·u002처럼 부여되며, 같은 발화의 여러 후보를 묶을 때 사용합니다."},"candidate_id":{"type":"string","description":"생성된 음성 후보의 식별자입니다. 같은 발화에 후보가 여러 개일 때 각 후보를 구분하며, 후보 오디오 경로에 사용합니다."},"status":{"type":"string","description":"이 항목의 처리·검사 상태입니다. waiting·processing·completed·failed 같은 값이 들어가며, 실패 사유는 reasons에서 확인하세요."},"attempt":{"type":"integer","description":"이 후보를 생성한 시도 회차입니다. 1부터 시작하며 재생성할 때마다 증가합니다."},"voice_id":{"type":"string","description":"합성에 사용한 공개 목소리 ID입니다. 요청의 voice_id와 같으며, 목소리 목록 API에서 확인한 값을 그대로 반영합니다."},"created_at":{"type":"string","description":"이 발화·후보가 생성된 시각입니다. ISO 8601 형식이며 시간대가 포함됩니다."},"elapsed_sec":{"type":"number","description":"이 항목의 생성·검사에 걸린 경과 시간(초)입니다. 대기열에서 기다린 시간은 포함하지 않을 수 있습니다."},"reasons":{"type":"array","description":"검사·실패 사유 목록입니다. 통과·주의·실패 판정의 근거가 문장으로 들어가며, 사유가 없으면 빈 배열입니다.","items":{"type":"string","description":"검사 결과 사유."}},"speech_rate":{"type":"object","description":"발화 속도 검사. 검사 단계에 따라 일부 필드는 생략됩니다.","properties":{"characters":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. 공백과 문장부호를 포함하며, chars와 같은 값을 다른 이름으로 제공합니다."},"chars":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. characters와 동일한 값이며, 기존 클라이언트 호환을 위해 함께 제공됩니다."},"duration_sec":{"type":"number","description":"측정된 음성의 실제 길이(초)입니다. 무음 구간이 포함될 수 있고, 초당 글자 수 계산의 기준이 됩니다."},"duration_ms":{"type":"number","description":"측정된 음성의 실제 길이(밀리초)입니다. duration_sec와 같은 값을 단위만 바꿔 제공합니다."},"cps":{"type":"number","description":"초당 발화 글자 수입니다. 값이 높을수록 빠르게 말한 것이며, min_cps보다 낮으면 지나치게 느린 발화로 판정될 수 있습니다."},"expected_sec":{"type":"number","description":"같은 글자 수를 기준 속도로 읽었을 때 예상되는 발화 길이(초)입니다. 실제 길이와 비교해 속도 편차를 계산합니다."},"expected_duration_ms":{"type":"number","description":"예상 발화 길이(밀리초)입니다. expected_sec와 같은 값을 단위만 바꿔 제공합니다."},"duration_ratio":{"type":"number","description":"실제 음성 길이를 예상 길이로 나눈 비율입니다. 1보다 크면 예상보다 느리고, 1보다 작으면 빠릅니다. 계산할 수 없으면 null입니다.","nullable":true},"min_cps":{"type":"number","description":"이 검사에서 허용하는 최소 초당 글자 수입니다. cps가 이 값보다 낮으면 속도 검사에서 주의·실패로 표시됩니다."},"minimum_characters":{"type":"integer","description":"속도 검사를 수행하는 데 필요한 최소 글자 수입니다. 이보다 짧은 발화는 속도 판정을 생략할 수 있습니다."},"status":{"type":"string","description":"속도 검사 결과입니다. 통과·주의·실패 같은 판정 값이 들어가며, 상세 사유는 같은 항목의 reasons를 확인하세요."}}},"audio_sha256":{"type":"string","description":"후보 음원의 SHA-256 해시입니다. 같은 음원인지 무결성을 비교할 때 사용하며, 음원이 없으면 생략됩니다."},"audio_duration_ms":{"type":"number","description":"후보 음원의 실제 길이(밀리초)입니다. 발화 속도·무음 구간 검사의 기준 값으로 사용됩니다."},"audio_available":{"type":"boolean","description":"이 후보의 음원을 다운로드할 수 있는지 여부입니다. false면 생성 실패·보관 만료 등으로 파일이 없습니다."},"transcript":{"type":"string","description":"후보 음원에서 음성 인식으로 얻은 텍스트입니다. 원문과 비교해 CER·coverage를 계산합니다."},"cer":{"type":"number","description":"문자 오류율(Character Error Rate)입니다. 0에 가까울수록 원문과 정확히 일치하며, 1 이상이면 많은 문자가 틀렸다는 뜻입니다."},"coverage":{"type":"number","description":"원문 글자 중 음성에서 실제로 인식된 비율입니다. 1에 가까울수록 원문을 빠짐없이 읽었습니다."},"repeat":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"reference_intrusion":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"text_qa_status":{"type":"string","description":"합성 텍스트와 인식 텍스트의 일치 검사 상태입니다. 통과·주의·실패 값이 들어가며, 상세 사유는 reasons를 확인하세요."},"active_start_ms":{"type":"number","description":"음원에서 실제 발화가 시작된 위치(밀리초)입니다. 앞부분 무음 구간을 제외한 유효 음성의 시작점입니다."},"active_end_ms":{"type":"number","description":"음원에서 실제 발화가 끝난 위치(밀리초)입니다. 뒷부분 무음·보호 구간을 제외한 유효 음성의 끝점입니다."},"tail_guard_attached":{"type":"boolean","description":"끝부분 잘림을 확인하기 위한 보호 구간이 음원에 붙었는지 여부입니다. 검사용으로만 쓰며 최종 음원에는 포함되지 않습니다."},"tail_verified":{"type":"boolean","description":"끝부분까지 정상적으로 생성됐는지 검증을 마쳤는지 여부입니다. false면 끝단 검사가 아직 끝나지 않았습니다."},"tail_verified_at_ms":{"type":"number","description":"끝부분 검증을 수행한 시각(밀리초)입니다. 검증 전에는 null이며, 값이 있으면 tail_verified와 함께 확인하세요.","nullable":true},"tail_body_end_at_ms":{"type":"number","description":"보호 구간을 제외한 실제 본문의 끝 위치(밀리초)입니다. 잘림 판정의 기준점으로 사용됩니다.","nullable":true},"tail_guard_attached_chunk_ids":{"type":"array","description":"보호 구간이 붙은 음성 구간 ID 목록입니다. 어느 구간까지 끝단 검사를 적용했는지 확인할 때 사용합니다.","items":{"type":"string","description":"확인한 구간 ID."}},"generation_budget_exhausted":{"type":"boolean","description":"이 발화의 자동 생성 시도 한도를 모두 사용했는지 여부입니다. true면 같은 조건으로는 더 이상 자동 재생성되지 않습니다."},"retry_requires_new_regeneration_key":{"type":"boolean","description":"재시도에 새 재생성 키가 필요한 상태인지 여부입니다. true면 기존 요청을 반복해도 새 후보가 생성되지 않습니다."},"candidate_revision":{"type":"integer","description":"재시도 회차. 0은 최초 생성이며 재시도할 때 증가합니다.","minimum":0}}}},"candidates":{"type":"array","description":"음성 후보별 품질 검사 결과 목록입니다. 같은 발화의 여러 후보를 비교해 최종 후보를 고를 때 사용합니다.","items":{"type":"object","description":"발화·음원 후보별 공개 검사 결과. 단계별로 제공되는 항목만 포함합니다.","properties":{"id":{"type":"string","description":"이 검사 항목의 식별자입니다. 같은 응답 안에서 항목을 구분할 때 사용하며, 발화 ID와 다를 수 있습니다."},"utterance_id":{"type":"string","description":"검사 대상 발화의 식별자입니다. 요청의 utterances 순서대로 u001·u002처럼 부여되며, 같은 발화의 여러 후보를 묶을 때 사용합니다."},"candidate_id":{"type":"string","description":"생성된 음성 후보의 식별자입니다. 같은 발화에 후보가 여러 개일 때 각 후보를 구분하며, 후보 오디오 경로에 사용합니다."},"status":{"type":"string","description":"이 항목의 처리·검사 상태입니다. waiting·processing·completed·failed 같은 값이 들어가며, 실패 사유는 reasons에서 확인하세요."},"attempt":{"type":"integer","description":"이 후보를 생성한 시도 회차입니다. 1부터 시작하며 재생성할 때마다 증가합니다."},"voice_id":{"type":"string","description":"합성에 사용한 공개 목소리 ID입니다. 요청의 voice_id와 같으며, 목소리 목록 API에서 확인한 값을 그대로 반영합니다."},"created_at":{"type":"string","description":"이 발화·후보가 생성된 시각입니다. ISO 8601 형식이며 시간대가 포함됩니다."},"elapsed_sec":{"type":"number","description":"이 항목의 생성·검사에 걸린 경과 시간(초)입니다. 대기열에서 기다린 시간은 포함하지 않을 수 있습니다."},"reasons":{"type":"array","description":"검사·실패 사유 목록입니다. 통과·주의·실패 판정의 근거가 문장으로 들어가며, 사유가 없으면 빈 배열입니다.","items":{"type":"string","description":"검사 결과 사유."}},"speech_rate":{"type":"object","description":"발화 속도 검사. 검사 단계에 따라 일부 필드는 생략됩니다.","properties":{"characters":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. 공백과 문장부호를 포함하며, chars와 같은 값을 다른 이름으로 제공합니다."},"chars":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. characters와 동일한 값이며, 기존 클라이언트 호환을 위해 함께 제공됩니다."},"duration_sec":{"type":"number","description":"측정된 음성의 실제 길이(초)입니다. 무음 구간이 포함될 수 있고, 초당 글자 수 계산의 기준이 됩니다."},"duration_ms":{"type":"number","description":"측정된 음성의 실제 길이(밀리초)입니다. duration_sec와 같은 값을 단위만 바꿔 제공합니다."},"cps":{"type":"number","description":"초당 발화 글자 수입니다. 값이 높을수록 빠르게 말한 것이며, min_cps보다 낮으면 지나치게 느린 발화로 판정될 수 있습니다."},"expected_sec":{"type":"number","description":"같은 글자 수를 기준 속도로 읽었을 때 예상되는 발화 길이(초)입니다. 실제 길이와 비교해 속도 편차를 계산합니다."},"expected_duration_ms":{"type":"number","description":"예상 발화 길이(밀리초)입니다. expected_sec와 같은 값을 단위만 바꿔 제공합니다."},"duration_ratio":{"type":"number","description":"실제 음성 길이를 예상 길이로 나눈 비율입니다. 1보다 크면 예상보다 느리고, 1보다 작으면 빠릅니다. 계산할 수 없으면 null입니다.","nullable":true},"min_cps":{"type":"number","description":"이 검사에서 허용하는 최소 초당 글자 수입니다. cps가 이 값보다 낮으면 속도 검사에서 주의·실패로 표시됩니다."},"minimum_characters":{"type":"integer","description":"속도 검사를 수행하는 데 필요한 최소 글자 수입니다. 이보다 짧은 발화는 속도 판정을 생략할 수 있습니다."},"status":{"type":"string","description":"속도 검사 결과입니다. 통과·주의·실패 같은 판정 값이 들어가며, 상세 사유는 같은 항목의 reasons를 확인하세요."}}},"audio_sha256":{"type":"string","description":"후보 음원의 SHA-256 해시입니다. 같은 음원인지 무결성을 비교할 때 사용하며, 음원이 없으면 생략됩니다."},"audio_duration_ms":{"type":"number","description":"후보 음원의 실제 길이(밀리초)입니다. 발화 속도·무음 구간 검사의 기준 값으로 사용됩니다."},"audio_available":{"type":"boolean","description":"이 후보의 음원을 다운로드할 수 있는지 여부입니다. false면 생성 실패·보관 만료 등으로 파일이 없습니다."},"transcript":{"type":"string","description":"후보 음원에서 음성 인식으로 얻은 텍스트입니다. 원문과 비교해 CER·coverage를 계산합니다."},"cer":{"type":"number","description":"문자 오류율(Character Error Rate)입니다. 0에 가까울수록 원문과 정확히 일치하며, 1 이상이면 많은 문자가 틀렸다는 뜻입니다."},"coverage":{"type":"number","description":"원문 글자 중 음성에서 실제로 인식된 비율입니다. 1에 가까울수록 원문을 빠짐없이 읽었습니다."},"repeat":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"reference_intrusion":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"text_qa_status":{"type":"string","description":"합성 텍스트와 인식 텍스트의 일치 검사 상태입니다. 통과·주의·실패 값이 들어가며, 상세 사유는 reasons를 확인하세요."},"active_start_ms":{"type":"number","description":"음원에서 실제 발화가 시작된 위치(밀리초)입니다. 앞부분 무음 구간을 제외한 유효 음성의 시작점입니다."},"active_end_ms":{"type":"number","description":"음원에서 실제 발화가 끝난 위치(밀리초)입니다. 뒷부분 무음·보호 구간을 제외한 유효 음성의 끝점입니다."},"tail_guard_attached":{"type":"boolean","description":"끝부분 잘림을 확인하기 위한 보호 구간이 음원에 붙었는지 여부입니다. 검사용으로만 쓰며 최종 음원에는 포함되지 않습니다."},"tail_verified":{"type":"boolean","description":"끝부분까지 정상적으로 생성됐는지 검증을 마쳤는지 여부입니다. false면 끝단 검사가 아직 끝나지 않았습니다."},"tail_verified_at_ms":{"type":"number","description":"끝부분 검증을 수행한 시각(밀리초)입니다. 검증 전에는 null이며, 값이 있으면 tail_verified와 함께 확인하세요.","nullable":true},"tail_body_end_at_ms":{"type":"number","description":"보호 구간을 제외한 실제 본문의 끝 위치(밀리초)입니다. 잘림 판정의 기준점으로 사용됩니다.","nullable":true},"tail_guard_attached_chunk_ids":{"type":"array","description":"보호 구간이 붙은 음성 구간 ID 목록입니다. 어느 구간까지 끝단 검사를 적용했는지 확인할 때 사용합니다.","items":{"type":"string","description":"확인한 구간 ID."}},"generation_budget_exhausted":{"type":"boolean","description":"이 발화의 자동 생성 시도 한도를 모두 사용했는지 여부입니다. true면 같은 조건으로는 더 이상 자동 재생성되지 않습니다."},"retry_requires_new_regeneration_key":{"type":"boolean","description":"재시도에 새 재생성 키가 필요한 상태인지 여부입니다. true면 기존 요청을 반복해도 새 후보가 생성되지 않습니다."},"candidate_revision":{"type":"integer","description":"재시도 회차. 0은 최초 생성이며 재시도할 때 증가합니다.","minimum":0}}}},"status":{"type":"string","description":"최종 선택된 음원의 검사 상태입니다. 통과·주의·실패 값을 확인해 다운로드 가능 여부를 판단하세요."},"audio_sha256":{"type":"string","description":"최종 선택된 음원의 SHA-256 해시입니다. 다운로드한 파일의 무결성을 확인할 때 사용합니다."}}}},"nullable":true},"error":{"type":"object","description":"실패 상태일 때 포함합니다.","properties":{"code":{"type":"string","description":"실패한 작업의 공개 오류코드."},"message":{"type":"string","description":"오류 설명."}}}}},"api":{"type":"object","description":"호출 메타데이터.","properties":{"success":{"type":"boolean","description":"API 공통 처리 여부. HTTP 상태·업무 결과와 함께 확인합니다."},"cost":{"type":"number","description":"이번 호출에서 차감한 포인트. 무료 조회·재전송은 0."},"pl_id":{"type":"integer","description":"과금 기록 ID. 과금 기록이 있을 때만 포함합니다."}}}}}}}},"default":{"description":"TTS_REQUEST_INVALID (400·413·422): 목소리·문자 수·발화 구조·입력 크기를 확인하세요.\nTTS_AUTH_FAILED (401): 인증키를 확인하세요.\nTTS_ACCESS_DISABLED (403): 계정의 API 이용 제한 상태를 확인하세요.\nTTS_PAYMENT_REQUIRED (403): 최초 결제를 완료한 뒤 이용하세요.\nTTS_INSUFFICIENT_POINTS (402): 필요한 포인트를 충전하세요.\nTTS_NOT_FOUND (404): 작업·후보 ID와 소유 계정을 확인하세요.\nTTS_JOB_CONFLICT (409): 작업 상태·재시도 회차·같은 멱등 키의 요청 내용을 확인하세요.\nTTS_GENERATION_FAILED (409): 실패 상태를 확인하고 입력을 수정하거나 새 작업을 접수하세요.\nTTS_RESULT_UNAVAILABLE (410): 파일이 이미 다운로드됐거나 보관 기간이 만료됐습니다.\nTTS_TEMPORARILY_UNAVAILABLE (429·503): Retry-After 이후 다시 시도하세요. 재시도 요청에는 같은 멱등 키를 사용하세요.\nTTS_BILLING_FAILED (424): 결제를 완료하지 못했습니다. Retry-After 이후 다시 시도하세요.\nTTS_INTERNAL_ERROR (500): 잠시 후 다시 시도하세요.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/rest/tts/options":{"get":{"summary":"한국어 AI 내레이션 TTS","description":"한국어 대본을 보내면 음성(MP3)과 발화 시각이 맞춰진 ASS 자막을 함께 만들어 줍니다. 작업을 접수한 뒤 상태를 확인하고, 완료되면 두 파일을 내려받는 방식입니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스 응답","content":{"application/json":{"schema":{"type":"object","description":"공개 JSON 응답.","properties":{"data":{"type":"object","properties":{"job_id":{"type":"string","description":"접수 응답에서 받은 작업 ID. 같은 계정의 작업에만 접근할 수 있습니다."},"status":{"type":"string","description":"작업 진행 상태. 완료 여부와 다운로드 가능 여부를 함께 확인합니다.","enum":["waiting","processing","completed","cancelled","failed"]},"result_available":{"type":"boolean","description":"최종 MP3를 내려받을 수 있는지 여부."},"subtitles_available":{"type":"boolean","description":"자막을 내려받을 수 있는지 여부."},"resume_revision":{"type":"integer","description":"재시도 회차. 0은 최초 생성이며 재시도할 때 증가합니다.","minimum":0},"quality":{"type":"object","description":"품질 상세. 아직 검사 전이면 null이거나 생략됩니다.","properties":{"schema_version":{"type":"string","description":"품질 결과 JSON의 규격 버전입니다. 필드 구성이 바뀔 때 증가하며, 클라이언트는 이 값을 기준으로 호환성을 판단할 수 있습니다."},"attempt":{"type":"integer","description":"현재 품질 검사가 몇 번째 시도인지 나타냅니다. 재검사할 때마다 증가하며, 후보별 attempt와 다를 수 있습니다."},"phase":{"type":"string","description":"작업이 현재 어느 처리 단계에 있는지 나타냅니다. waiting·processing·completed·failed 같은 값으로 진행 상태를 구분합니다."},"accepted_utterances":{"type":"integer","description":"품질 검사를 통과한 발화 수입니다. 전체 발화 수와 비교해 실패·미검사 발화를 파악하세요."},"failed_utterances":{"type":"integer","description":"품질 검사에서 실패한 발화 수입니다. 0이 아니면 실패 사유와 재시도 필요 여부를 함께 확인하세요."},"total_utterances":{"type":"integer","description":"이 작업에 포함된 전체 발화 수입니다. accepted_utterances + failed_utterances와 같거나, 아직 검사 전인 발화가 있으면 더 클 수 있습니다."},"expires_at":{"type":"string","description":"후보 음원·검사 결과를 보관하는 만료 시각입니다. 이 시각이 지나면 후보 다운로드가 불가능할 수 있으며, 검사 전에는 null입니다.","nullable":true},"queue_elapsed_sec":{"type":"number","description":"작업이 대기열에서 기다린 시간(초)입니다. 생성 시간과 분리해 지연 원인을 파악할 때 사용합니다."},"generation_elapsed_sec":{"type":"number","description":"실제 음성 생성에 걸린 시간(초)입니다. 대기 시간을 제외한 처리 시간입니다."},"utterances":{"type":"array","description":"발화별 품질 검사 결과 목록입니다. 각 항목은 발화 ID·후보 ID·속도·반복·참조 검사 값을 포함합니다.","items":{"type":"object","description":"발화·음원 후보별 공개 검사 결과. 단계별로 제공되는 항목만 포함합니다.","properties":{"id":{"type":"string","description":"이 검사 항목의 식별자입니다. 같은 응답 안에서 항목을 구분할 때 사용하며, 발화 ID와 다를 수 있습니다."},"utterance_id":{"type":"string","description":"검사 대상 발화의 식별자입니다. 요청의 utterances 순서대로 u001·u002처럼 부여되며, 같은 발화의 여러 후보를 묶을 때 사용합니다."},"candidate_id":{"type":"string","description":"생성된 음성 후보의 식별자입니다. 같은 발화에 후보가 여러 개일 때 각 후보를 구분하며, 후보 오디오 경로에 사용합니다."},"status":{"type":"string","description":"이 항목의 처리·검사 상태입니다. waiting·processing·completed·failed 같은 값이 들어가며, 실패 사유는 reasons에서 확인하세요."},"attempt":{"type":"integer","description":"이 후보를 생성한 시도 회차입니다. 1부터 시작하며 재생성할 때마다 증가합니다."},"voice_id":{"type":"string","description":"합성에 사용한 공개 목소리 ID입니다. 요청의 voice_id와 같으며, 목소리 목록 API에서 확인한 값을 그대로 반영합니다."},"created_at":{"type":"string","description":"이 발화·후보가 생성된 시각입니다. ISO 8601 형식이며 시간대가 포함됩니다."},"elapsed_sec":{"type":"number","description":"이 항목의 생성·검사에 걸린 경과 시간(초)입니다. 대기열에서 기다린 시간은 포함하지 않을 수 있습니다."},"reasons":{"type":"array","description":"검사·실패 사유 목록입니다. 통과·주의·실패 판정의 근거가 문장으로 들어가며, 사유가 없으면 빈 배열입니다.","items":{"type":"string","description":"검사 결과 사유."}},"speech_rate":{"type":"object","description":"발화 속도 검사. 검사 단계에 따라 일부 필드는 생략됩니다.","properties":{"characters":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. 공백과 문장부호를 포함하며, chars와 같은 값을 다른 이름으로 제공합니다."},"chars":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. characters와 동일한 값이며, 기존 클라이언트 호환을 위해 함께 제공됩니다."},"duration_sec":{"type":"number","description":"측정된 음성의 실제 길이(초)입니다. 무음 구간이 포함될 수 있고, 초당 글자 수 계산의 기준이 됩니다."},"duration_ms":{"type":"number","description":"측정된 음성의 실제 길이(밀리초)입니다. duration_sec와 같은 값을 단위만 바꿔 제공합니다."},"cps":{"type":"number","description":"초당 발화 글자 수입니다. 값이 높을수록 빠르게 말한 것이며, min_cps보다 낮으면 지나치게 느린 발화로 판정될 수 있습니다."},"expected_sec":{"type":"number","description":"같은 글자 수를 기준 속도로 읽었을 때 예상되는 발화 길이(초)입니다. 실제 길이와 비교해 속도 편차를 계산합니다."},"expected_duration_ms":{"type":"number","description":"예상 발화 길이(밀리초)입니다. expected_sec와 같은 값을 단위만 바꿔 제공합니다."},"duration_ratio":{"type":"number","description":"실제 음성 길이를 예상 길이로 나눈 비율입니다. 1보다 크면 예상보다 느리고, 1보다 작으면 빠릅니다. 계산할 수 없으면 null입니다.","nullable":true},"min_cps":{"type":"number","description":"이 검사에서 허용하는 최소 초당 글자 수입니다. cps가 이 값보다 낮으면 속도 검사에서 주의·실패로 표시됩니다."},"minimum_characters":{"type":"integer","description":"속도 검사를 수행하는 데 필요한 최소 글자 수입니다. 이보다 짧은 발화는 속도 판정을 생략할 수 있습니다."},"status":{"type":"string","description":"속도 검사 결과입니다. 통과·주의·실패 같은 판정 값이 들어가며, 상세 사유는 같은 항목의 reasons를 확인하세요."}}},"audio_sha256":{"type":"string","description":"후보 음원의 SHA-256 해시입니다. 같은 음원인지 무결성을 비교할 때 사용하며, 음원이 없으면 생략됩니다."},"audio_duration_ms":{"type":"number","description":"후보 음원의 실제 길이(밀리초)입니다. 발화 속도·무음 구간 검사의 기준 값으로 사용됩니다."},"audio_available":{"type":"boolean","description":"이 후보의 음원을 다운로드할 수 있는지 여부입니다. false면 생성 실패·보관 만료 등으로 파일이 없습니다."},"transcript":{"type":"string","description":"후보 음원에서 음성 인식으로 얻은 텍스트입니다. 원문과 비교해 CER·coverage를 계산합니다."},"cer":{"type":"number","description":"문자 오류율(Character Error Rate)입니다. 0에 가까울수록 원문과 정확히 일치하며, 1 이상이면 많은 문자가 틀렸다는 뜻입니다."},"coverage":{"type":"number","description":"원문 글자 중 음성에서 실제로 인식된 비율입니다. 1에 가까울수록 원문을 빠짐없이 읽었습니다."},"repeat":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"reference_intrusion":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"text_qa_status":{"type":"string","description":"합성 텍스트와 인식 텍스트의 일치 검사 상태입니다. 통과·주의·실패 값이 들어가며, 상세 사유는 reasons를 확인하세요."},"active_start_ms":{"type":"number","description":"음원에서 실제 발화가 시작된 위치(밀리초)입니다. 앞부분 무음 구간을 제외한 유효 음성의 시작점입니다."},"active_end_ms":{"type":"number","description":"음원에서 실제 발화가 끝난 위치(밀리초)입니다. 뒷부분 무음·보호 구간을 제외한 유효 음성의 끝점입니다."},"tail_guard_attached":{"type":"boolean","description":"끝부분 잘림을 확인하기 위한 보호 구간이 음원에 붙었는지 여부입니다. 검사용으로만 쓰며 최종 음원에는 포함되지 않습니다."},"tail_verified":{"type":"boolean","description":"끝부분까지 정상적으로 생성됐는지 검증을 마쳤는지 여부입니다. false면 끝단 검사가 아직 끝나지 않았습니다."},"tail_verified_at_ms":{"type":"number","description":"끝부분 검증을 수행한 시각(밀리초)입니다. 검증 전에는 null이며, 값이 있으면 tail_verified와 함께 확인하세요.","nullable":true},"tail_body_end_at_ms":{"type":"number","description":"보호 구간을 제외한 실제 본문의 끝 위치(밀리초)입니다. 잘림 판정의 기준점으로 사용됩니다.","nullable":true},"tail_guard_attached_chunk_ids":{"type":"array","description":"보호 구간이 붙은 음성 구간 ID 목록입니다. 어느 구간까지 끝단 검사를 적용했는지 확인할 때 사용합니다.","items":{"type":"string","description":"확인한 구간 ID."}},"generation_budget_exhausted":{"type":"boolean","description":"이 발화의 자동 생성 시도 한도를 모두 사용했는지 여부입니다. true면 같은 조건으로는 더 이상 자동 재생성되지 않습니다."},"retry_requires_new_regeneration_key":{"type":"boolean","description":"재시도에 새 재생성 키가 필요한 상태인지 여부입니다. true면 기존 요청을 반복해도 새 후보가 생성되지 않습니다."},"candidate_revision":{"type":"integer","description":"재시도 회차. 0은 최초 생성이며 재시도할 때 증가합니다.","minimum":0}}}},"candidates":{"type":"array","description":"음성 후보별 품질 검사 결과 목록입니다. 같은 발화의 여러 후보를 비교해 최종 후보를 고를 때 사용합니다.","items":{"type":"object","description":"발화·음원 후보별 공개 검사 결과. 단계별로 제공되는 항목만 포함합니다.","properties":{"id":{"type":"string","description":"이 검사 항목의 식별자입니다. 같은 응답 안에서 항목을 구분할 때 사용하며, 발화 ID와 다를 수 있습니다."},"utterance_id":{"type":"string","description":"검사 대상 발화의 식별자입니다. 요청의 utterances 순서대로 u001·u002처럼 부여되며, 같은 발화의 여러 후보를 묶을 때 사용합니다."},"candidate_id":{"type":"string","description":"생성된 음성 후보의 식별자입니다. 같은 발화에 후보가 여러 개일 때 각 후보를 구분하며, 후보 오디오 경로에 사용합니다."},"status":{"type":"string","description":"이 항목의 처리·검사 상태입니다. waiting·processing·completed·failed 같은 값이 들어가며, 실패 사유는 reasons에서 확인하세요."},"attempt":{"type":"integer","description":"이 후보를 생성한 시도 회차입니다. 1부터 시작하며 재생성할 때마다 증가합니다."},"voice_id":{"type":"string","description":"합성에 사용한 공개 목소리 ID입니다. 요청의 voice_id와 같으며, 목소리 목록 API에서 확인한 값을 그대로 반영합니다."},"created_at":{"type":"string","description":"이 발화·후보가 생성된 시각입니다. ISO 8601 형식이며 시간대가 포함됩니다."},"elapsed_sec":{"type":"number","description":"이 항목의 생성·검사에 걸린 경과 시간(초)입니다. 대기열에서 기다린 시간은 포함하지 않을 수 있습니다."},"reasons":{"type":"array","description":"검사·실패 사유 목록입니다. 통과·주의·실패 판정의 근거가 문장으로 들어가며, 사유가 없으면 빈 배열입니다.","items":{"type":"string","description":"검사 결과 사유."}},"speech_rate":{"type":"object","description":"발화 속도 검사. 검사 단계에 따라 일부 필드는 생략됩니다.","properties":{"characters":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. 공백과 문장부호를 포함하며, chars와 같은 값을 다른 이름으로 제공합니다."},"chars":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. characters와 동일한 값이며, 기존 클라이언트 호환을 위해 함께 제공됩니다."},"duration_sec":{"type":"number","description":"측정된 음성의 실제 길이(초)입니다. 무음 구간이 포함될 수 있고, 초당 글자 수 계산의 기준이 됩니다."},"duration_ms":{"type":"number","description":"측정된 음성의 실제 길이(밀리초)입니다. duration_sec와 같은 값을 단위만 바꿔 제공합니다."},"cps":{"type":"number","description":"초당 발화 글자 수입니다. 값이 높을수록 빠르게 말한 것이며, min_cps보다 낮으면 지나치게 느린 발화로 판정될 수 있습니다."},"expected_sec":{"type":"number","description":"같은 글자 수를 기준 속도로 읽었을 때 예상되는 발화 길이(초)입니다. 실제 길이와 비교해 속도 편차를 계산합니다."},"expected_duration_ms":{"type":"number","description":"예상 발화 길이(밀리초)입니다. expected_sec와 같은 값을 단위만 바꿔 제공합니다."},"duration_ratio":{"type":"number","description":"실제 음성 길이를 예상 길이로 나눈 비율입니다. 1보다 크면 예상보다 느리고, 1보다 작으면 빠릅니다. 계산할 수 없으면 null입니다.","nullable":true},"min_cps":{"type":"number","description":"이 검사에서 허용하는 최소 초당 글자 수입니다. cps가 이 값보다 낮으면 속도 검사에서 주의·실패로 표시됩니다."},"minimum_characters":{"type":"integer","description":"속도 검사를 수행하는 데 필요한 최소 글자 수입니다. 이보다 짧은 발화는 속도 판정을 생략할 수 있습니다."},"status":{"type":"string","description":"속도 검사 결과입니다. 통과·주의·실패 같은 판정 값이 들어가며, 상세 사유는 같은 항목의 reasons를 확인하세요."}}},"audio_sha256":{"type":"string","description":"후보 음원의 SHA-256 해시입니다. 같은 음원인지 무결성을 비교할 때 사용하며, 음원이 없으면 생략됩니다."},"audio_duration_ms":{"type":"number","description":"후보 음원의 실제 길이(밀리초)입니다. 발화 속도·무음 구간 검사의 기준 값으로 사용됩니다."},"audio_available":{"type":"boolean","description":"이 후보의 음원을 다운로드할 수 있는지 여부입니다. false면 생성 실패·보관 만료 등으로 파일이 없습니다."},"transcript":{"type":"string","description":"후보 음원에서 음성 인식으로 얻은 텍스트입니다. 원문과 비교해 CER·coverage를 계산합니다."},"cer":{"type":"number","description":"문자 오류율(Character Error Rate)입니다. 0에 가까울수록 원문과 정확히 일치하며, 1 이상이면 많은 문자가 틀렸다는 뜻입니다."},"coverage":{"type":"number","description":"원문 글자 중 음성에서 실제로 인식된 비율입니다. 1에 가까울수록 원문을 빠짐없이 읽었습니다."},"repeat":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"reference_intrusion":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"text_qa_status":{"type":"string","description":"합성 텍스트와 인식 텍스트의 일치 검사 상태입니다. 통과·주의·실패 값이 들어가며, 상세 사유는 reasons를 확인하세요."},"active_start_ms":{"type":"number","description":"음원에서 실제 발화가 시작된 위치(밀리초)입니다. 앞부분 무음 구간을 제외한 유효 음성의 시작점입니다."},"active_end_ms":{"type":"number","description":"음원에서 실제 발화가 끝난 위치(밀리초)입니다. 뒷부분 무음·보호 구간을 제외한 유효 음성의 끝점입니다."},"tail_guard_attached":{"type":"boolean","description":"끝부분 잘림을 확인하기 위한 보호 구간이 음원에 붙었는지 여부입니다. 검사용으로만 쓰며 최종 음원에는 포함되지 않습니다."},"tail_verified":{"type":"boolean","description":"끝부분까지 정상적으로 생성됐는지 검증을 마쳤는지 여부입니다. false면 끝단 검사가 아직 끝나지 않았습니다."},"tail_verified_at_ms":{"type":"number","description":"끝부분 검증을 수행한 시각(밀리초)입니다. 검증 전에는 null이며, 값이 있으면 tail_verified와 함께 확인하세요.","nullable":true},"tail_body_end_at_ms":{"type":"number","description":"보호 구간을 제외한 실제 본문의 끝 위치(밀리초)입니다. 잘림 판정의 기준점으로 사용됩니다.","nullable":true},"tail_guard_attached_chunk_ids":{"type":"array","description":"보호 구간이 붙은 음성 구간 ID 목록입니다. 어느 구간까지 끝단 검사를 적용했는지 확인할 때 사용합니다.","items":{"type":"string","description":"확인한 구간 ID."}},"generation_budget_exhausted":{"type":"boolean","description":"이 발화의 자동 생성 시도 한도를 모두 사용했는지 여부입니다. true면 같은 조건으로는 더 이상 자동 재생성되지 않습니다."},"retry_requires_new_regeneration_key":{"type":"boolean","description":"재시도에 새 재생성 키가 필요한 상태인지 여부입니다. true면 기존 요청을 반복해도 새 후보가 생성되지 않습니다."},"candidate_revision":{"type":"integer","description":"재시도 회차. 0은 최초 생성이며 재시도할 때 증가합니다.","minimum":0}}}},"final_quality":{"type":"object","description":"최종 선택된 음원의 품질 검사 결과입니다. 최종 검사 전에는 null이거나 생략됩니다.","properties":{"schema_version":{"type":"string","description":"품질 결과 JSON의 규격 버전입니다. 필드 구성이 바뀔 때 증가하며, 클라이언트는 이 값을 기준으로 호환성을 판단할 수 있습니다."},"attempt":{"type":"integer","description":"현재 품질 검사가 몇 번째 시도인지 나타냅니다. 재검사할 때마다 증가하며, 후보별 attempt와 다를 수 있습니다."},"phase":{"type":"string","description":"작업이 현재 어느 처리 단계에 있는지 나타냅니다. waiting·processing·completed·failed 같은 값으로 진행 상태를 구분합니다."},"accepted_utterances":{"type":"integer","description":"품질 검사를 통과한 발화 수입니다. 전체 발화 수와 비교해 실패·미검사 발화를 파악하세요."},"failed_utterances":{"type":"integer","description":"품질 검사에서 실패한 발화 수입니다. 0이 아니면 실패 사유와 재시도 필요 여부를 함께 확인하세요."},"total_utterances":{"type":"integer","description":"이 작업에 포함된 전체 발화 수입니다. accepted_utterances + failed_utterances와 같거나, 아직 검사 전인 발화가 있으면 더 클 수 있습니다."},"expires_at":{"type":"string","description":"후보 음원·검사 결과를 보관하는 만료 시각입니다. 이 시각이 지나면 후보 다운로드가 불가능할 수 있으며, 검사 전에는 null입니다.","nullable":true},"queue_elapsed_sec":{"type":"number","description":"작업이 대기열에서 기다린 시간(초)입니다. 생성 시간과 분리해 지연 원인을 파악할 때 사용합니다."},"generation_elapsed_sec":{"type":"number","description":"실제 음성 생성에 걸린 시간(초)입니다. 대기 시간을 제외한 처리 시간입니다."},"utterances":{"type":"array","description":"발화별 품질 검사 결과 목록입니다. 각 항목은 발화 ID·후보 ID·속도·반복·참조 검사 값을 포함합니다.","items":{"type":"object","description":"발화·음원 후보별 공개 검사 결과. 단계별로 제공되는 항목만 포함합니다.","properties":{"id":{"type":"string","description":"이 검사 항목의 식별자입니다. 같은 응답 안에서 항목을 구분할 때 사용하며, 발화 ID와 다를 수 있습니다."},"utterance_id":{"type":"string","description":"검사 대상 발화의 식별자입니다. 요청의 utterances 순서대로 u001·u002처럼 부여되며, 같은 발화의 여러 후보를 묶을 때 사용합니다."},"candidate_id":{"type":"string","description":"생성된 음성 후보의 식별자입니다. 같은 발화에 후보가 여러 개일 때 각 후보를 구분하며, 후보 오디오 경로에 사용합니다."},"status":{"type":"string","description":"이 항목의 처리·검사 상태입니다. waiting·processing·completed·failed 같은 값이 들어가며, 실패 사유는 reasons에서 확인하세요."},"attempt":{"type":"integer","description":"이 후보를 생성한 시도 회차입니다. 1부터 시작하며 재생성할 때마다 증가합니다."},"voice_id":{"type":"string","description":"합성에 사용한 공개 목소리 ID입니다. 요청의 voice_id와 같으며, 목소리 목록 API에서 확인한 값을 그대로 반영합니다."},"created_at":{"type":"string","description":"이 발화·후보가 생성된 시각입니다. ISO 8601 형식이며 시간대가 포함됩니다."},"elapsed_sec":{"type":"number","description":"이 항목의 생성·검사에 걸린 경과 시간(초)입니다. 대기열에서 기다린 시간은 포함하지 않을 수 있습니다."},"reasons":{"type":"array","description":"검사·실패 사유 목록입니다. 통과·주의·실패 판정의 근거가 문장으로 들어가며, 사유가 없으면 빈 배열입니다.","items":{"type":"string","description":"검사 결과 사유."}},"speech_rate":{"type":"object","description":"발화 속도 검사. 검사 단계에 따라 일부 필드는 생략됩니다.","properties":{"characters":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. 공백과 문장부호를 포함하며, chars와 같은 값을 다른 이름으로 제공합니다."},"chars":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. characters와 동일한 값이며, 기존 클라이언트 호환을 위해 함께 제공됩니다."},"duration_sec":{"type":"number","description":"측정된 음성의 실제 길이(초)입니다. 무음 구간이 포함될 수 있고, 초당 글자 수 계산의 기준이 됩니다."},"duration_ms":{"type":"number","description":"측정된 음성의 실제 길이(밀리초)입니다. duration_sec와 같은 값을 단위만 바꿔 제공합니다."},"cps":{"type":"number","description":"초당 발화 글자 수입니다. 값이 높을수록 빠르게 말한 것이며, min_cps보다 낮으면 지나치게 느린 발화로 판정될 수 있습니다."},"expected_sec":{"type":"number","description":"같은 글자 수를 기준 속도로 읽었을 때 예상되는 발화 길이(초)입니다. 실제 길이와 비교해 속도 편차를 계산합니다."},"expected_duration_ms":{"type":"number","description":"예상 발화 길이(밀리초)입니다. expected_sec와 같은 값을 단위만 바꿔 제공합니다."},"duration_ratio":{"type":"number","description":"실제 음성 길이를 예상 길이로 나눈 비율입니다. 1보다 크면 예상보다 느리고, 1보다 작으면 빠릅니다. 계산할 수 없으면 null입니다.","nullable":true},"min_cps":{"type":"number","description":"이 검사에서 허용하는 최소 초당 글자 수입니다. cps가 이 값보다 낮으면 속도 검사에서 주의·실패로 표시됩니다."},"minimum_characters":{"type":"integer","description":"속도 검사를 수행하는 데 필요한 최소 글자 수입니다. 이보다 짧은 발화는 속도 판정을 생략할 수 있습니다."},"status":{"type":"string","description":"속도 검사 결과입니다. 통과·주의·실패 같은 판정 값이 들어가며, 상세 사유는 같은 항목의 reasons를 확인하세요."}}},"audio_sha256":{"type":"string","description":"후보 음원의 SHA-256 해시입니다. 같은 음원인지 무결성을 비교할 때 사용하며, 음원이 없으면 생략됩니다."},"audio_duration_ms":{"type":"number","description":"후보 음원의 실제 길이(밀리초)입니다. 발화 속도·무음 구간 검사의 기준 값으로 사용됩니다."},"audio_available":{"type":"boolean","description":"이 후보의 음원을 다운로드할 수 있는지 여부입니다. false면 생성 실패·보관 만료 등으로 파일이 없습니다."},"transcript":{"type":"string","description":"후보 음원에서 음성 인식으로 얻은 텍스트입니다. 원문과 비교해 CER·coverage를 계산합니다."},"cer":{"type":"number","description":"문자 오류율(Character Error Rate)입니다. 0에 가까울수록 원문과 정확히 일치하며, 1 이상이면 많은 문자가 틀렸다는 뜻입니다."},"coverage":{"type":"number","description":"원문 글자 중 음성에서 실제로 인식된 비율입니다. 1에 가까울수록 원문을 빠짐없이 읽었습니다."},"repeat":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"reference_intrusion":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"text_qa_status":{"type":"string","description":"합성 텍스트와 인식 텍스트의 일치 검사 상태입니다. 통과·주의·실패 값이 들어가며, 상세 사유는 reasons를 확인하세요."},"active_start_ms":{"type":"number","description":"음원에서 실제 발화가 시작된 위치(밀리초)입니다. 앞부분 무음 구간을 제외한 유효 음성의 시작점입니다."},"active_end_ms":{"type":"number","description":"음원에서 실제 발화가 끝난 위치(밀리초)입니다. 뒷부분 무음·보호 구간을 제외한 유효 음성의 끝점입니다."},"tail_guard_attached":{"type":"boolean","description":"끝부분 잘림을 확인하기 위한 보호 구간이 음원에 붙었는지 여부입니다. 검사용으로만 쓰며 최종 음원에는 포함되지 않습니다."},"tail_verified":{"type":"boolean","description":"끝부분까지 정상적으로 생성됐는지 검증을 마쳤는지 여부입니다. false면 끝단 검사가 아직 끝나지 않았습니다."},"tail_verified_at_ms":{"type":"number","description":"끝부분 검증을 수행한 시각(밀리초)입니다. 검증 전에는 null이며, 값이 있으면 tail_verified와 함께 확인하세요.","nullable":true},"tail_body_end_at_ms":{"type":"number","description":"보호 구간을 제외한 실제 본문의 끝 위치(밀리초)입니다. 잘림 판정의 기준점으로 사용됩니다.","nullable":true},"tail_guard_attached_chunk_ids":{"type":"array","description":"보호 구간이 붙은 음성 구간 ID 목록입니다. 어느 구간까지 끝단 검사를 적용했는지 확인할 때 사용합니다.","items":{"type":"string","description":"확인한 구간 ID."}},"generation_budget_exhausted":{"type":"boolean","description":"이 발화의 자동 생성 시도 한도를 모두 사용했는지 여부입니다. true면 같은 조건으로는 더 이상 자동 재생성되지 않습니다."},"retry_requires_new_regeneration_key":{"type":"boolean","description":"재시도에 새 재생성 키가 필요한 상태인지 여부입니다. true면 기존 요청을 반복해도 새 후보가 생성되지 않습니다."},"candidate_revision":{"type":"integer","description":"재시도 회차. 0은 최초 생성이며 재시도할 때 증가합니다.","minimum":0}}}},"candidates":{"type":"array","description":"음성 후보별 품질 검사 결과 목록입니다. 같은 발화의 여러 후보를 비교해 최종 후보를 고를 때 사용합니다.","items":{"type":"object","description":"발화·음원 후보별 공개 검사 결과. 단계별로 제공되는 항목만 포함합니다.","properties":{"id":{"type":"string","description":"이 검사 항목의 식별자입니다. 같은 응답 안에서 항목을 구분할 때 사용하며, 발화 ID와 다를 수 있습니다."},"utterance_id":{"type":"string","description":"검사 대상 발화의 식별자입니다. 요청의 utterances 순서대로 u001·u002처럼 부여되며, 같은 발화의 여러 후보를 묶을 때 사용합니다."},"candidate_id":{"type":"string","description":"생성된 음성 후보의 식별자입니다. 같은 발화에 후보가 여러 개일 때 각 후보를 구분하며, 후보 오디오 경로에 사용합니다."},"status":{"type":"string","description":"이 항목의 처리·검사 상태입니다. waiting·processing·completed·failed 같은 값이 들어가며, 실패 사유는 reasons에서 확인하세요."},"attempt":{"type":"integer","description":"이 후보를 생성한 시도 회차입니다. 1부터 시작하며 재생성할 때마다 증가합니다."},"voice_id":{"type":"string","description":"합성에 사용한 공개 목소리 ID입니다. 요청의 voice_id와 같으며, 목소리 목록 API에서 확인한 값을 그대로 반영합니다."},"created_at":{"type":"string","description":"이 발화·후보가 생성된 시각입니다. ISO 8601 형식이며 시간대가 포함됩니다."},"elapsed_sec":{"type":"number","description":"이 항목의 생성·검사에 걸린 경과 시간(초)입니다. 대기열에서 기다린 시간은 포함하지 않을 수 있습니다."},"reasons":{"type":"array","description":"검사·실패 사유 목록입니다. 통과·주의·실패 판정의 근거가 문장으로 들어가며, 사유가 없으면 빈 배열입니다.","items":{"type":"string","description":"검사 결과 사유."}},"speech_rate":{"type":"object","description":"발화 속도 검사. 검사 단계에 따라 일부 필드는 생략됩니다.","properties":{"characters":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. 공백과 문장부호를 포함하며, chars와 같은 값을 다른 이름으로 제공합니다."},"chars":{"type":"integer","description":"검사 대상 발화의 글자 수입니다. characters와 동일한 값이며, 기존 클라이언트 호환을 위해 함께 제공됩니다."},"duration_sec":{"type":"number","description":"측정된 음성의 실제 길이(초)입니다. 무음 구간이 포함될 수 있고, 초당 글자 수 계산의 기준이 됩니다."},"duration_ms":{"type":"number","description":"측정된 음성의 실제 길이(밀리초)입니다. duration_sec와 같은 값을 단위만 바꿔 제공합니다."},"cps":{"type":"number","description":"초당 발화 글자 수입니다. 값이 높을수록 빠르게 말한 것이며, min_cps보다 낮으면 지나치게 느린 발화로 판정될 수 있습니다."},"expected_sec":{"type":"number","description":"같은 글자 수를 기준 속도로 읽었을 때 예상되는 발화 길이(초)입니다. 실제 길이와 비교해 속도 편차를 계산합니다."},"expected_duration_ms":{"type":"number","description":"예상 발화 길이(밀리초)입니다. expected_sec와 같은 값을 단위만 바꿔 제공합니다."},"duration_ratio":{"type":"number","description":"실제 음성 길이를 예상 길이로 나눈 비율입니다. 1보다 크면 예상보다 느리고, 1보다 작으면 빠릅니다. 계산할 수 없으면 null입니다.","nullable":true},"min_cps":{"type":"number","description":"이 검사에서 허용하는 최소 초당 글자 수입니다. cps가 이 값보다 낮으면 속도 검사에서 주의·실패로 표시됩니다."},"minimum_characters":{"type":"integer","description":"속도 검사를 수행하는 데 필요한 최소 글자 수입니다. 이보다 짧은 발화는 속도 판정을 생략할 수 있습니다."},"status":{"type":"string","description":"속도 검사 결과입니다. 통과·주의·실패 같은 판정 값이 들어가며, 상세 사유는 같은 항목의 reasons를 확인하세요."}}},"audio_sha256":{"type":"string","description":"후보 음원의 SHA-256 해시입니다. 같은 음원인지 무결성을 비교할 때 사용하며, 음원이 없으면 생략됩니다."},"audio_duration_ms":{"type":"number","description":"후보 음원의 실제 길이(밀리초)입니다. 발화 속도·무음 구간 검사의 기준 값으로 사용됩니다."},"audio_available":{"type":"boolean","description":"이 후보의 음원을 다운로드할 수 있는지 여부입니다. false면 생성 실패·보관 만료 등으로 파일이 없습니다."},"transcript":{"type":"string","description":"후보 음원에서 음성 인식으로 얻은 텍스트입니다. 원문과 비교해 CER·coverage를 계산합니다."},"cer":{"type":"number","description":"문자 오류율(Character Error Rate)입니다. 0에 가까울수록 원문과 정확히 일치하며, 1 이상이면 많은 문자가 틀렸다는 뜻입니다."},"coverage":{"type":"number","description":"원문 글자 중 음성에서 실제로 인식된 비율입니다. 1에 가까울수록 원문을 빠짐없이 읽었습니다."},"repeat":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"reference_intrusion":{"type":"object","description":"검출 결과. 분석할 수 없는 항목은 생략되거나 null입니다.","properties":{"detected":{"type":"boolean","description":"반복·참조 음성 침입 같은 현상이 검출됐는지 여부입니다. true면 correlation·matched_characters 같은 근거 값을 함께 확인하세요."},"suspected":{"type":"boolean","description":"검출이 확정되지는 않았지만 추가 확인이 필요한 상태인지 여부입니다. true면 detected와 별개로 수동 검토 대상입니다."},"correlation":{"type":"number","description":"비교한 두 구간의 파형 유사도입니다. 0~1 범위이며 1에 가까울수록 같은 음성 패턴으로 판단합니다."},"best_lag_sec":{"type":"number","description":"두 구간이 가장 잘 일치한 시간 차이(초)입니다. 반복·참조 구간의 기준 위치를 해석할 때 사용합니다."},"window_start_sec":{"type":"number","description":"검사한 비교 구간의 시작 시각(초)입니다. 음성 파일 시작점을 0으로 계산합니다."},"window_end_sec":{"type":"number","description":"검사한 비교 구간의 끝 시각(초)입니다. window_start_sec와 함께 실제 비교 범위를 나타냅니다."},"matched_characters":{"type":"integer","description":"비교 구간에서 일치한 글자 수입니다. 값이 클수록 반복·참조된 발화가 길다는 뜻입니다."},"matched_chars":{"type":"integer","description":"일치한 글자 수를 characters와 같은 방식으로 제공하는 호환 필드입니다. matched_characters와 동일한 값입니다."}}},"text_qa_status":{"type":"string","description":"합성 텍스트와 인식 텍스트의 일치 검사 상태입니다. 통과·주의·실패 값이 들어가며, 상세 사유는 reasons를 확인하세요."},"active_start_ms":{"type":"number","description":"음원에서 실제 발화가 시작된 위치(밀리초)입니다. 앞부분 무음 구간을 제외한 유효 음성의 시작점입니다."},"active_end_ms":{"type":"number","description":"음원에서 실제 발화가 끝난 위치(밀리초)입니다. 뒷부분 무음·보호 구간을 제외한 유효 음성의 끝점입니다."},"tail_guard_attached":{"type":"boolean","description":"끝부분 잘림을 확인하기 위한 보호 구간이 음원에 붙었는지 여부입니다. 검사용으로만 쓰며 최종 음원에는 포함되지 않습니다."},"tail_verified":{"type":"boolean","description":"끝부분까지 정상적으로 생성됐는지 검증을 마쳤는지 여부입니다. false면 끝단 검사가 아직 끝나지 않았습니다."},"tail_verified_at_ms":{"type":"number","description":"끝부분 검증을 수행한 시각(밀리초)입니다. 검증 전에는 null이며, 값이 있으면 tail_verified와 함께 확인하세요.","nullable":true},"tail_body_end_at_ms":{"type":"number","description":"보호 구간을 제외한 실제 본문의 끝 위치(밀리초)입니다. 잘림 판정의 기준점으로 사용됩니다.","nullable":true},"tail_guard_attached_chunk_ids":{"type":"array","description":"보호 구간이 붙은 음성 구간 ID 목록입니다. 어느 구간까지 끝단 검사를 적용했는지 확인할 때 사용합니다.","items":{"type":"string","description":"확인한 구간 ID."}},"generation_budget_exhausted":{"type":"boolean","description":"이 발화의 자동 생성 시도 한도를 모두 사용했는지 여부입니다. true면 같은 조건으로는 더 이상 자동 재생성되지 않습니다."},"retry_requires_new_regeneration_key":{"type":"boolean","description":"재시도에 새 재생성 키가 필요한 상태인지 여부입니다. true면 기존 요청을 반복해도 새 후보가 생성되지 않습니다."},"candidate_revision":{"type":"integer","description":"재시도 회차. 0은 최초 생성이며 재시도할 때 증가합니다.","minimum":0}}}},"status":{"type":"string","description":"최종 선택된 음원의 검사 상태입니다. 통과·주의·실패 값을 확인해 다운로드 가능 여부를 판단하세요."},"audio_sha256":{"type":"string","description":"최종 선택된 음원의 SHA-256 해시입니다. 다운로드한 파일의 무결성을 확인할 때 사용합니다."}}}},"nullable":true},"error":{"type":"object","description":"실패 상태일 때 포함합니다.","properties":{"code":{"type":"string","description":"실패한 작업의 공개 오류코드."},"message":{"type":"string","description":"오류 설명."}}}}},"api":{"type":"object","description":"호출 메타데이터.","properties":{"success":{"type":"boolean","description":"API 공통 처리 여부. HTTP 상태·업무 결과와 함께 확인합니다."},"cost":{"type":"number","description":"이번 호출에서 차감한 포인트. 무료 조회·재전송은 0."},"pl_id":{"type":"integer","description":"과금 기록 ID. 과금 기록이 있을 때만 포함합니다."}}}}}}}},"default":{"description":"TTS_REQUEST_INVALID (400·413·422): 목소리·문자 수·발화 구조·입력 크기를 확인하세요.\nTTS_AUTH_FAILED (401): 인증키를 확인하세요.\nTTS_ACCESS_DISABLED (403): 계정의 API 이용 제한 상태를 확인하세요.\nTTS_PAYMENT_REQUIRED (403): 최초 결제를 완료한 뒤 이용하세요.\nTTS_INSUFFICIENT_POINTS (402): 필요한 포인트를 충전하세요.\nTTS_NOT_FOUND (404): 작업·후보 ID와 소유 계정을 확인하세요.\nTTS_JOB_CONFLICT (409): 작업 상태·재시도 회차·같은 멱등 키의 요청 내용을 확인하세요.\nTTS_GENERATION_FAILED (409): 실패 상태를 확인하고 입력을 수정하거나 새 작업을 접수하세요.\nTTS_RESULT_UNAVAILABLE (410): 파일이 이미 다운로드됐거나 보관 기간이 만료됐습니다.\nTTS_TEMPORARILY_UNAVAILABLE (429·503): Retry-After 이후 다시 시도하세요. 재시도 요청에는 같은 멱등 키를 사용하세요.\nTTS_BILLING_FAILED (424): 결제를 완료하지 못했습니다. Retry-After 이후 다시 시도하세요.\nTTS_INTERNAL_ERROR (500): 잠시 후 다시 시도하세요.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/rest/tts/quote":{"post":{"summary":"한국어 AI 내레이션 TTS","description":"한국어 대본을 보내면 음성(MP3)과 발화 시각이 맞춰진 ASS 자막을 함께 만들어 줍니다. 작업을 접수한 뒤 상태를 확인하고, 완료되면 두 파일을 내려받는 방식입니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"202":{"description":"작업 접수 완료. 반환된 job_id로 상태를 조회합니다.","content":{"application/json":{"schema":{"type":"object","description":"공개 JSON 응답.","properties":{"data":{"type":"object","properties":{"job_id":{"type":"string","description":"접수 응답에서 받은 작업 ID. 같은 계정의 작업에만 접근할 수 있습니다."},"status":{"type":"string","description":"접수 완료.","enum":["waiting"]},"voice_id":{"type":"string","description":"선택한 목소리 ID."},"character_count":{"type":"integer","description":"공백·문장부호를 포함한 합성 글자 수."}}},"api":{"type":"object","description":"호출 메타데이터.","properties":{"success":{"type":"boolean","description":"API 공통 처리 여부. HTTP 상태·업무 결과와 함께 확인합니다."},"cost":{"type":"number","description":"이번 호출에서 차감한 포인트. 무료 조회·재전송은 0."},"pl_id":{"type":"integer","description":"과금 기록 ID. 과금 기록이 있을 때만 포함합니다."}}}}}}}},"default":{"description":"TTS_REQUEST_INVALID (400·413·422): 목소리·문자 수·발화 구조·입력 크기를 확인하세요.\nTTS_AUTH_FAILED (401): 인증키를 확인하세요.\nTTS_ACCESS_DISABLED (403): 계정의 API 이용 제한 상태를 확인하세요.\nTTS_PAYMENT_REQUIRED (403): 최초 결제를 완료한 뒤 이용하세요.\nTTS_INSUFFICIENT_POINTS (402): 필요한 포인트를 충전하세요.\nTTS_NOT_FOUND (404): 작업·후보 ID와 소유 계정을 확인하세요.\nTTS_JOB_CONFLICT (409): 작업 상태·재시도 회차·같은 멱등 키의 요청 내용을 확인하세요.\nTTS_GENERATION_FAILED (409): 실패 상태를 확인하고 입력을 수정하거나 새 작업을 접수하세요.\nTTS_RESULT_UNAVAILABLE (410): 파일이 이미 다운로드됐거나 보관 기간이 만료됐습니다.\nTTS_TEMPORARILY_UNAVAILABLE (429·503): Retry-After 이후 다시 시도하세요. 재시도 요청에는 같은 멱등 키를 사용하세요.\nTTS_BILLING_FAILED (424): 결제를 완료하지 못했습니다. Retry-After 이후 다시 시도하세요.\nTTS_INTERNAL_ERROR (500): 잠시 후 다시 시도하세요.","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":false,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"합성할 한국어 본문. text와 utterances 중 하나만 사용합니다. 정규화(normalize_text)를 쓰면 1~2,000자, 끄면 8,000자까지입니다(공백·줄바꿈 포함). (string)"},"voice_id":{"type":"string","description":"사용할 목소리의 ID입니다. 목소리 목록에서 고른 값을 넣으며, 생략하면 엔진 기본 목소리로 합성됩니다. 목소리별로 억양·속도·성별이 다릅니다. (string)"},"style":{"type":"string","description":"자유 서술 낭독 스타일 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"emotion":{"type":"string","description":"감정 표현. 생략 시 기본 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 12가지입니다. neutral = 감정을 넣지 않은 담담한 표현입니다. 안내·낭독의 기본값으로 쓰기 좋습니다. calm = 차분하고 낮은 감정입니다. 안정감이 필요한 안내에 적합합니다. cheerful = 밝고 경쾌한 감정입니다. 광고·환영 문구에 적합합니다. excited = 들뜨고 활기찬 감정입니다. 이벤트·강조 문장에 적합합니다. sad = 슬프고 가라앉은 감정입니다. 서사·추모 문구에 적합합니다. serious = 진지하고 단호한 감정입니다. 공지·경고 문구에 적합합니다. friendly = 친근하고 부드러운 감정입니다. 고객 응대에 적합합니다. empathetic = 공감하고 위로하는 감정입니다. 상담·안내에 적합합니다. confident = 확신에 찬 감정입니다. 발표·제안에 적합합니다. gentle = 조용하고 온화한 감정입니다. 수면·명상 콘텐츠에 적합합니다. whisper = 속삭이듯 작은 목소리입니다. ASMR·몰입형 콘텐츠에 적합합니다. narration = 낭독·해설에 맞춘 톤입니다. 문장 사이 쉼이 자연스럽습니다. (string)","enum":["neutral","calm","cheerful","excited","sad","serious","friendly","empathetic","confident","gentle","whisper","narration"]},"tone":{"type":"string","description":"용도·톤. 생략 시 기본 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 9가지입니다. narration = 낭독·해설에 맞춘 톤입니다. 문장 사이 쉼이 자연스럽습니다. news = 뉴스 앵커처럼 또렷하고 일정한 톤입니다. audiobook = 오디오북 낭독 톤입니다. 긴 문장을 안정적으로 읽습니다. documentary = 다큐멘터리 해설 톤입니다. 차분하고 설명적입니다. ad = 광고 카피에 맞춘 톤입니다. 짧고 리듬감 있게 읽습니다. conversation = 대화하듯 자연스러운 톤입니다. announcement = 안내 방송 톤입니다. 또렷하고 전달력이 좋습니다. tutorial = 설명·강의 톤입니다. 단계 설명에 적합합니다. storytelling = 이야기 들려주는 톤입니다. 감정 변화를 살립니다. (string)","enum":["narration","news","audiobook","documentary","ad","conversation","announcement","tutorial","storytelling"]},"accent":{"type":"string","description":"억양. 생략 시 표준어 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 5가지입니다. standard = 지역색이 없는 표준어 억양입니다. seoul = 서울·수도권 억양입니다. gyeongsang = 경상도 억양입니다. jeolla = 전라도 억양입니다. chungcheong = 충청도 억양입니다. (string)","enum":["standard","seoul","gyeongsang","jeolla","chungcheong"]},"pace":{"type":"string","description":"말 속도 배율 0.5~2.0. 1이 기본 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (number)"},"pitch":{"type":"string","description":"음높이 -12~12 반음. 0이 기본 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (number)"},"volume_gain_db":{"type":"string","description":"음량 보정 -12~12 dB. 0이 기본 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (number)"},"normalize_text":{"type":"string","description":"기본 true true/false로 보내며, 생략하면 서버 기본값이 적용됩니다. true = 이 필드가 나타내는 조건이 성립한 경우, false = 성립하지 않은 경우입니다. 두 값 모두 정상 응답에 올 수 있으며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. (boolean)"},"multi_speaker":{"type":"string","description":"멀티화자. Gemini는 화자 2명까지 한 호출, ChatGPT는 발화별 목소리 대화 true = 이 필드가 나타내는 조건이 성립한 경우, false = 성립하지 않은 경우입니다. 두 값 모두 정상 응답에 올 수 있으며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. (boolean)"},"utterances[0][text]":{"type":"string","description":"발화 본문. text와 utterances 중 하나만 사용합니다. 최대 100개 발화입니다. 본문 합계는 정규화(normalize_text)를 쓰면 2,000자, 끄면 8,000자까지입니다. (string)"},"utterances[0][voice_id]":{"type":"string","description":"이 발화에만 쓸 목소리 ID입니다. 생략하면 화자 설정, 그다음 최상위 voice_id를 씁니다. (string)"}}}}}}}}},"x-code-tables":[{"title":"작업 상태","columns":["status","의미와 다음 행동"],"rows":[["waiting","접수되어 처리 시작을 기다리는 중입니다. 2~5초 뒤 다시 조회하세요."],["processing","음성을 만드는 중입니다. 2~5초 뒤 다시 조회하세요."],["completed","완료입니다. MP3·ASS를 24시간 안에 각각 한 번 내려받으세요."],["cancelled","취소가 끝났습니다. billing에서 정산액을 확인하세요."],["failed","제작에 실패했습니다. failure_code를 기록하고 입력을 확인한 뒤 새 작업을 접수하세요."]]},{"title":"오류 코드","columns":["코드","HTTP","원인","해결책"],"rows":[["TTS_REQUEST_INVALID","400·413·422","요청 형식이 올바르지 않음(normalize_text·multi_speaker가 true/false가 아님 등)","입력 형식과 지원 조건 확인"],["TTS_INPUT_CONFLICT","400","text와 utterances를 함께 보냄","둘 중 하나만 보내기"],["TTS_TEXT_REQUIRED","400","비어 있는 대본 또는 발화","모든 발화에 text 넣기"],["TTS_TEXT_TOO_LONG·TTS_NORMALIZATION_TEXT_TOO_LONG","400","글자 수 합계 초과(정규화 2,000자 / 끔 8,000자)","작업을 나누거나 normalize_text: false로 보내기"],["TTS_UTTERANCES_INVALID","400","발화가 0개이거나 100개 초과","1~100개로 나누기"],["TTS_VOICE_INVALID","400","선택한 엔진에 없는 목소리 ID","목소리 목록 API에서 ID 확인"],["TTS_STYLE_INVALID","400","style이 문자열이 아니거나 1,000자 초과","스타일 문장을 1,000자 이하로 줄이기"],["TTS_EMOTION_INVALID·TTS_TONE_INVALID·TTS_ACCENT_INVALID","400","허용 목록에 없는 감정·톤·억양 값","위 옵션 표의 값 중 하나로 보내기"],["TTS_PACE_INVALID·TTS_PITCH_INVALID·TTS_VOLUME_INVALID","400","속도·음높이·음량이 범위를 벗어남","GET /rest/tts/options로 범위 확인"],["TTS_SPEAKERS_REQUIRED·TTS_SPEAKERS_INVALID","400","multi_speaker인데 화자가 2명 미만이거나 화자 설정이 잘못됨","speakers 수와 각 화자 설정 확인"],["TTS_SPEAKER_REQUIRED·TTS_SPEAKER_INVALID","400","발화의 speaker가 없거나 80자 초과","모든 발화에 speakers의 이름 넣기"],["TTS_LANGUAGE_NOT_SUPPORTED","400","한국어가 아닌 언어 지정","언어 지정을 빼거나 ko로 보내기"],["TTS_IDEMPOTENCY_KEY_INVALID","400","재접수 키 형식 오류","영문·숫자·_ . : - 1~128자로 보내기"],["TTS_IDEMPOTENCY_CONFLICT","409","같은 재접수 키로 다른 입력을 보냄","새 키를 쓰거나 처음 입력 그대로 보내기"],["TTS_INSUFFICIENT_POINTS","402","예약할 포인트 부족","포인트 충전 후 다시 접수"],["TTS_AUTH_FAILED","401·403","인증 실패","인증키 확인"],["TTS_NOT_FOUND","404","작업을 찾을 수 없음","접수 응답의 작업 ID 확인"],["TTS_JOB_CONFLICT","409","현재 상태에서 요청을 처리할 수 없음","최신 상태 확인 후 다시 요청"],["TTS_GENERATION_FAILED","409","음성 또는 자막 생성 실패","입력 확인 후 새 작업 접수"],["TTS_RESULT_UNAVAILABLE","410","해당 파일을 이미 내려받았거나 24시간이 지남","새 작업 접수"],["TTS_TEMPORARILY_UNAVAILABLE","429·503","일시적으로 접수 불가","Retry-After 이후 다시 시도"],["TTS_INTERNAL_ERROR","500","분류되지 않은 오류","잠시 후 다시 시도"]]}],"x-service-errors":[{"code":"TTS_REQUEST_INVALID","status":"400·413·422","message":"목소리·문자 수·발화 구조·입력 크기를 확인하세요."},{"code":"TTS_AUTH_FAILED","status":401,"message":"인증키를 확인하세요."},{"code":"TTS_ACCESS_DISABLED","status":403,"message":"계정의 API 이용 제한 상태를 확인하세요."},{"code":"TTS_PAYMENT_REQUIRED","status":403,"message":"최초 결제를 완료한 뒤 이용하세요."},{"code":"TTS_INSUFFICIENT_POINTS","status":402,"message":"필요한 포인트를 충전하세요."},{"code":"TTS_NOT_FOUND","status":404,"message":"작업·후보 ID와 소유 계정을 확인하세요."},{"code":"TTS_JOB_CONFLICT","status":409,"message":"작업 상태·재시도 회차·같은 멱등 키의 요청 내용을 확인하세요."},{"code":"TTS_GENERATION_FAILED","status":409,"message":"실패 상태를 확인하고 입력을 수정하거나 새 작업을 접수하세요."},{"code":"TTS_RESULT_UNAVAILABLE","status":410,"message":"파일이 이미 다운로드됐거나 보관 기간이 만료됐습니다."},{"code":"TTS_TEMPORARILY_UNAVAILABLE","status":"429·503","message":"Retry-After 이후 다시 시도하세요. 재시도 요청에는 같은 멱등 키를 사용하세요."},{"code":"TTS_BILLING_FAILED","status":424,"message":"결제를 완료하지 못했습니다. Retry-After 이후 다시 시도하세요."},{"code":"TTS_INTERNAL_ERROR","status":500,"message":"잠시 후 다시 시도하세요."}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}