전사 편집
이 가이드에서는 Realtime Speech to Text API를 사용해 커밋된 전사에 자연어 편집 지침을 적용하는 방법을 알아봅니다.
개요
전사 편집은 실험적 기능이며 기본 전사 비용에 30%의 프리미엄이 추가됩니다. 커밋된 전사당 최소 10초의 오디오에 대해 과금됩니다. 자세한 가격 정보는 API 요금 페이지를 확인하세요.
실시간 전사는 모든 커밋된 전사에 자연어 편집 지침을 적용할 수 있습니다. 예를 들어 말로 한 날짜를 고정된 형식으로 작성하거나 약어와 두문자어를 확장할 수 있습니다. 지침은 연결을 열 때 한 번 전달되며, 각 커밋된 전사 뒤에는 편집된 텍스트를 포함하는 별도의 edited_transcript 이벤트가 이어집니다.
부분 전사는 편집되지 않습니다. committed_transcript 이벤트도 변경되지 않으므로 기능을 켜도 기존 통합은 계속 작동합니다.
전사 편집은 entity_detection 또는 entity_redaction과 함께 사용할 수 없습니다. 둘 다
설정한 연결은 invalid_request 오류와 함께 거부됩니다.
전사 편집 활성화
연결 시 transcriptEdit 옵션(WebSocket API의 transcript_edit 쿼리 파라미터)으로 지침을 전달합니다. 지침은 최대 2000자까지 가능합니다. 지침 작성 방법은 배치 전사 편집 가이드를 참조하세요.
모든 SDK에서 편집된 전사는 RealtimeEvents.EDITED_TRANSCRIPT 이벤트를 통해 도착합니다.
클라이언트 측
클라이언트 측 스트리밍 가이드에 설명된 대로, 서버에서 발급한 일회용 토큰과 함께 브라우저에서 @elevenlabs/client를 사용하세요.
서버 측
서버 측 스트리밍 가이드에 설명된 대로 서버에서 공식 SDK를 사용하세요. 해당 가이드와 다른 점은 옵션과 이벤트 핸들러뿐이며, 오디오 전송 및 연결 종료 방식은 동일합니다.
편집된 전사 수신
활성화하면 각 커밋된 전사 뒤에 커밋된 텍스트와 편집된 버전을 담은 edited_transcript 이벤트가 이어집니다.
알아둘 동작:
- 편집은 커밋된 세그먼트별로 적용됩니다. 편집은 비동기로 실행되므로
edited_transcript이벤트는 해당committed_transcript이벤트 직후에 발생합니다. 다음 부분 전사 이후에 도착할 수 있으며, 연속된 세그먼트의 편집은 순서가 바뀌어 도착할 수 있습니다.text필드를 사용해 편집을 해당 커밋 전사와 일치시키세요. - 세그먼트에 편집 사항이 없으면
edited_text는text와 동일합니다. - 세그먼트에 대한 편집을 생성할 수 없으면 해당 세그먼트에는
edited_transcript이벤트가 전송되지 않습니다.committed_transcript이벤트는 영향을 받지 않습니다. committed_transcript_with_timestamps의 단어 수준 타임스탬프는 편집된 텍스트가 아닌 원본 커밋 텍스트를 설명합니다.