녹음마다 언어를 지정하지 않아도 돼요
어떤 소스든 language를 생략하거나 auto로 보내면 돼요. 자막 선택과 음성 변환에서 어떻게 다른지는 language 옵션 문서를 확인하세요.
서로 다른 출처와 사람의 녹음을 처리한다면 자동 감지로 시작하세요. 모든 파일에 같은 언어를 강제로 지정하지 않아도 돼요. 반대로 언어를 알고 있고 도입부가 아주 짧거나 모호하다면 코드로 힌트를 주는 편이 도움이 돼요.
음악이나 침묵이 길고 발언이 짧으면 판단할 단서도 적어요. 언어 표시가 그럴듯하더라도 단어까지 모두 맞는 건 아니에요. 필요한 구간을 원본과 함께 확인하세요.
curl -X POST "https://api.transcript1.com/v1/transcriptions?wait=60" \
-H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
-F [email protected] \
-F language=auto다국어 음성 텍스트 변환은 구간별로 읽기
상위 language는 녹음의 주요 언어를, 각 구간의 language는 그 구간의 언어를 나타내요. 필드 위치는 변환 객체 문서에서 확인하세요.
전체 언어는 작업을 분류할 때, 구간별 언어는 필요한 발언을 고를 때 쓰세요. 도입부와 답변의 언어가 다른 인터뷰에서 주요 언어만 남기면 중요한 답변을 버릴 수 있어요.
아래 JSON은 구간별 언어를 보여 주는 예시예요. 실제 대화에서는 문장 중간에 언어가 바뀌기도 해요. 이름이나 전문 용어도 검토가 필요해요. 나중에 편집하거나 다른 곳에서 번역하더라도 원래 구간의 텍스트는 남겨 두세요.
{
"status": "completed",
"transcript_source": "speech_to_text",
"language": "en",
"transcript": {
"segments": [
{ "start": 0, "end": 3.4, "speaker": null, "language": "en", "text": "Good morning." },
{ "start": 3.4, "end": 7.9, "speaker": null, "language": "de", "text": "Guten Morgen." }
]
}
}녹음의 언어를 알고 있다면
2자리 ISO 639-1 코드를 language로 보내세요. 파일 업로드에서는 multipart 폼 필드에 넣어요. 파일 업로드 예제를 참고하세요.
음성을 텍스트로 바꿀 때는 인식을 돕는 힌트예요. YouTube 자막에서는 가져올 자막의 언어를 고르는 값이에요. auto라면 영상의 원래 언어를 기준으로 고르며, 자동 번역 자막은 쓰지 않아요.
스페인어 녹음에 en을 보낸다고 영어로 번역되는 건 아니에요. language는 번역 옵션이 아니에요. 번역이 필요하면 별도 작업으로 진행하고, 원문 스크립트를 함께 두고 검토하세요.
curl -X POST "https://api.transcript1.com/v1/transcriptions?wait=60" \
-H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
-F [email protected] \
-F language=de언어 표시만 믿고 발언을 걸러 내지 마세요
언어별 편집자나 검색 색인으로 보낼 때는 전체 언어와 구간별 언어를 함께 저장하세요. 주요 언어와 다르다는 이유만으로 발언을 버리지 말고 해당 구간을 확인하세요.
언어가 바뀌는 곳은 앞뒤 문장까지 들어보세요. 이름, 인용문, 외래어 하나가 나왔다고 전체 발언의 언어가 달라진 건 아닐 수 있어요. 자동 표시로 참여자의 언어 능력이나 배경, 신원을 단정하지 마세요.
언어가 잘못 나온 것 같다면 파라미터부터 바꾸기 전에 원본을 들어보세요. 원하는 음성 트랙인지, 발언이 또렷한지 확인하세요. 힌트를 넣어 새 변환을 만든다면 이전 스크립트도 비교용으로 남겨 두세요. 처리 옵션을 바꾸는 건 기존 파일 다운로드와 달리 새 유료 작업이 될 수 있어요.
| 녹음이나 작업 | 확인하면 좋은 점 |
|---|---|
| 여러 언어로 진행한 연구 인터뷰 | 구간별 언어를 검토하고 나중에 번역한 문장 옆에도 원문을 남기세요. |
| 설명이 담긴 짧은 Reel | 음악이나 짧은 도입부가 필요한 발언을 가리지 않는지 들어보세요. |
| YouTube 자막 가져오기 | 맞는 언어의 자막을 고르세요. 자동 번역 자막은 사용하지 않아요. |