메모에 붙이기 좋은 타임스탬프 텍스트
텍스트로 읽을 때 timestamps=true를 넣으세요. 화자 분리를 켜서 변환했다면 화자도 함께 표시해요. 스크립트 조회 문서에서 옵션을 확인하세요.
자막 문법 없이도 어느 구간의 발언인지 표시할 수 있어요. 영상 URL이나 파일 이름도 함께 남겨 두세요. 00:12:40이라는 시간만으로는 어떤 녹음을 찾아야 할지 알 수 없어요.
JSON의 start와 end는 녹음 시작부터 지난 초예요. 실제 시각이나 날짜가 아니에요. 플레이어의 재생 위치로 쓰거나 메모의 근거로 저장하세요. 아래 텍스트는 다운로드 형식을 설명하는 예시예요.
curl "https://api.transcript1.com/v1/transcriptions/tr_8fK2Lm0PqRsTuVwXyZaBcD?format=text×tamps=true" \
-H "Authorization: Bearer $TRANSCRIPT1_API_KEY"
[00:00:00] Place the microphone near the speaker.
[00:00:04] Record a short test before the interview.SRT와 VTT 중 어떤 형식이 필요한가요?
SRT에는 번호와 시작·종료 시간이 들어 있어요. WebVTT는 WEBVTT로 시작하며 HTML track 요소에 쓸 수 있어요. 변환이 끝나면 format=srt나 format=vtt로 읽어 파일로 저장하세요.
편집기나 자막 업로드 도구에는 보통 SRT를, HTML 동영상에는 WebVTT를 써요. 가져올 도구가 어떤 형식을 받는지 먼저 확인하세요. VTT 파일 만들기까지 끝내도 자막이 영상에 입혀지는 건 아니에요. 글꼴과 위치는 편집기나 플레이어에서 정해요.
SRT는 밀리초 앞에 쉼표를, WebVTT는 마침표를 써요. 확장자만 바꿔서는 변환되지 않아요. 완료된 변환 ID로 필요한 형식을 다시 요청하세요. 기존 스크립트를 읽는 거라 크레딧을 다시 쓰지 않아요.
1
00:00:00,000 --> 00:00:04,200
Place the microphone near the speaker.
2
00:00:04,200 --> 00:00:09,800
Record a short test before the interview.단어를 따라 강조하거나 클립 구간 잡기
JSON 요청에 include=words를 붙이면 지원되는 소스에서 단어별 타임스탬프를 받아요. 없는 소스는 words: null이에요. 단어별 정보와 조회 옵션을 확인하세요.
AI 텍스트 변환에는 단어 시작·종료 시간과 신뢰도가 있어요. YouTube 자동 생성 자막은 단어 시작 시간을 제공하고, 끝은 다음 단어 시작으로 계산해요. 업로더가 올린 YouTube 자막과 YouTube 외 플랫폼의 모든 자막에는 단어별 시간이 없어요. X 자막의 transcript_source는 x_captions예요. 앱에서는 구간별 시간으로 대체할 수 있게 준비하세요.
단어의 시작과 끝이 그대로 좋은 편집점은 아니에요. 자르기 전 경계 주변을 들어 숨소리나 첫 음절이 잘리지 않는지 확인하세요. 자막은 읽기 편한 어구로 묶고, 실제로 볼 화면 크기에서 검토하세요.
curl "https://api.transcript1.com/v1/transcriptions/tr_8fK2Lm0PqRsTuVwXyZaBcD?include=words" \
-H "Authorization: Bearer $TRANSCRIPT1_API_KEY"파일로 저장하기 전에 완료 상태부터 확인하기
status=completed가 되어야 SRT, VTT, 텍스트를 받아요. 그 전에는 상태가 담긴 JSON 객체를 돌려줘요. 플레이어가 파일을 읽지 못하면 상태 JSON을 .srt로 저장하지 않았는지 먼저 확인하세요.
자막의 시간은 업로드하거나 링크로 보낸 원본을 기준으로 해요. 중간을 잘라 클립으로 쓰거나 앞부분을 바꿨다면 시간을 맞춰야 해요. 콘텐츠 재활용 작업에서는 클립 후보 구간을 남기고 최종 편집 후 자막을 맞추세요.
공개하기 전 실제 플레이어에서 보통 속도로 재생하세요. 한 줄 길이, 읽을 시간, 화자 표시를 확인하고 접근성 자막 안내에 따라 중요한 소리와 화면 맥락도 살펴보세요.
파일 정보에 변환 ID를 함께 저장하세요. 나중에 SRT 대신 WebVTT가 필요하거나 단어별 JSON을 읽고 싶어도 같은 ID로 요청하면 돼요. 새 변환을 만들 필요는 없어요.