요금제와 사용 한도 | transcript1 docs

transcript1은 영상이나 오디오의 재생 시간을 분 단위로 계산해요. 요금제에 포함된 분량과 추가로 충전한 분량을 구분해서 관리해요. 요금과 차감 순서, API 사용 한도를 아래에서 확인하세요.

요금제

	Free	Monthly	Annual
요금	$0, 카드 등록 없음	월 $9	연 $90
포함 분량	60분, 최초 한 번	매월 1,000분	매월 1,000분
추가 충전	구매 불가	1,000분당 $6	1,000분당 $5
분당 요청 수	30	200	300
동시 작업 수	2	10	20

요금제를 바꾸거나 분량을 충전하려면 대시보드의 “Billing” 페이지를 여세요.

사용 시간 계산 기준

미디어 1분에 1크레딧을 쓰며, 재생 시간을 분 단위로 올림해요. 61초 영상은 2분으로 계산하고, 최소 차감량은 1분이에요.
YouTube, X, TikTok, Instagram, Facebook, Bluesky를 비롯한 지원 플랫폼의 링크와 업로드 파일 모두 분당 요금이 같아요. 자막은 실제 영상 길이, 음성 텍스트 변환(STT)은 실제 오디오 길이로 계산해요. YouTube와 X 자막도 TikTok, Bluesky 자막과 같은 기준을 적용해요.
이미 처리한 영상이라도 새로 변환하면 다시 차감해요. 최근에 직접 변환한 같은 영상의 스크립트를 추가 차감 없이 받으려면 reuse_recent=true를 사용하세요. 자세한 조건은 API 레퍼런스에 있어요.
작업이 실패하거나 취소되면 비용이 들지 않아요. 앞서 차감한 분량이 있다면 돌려드려요.

가입 시 무료 제공량

가입하면 계정당 한 번, 60분을 무료로 제공해요. 이메일 가입은 주소 인증 후에, Google이나 Microsoft 가입은 즉시 받아요. Free 요금제의 분량은 주기적으로 다시 채워지지 않아요. 이메일 인증 전에는 POST /v1/transcriptions를 호출해도 403 email_not_verified를 반환해요.

기본 제공량과 충전 분량

사용 가능한 분량은 다음 두 종류예요.

기본 제공량: 요금제에 포함된 분량이에요. 새 주기가 시작되면 다시 채워지고, 남은 분량은 이월되지 않아요. Monthly와 Annual 모두 매월 1,000분을 제공해요.
충전 분량: 유료 요금제에서 1,000분 단위로 추가 구매할 수 있어요. 한 번에 1~20팩을 살 수 있고, 기본 제공량을 다 쓴 뒤부터 차감해요. 유료 요금제를 유지하는 동안에는 만료되지 않아요.

유료 요금제를 해지하면 기본 제공량이 없는 Free로 돌아가요. 충전해 둔 분량은 남지만 유료 요금제를 다시 이용해야 쓸 수 있어요. Free에서 유료 요금제로 바꾸면 남은 무료 분량을 충전 분량으로 옮겨 드려요.

남은 분량 조회하기

GET /v1/account로 남은 분량을 확인하세요. 조회에는 크레딧이 들지 않아요.

curl https://api.transcript1.com/v1/account \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY"

필드	확인할 수 있는 내용
`minutes.remaining`	지금 사용할 수 있는 총 분량. `cycle`에 `topup_usable`이 `true`인 경우의 `topup`을 더한 값이에요.
`minutes.cycle`	아직 쓰지 않은 기본 제공량
`minutes.topup`	보관 중인 충전 분량
`minutes.topup_usable`	충전 분량 사용 가능 여부. 유료 요금제를 이용 중이면 `true`예요.
`minutes.resets_at`	기본 제공량이 다음에 채워지는 시각. 해당하지 않으면 `null`이에요.
`limits`	요청·작업 한도인 `requests_per_minute`, `max_active_jobs`

요금제는 plan, 갱신 시점은 renews_at에서 확인할 수 있어요.

사용 가능한 분량을 다 쓰면 POST /v1/transcriptions가 402 insufficient_minutes를 반환해요. 함께 오는 action_url은 “Billing” 페이지로 연결돼요. 잔여량이 0에 도달하면 이메일로도 알려 드려요. 이 알림은 주기당 최대 한 번만 보내요.

분당 API 요청 한도

요청 한도는 계정별로 계산해요. 같은 계정의 API 키, 대시보드 세션, MCP 연결에서 보낸 요청을 모두 합산해요.

분당 요청 수는 Free 30회, Monthly 200회, Annual 300회예요. 1분 단위 구간마다 요청을 집계해요.
인증을 거친 모든 /v1 응답에서 X-RateLimit-Limit으로 한도를, X-RateLimit-Remaining으로 현재 구간의 남은 요청 수를 확인할 수 있어요.
한도를 넘으면 429 rate_limited를 반환해요. 다음 집계 구간까지 기다릴 시간은 Retry-After 헤더에 초 단위로 알려 줘요.
업로드 토큰으로 인증하는 청크 전송은 요청 한도에 포함하지 않아요.

동시에 진행할 수 있는 작업 수

상태가 queued, fetching, transcribing인 작업을 진행 중인 작업으로 세요. Free는 2개, Monthly는 10개, Annual은 20개까지 가능해요. 이 상태에서 한도를 넘겨 새 작업을 시작하면 429 too_many_active_jobs와 Retry-After 헤더를 반환해요. 기존 작업이 끝난 뒤 다시 요청하세요.

청크 업로드의 awaiting_upload 상태는 진행 중인 작업 수에 포함하지 않아요. 대신 팀당 완료 전 업로드를 최대 20개까지 둘 수 있어요. 이 한도를 넘어도 429 too_many_active_jobs를 반환해요. 업로드 완료 요청은 작업을 대기열에 넣으므로, 그때 동시 작업 한도를 검사해요.

상태 코드별 대응 방법은 오류 처리를 확인하세요.