텍스트 변환과 함께 영상 번역하기
스크립트를 만드는 요청에 두 글자 ISO 639-1 코드인 translate_to를 추가하세요. wait는 번역이 끝날 때까지도 기다려요. 업로드와 MCP는 번역 가이드에서 볼 수 있어요.
스크립트는 평소처럼 음성이나 플랫폼 자막에서 만들어져요. 번역은 그 텍스트를 바탕으로 나중에 실행되기 때문에, 번역이 아직 끝나지 않았어도 원본 스크립트는 언제나 읽을 수 있어요.
요청 하나에는 번역 언어를 하나만 지정할 수 있어요. 다른 언어가 필요하면 스크립트가 완료된 뒤에 같은 스크립트를 다시 번역하세요.
curl -X POST "https://api.transcript1.com/v1/transcriptions?wait=60" \
-H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "translate_to": "es"}'이미 있는 스크립트 번역하기
변환 작업에 언어를 POST로 보내세요. API가 번역 상태와 함께 202를 돌려줘요. 변환 작업을 조회하거나 웹훅을 쓰면 돼요. 상태 코드는 번역에 정리해 두었어요.
변환이 완료되어 있어야 해요. 아니면 API가 transcript_not_ready를 돌려줘요. 같은 요청을 반복해도 안전해요. 처리 중이거나 완료된 번역은 그대로 반환되고, 실패한 번역은 다시 시도돼요.
웹훅이 transcription.translation.completed나 transcription.translation.failed를 보내 주니까 앱에서 계속 조회할 필요가 없어요.
curl -X POST "https://api.transcript1.com/v1/transcriptions/tr_8fK2Lm0PqRsTuVwXyZaBcD/translations" \
-H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
-H "Content-Type: application/json" \
-d '{"language": "en"}'이중 언어, 번역만, 원문만 고르기
GET /v1/transcriptions/:id나 텍스트, SRT, VTT 다운로드에 translation=both, only, none을 붙이세요. 기본값은 both예요.
both에서는 JSON 세그먼트에 translation 필드가 붙고, 텍스트에서는 번역 줄이 원문 아래에 들어가며, SRT와 VTT 큐는 두 줄이 돼요. only에서는 번역문이 원문을 대신하고 타임스탬프와 화자는 그대로예요.
응답에는 언어와 상태(processing, completed, failed)를 담은 translation 객체도 들어 있어요. 완료된 스크립트를 다른 형식으로 다시 읽어도 분이 더 쓰이지 않아요.
| translation | 받는 결과 |
|---|---|
| both | 원문과 번역을 함께, 세그먼트나 큐마다 한 쌍씩. |
| only | 원문 대신 번역문, 시간은 그대로. |
| none | 원문 스크립트만. |
번역이 하는 일과 하지 않는 일
스크립트 텍스트를 기계로 번역하는 기능이에요. 게시하기 전에 이름, 전문 용어, 인용문을 확인하고, 비교할 수 있게 원본 스크립트도 보관하세요.
transcript1은 영상을 더빙하거나 음성을 번역하지 않아요. 번역된 오디오는 없고, 자막을 영상에 입히지도 않아요. 편집기나 플레이어에서 쓸 수 있는 텍스트와 자막 파일을 받게 돼요.
번역은 분을 쓰지 않아요. 텍스트 변환 분은 평소처럼 적용되고, 번역이 실패해도 스크립트가 실패하거나 환불되지 않아요.