SRTGen.com LogoSRTGen.com

전사 (Transcribe) API

AI 전사 및 프로젝트 생성을 위해 미디어를 제출합니다. 비디오 및 오디오 파일을 모두 지원합니다.

POST/api/v1/transcribe
빠른 구현
curl -X POST https://api.srtgen.com/api/v1/transcribe \
  -H "x-api-key: <YOUR_API_KEY>" \
  -F "file=@/path/to/your/video.mp4"
POSThttps://api.srtgen.com/api/v1/transcribe

요청 파라미터

파라미터유형필수 여부설명
fileFileYes

전사할 미디어 파일 (Multipart).

지원 형식: 비디오 (mp4, mov, avi, webm, mkv), 오디오 (mp3, wav, m4a, flac). 최대 2GB.

videoUrlStringNo*미디어의 외부 URL (본문에 파일이 제공되지 않는 경우 필수).
nameStringNo프로젝트의 커스텀 이름.
languageCodeStringNo

소스 언어 코드 (예: 'en-us'). 생략 시 'auto'(자동 감지)가 기본값입니다.

filterProfanityBooleanNo비속어 자동 검열 여부. 기본값은 false입니다.
disfluenciesBooleanNo추임새(예: '어', '음') 포함 여부. 기본값은 false입니다.
고급: URL + AI 설정
curl -X POST https://api.srtgen.com/api/v1/transcribe \
  -H "x-api-key: <YOUR_API_KEY>" \
  -F "videoUrl=https://example.com/video.mp4" \
  -F "languageCode=en-us" \
  -F "filterProfanity=true" \
  -F "disfluencies=false"
POSThttps://api.srtgen.com/api/v1/transcribe

성공 응답

성공적인 요청은 프로젝트 및 백그라운드 작업 상세 정보와 함께 200 OK 상태를 반환합니다.

  • projectId프로젝트의 고유 식별자입니다.
  • status'inProgress' (전사 진행 중).
  • 참고: 크레딧은 전사 프로세스가 완료된 후 잔액에서 비동기적으로 계산되어 차감됩니다.
{
  "success": true,
  "projectId": "proj_8k2n9m1b",
  "status": "inProgress"
}

오류 코드

상태오류 코드설명
400missing_file'file' 또는 'video' 필드에서 파일을 찾을 수 없습니다.
400unreachable_url제공된 videoUrl에 접속할 수 없거나 오류를 반환했습니다.
400invalid_parameter파라미터 중 하나(예: videoUrl)가 잘못되었습니다.
400file_read_failed업로드된 파일을 읽을 수 없거나 파일이 손상되었습니다.
401unauthorizedAPI 키가 누락되었거나 유효하지 않습니다.
403insufficient_balance미디어 길이를 처리하기 위한 크레딧이 부족합니다.
403storage_quota_exceeded파일이 요금제의 남은 클라우드 저장소 할당량을 초과합니다.
413payload_too_large파일이 시스템의 절대 한도인 2GB를 초과합니다.
500transcription_failed전사 작업을 시작할 수 없습니다 (AI 제공업체 장애).
500server_error문제가 발생했습니다. 나중에 다시 시도해 주세요.
오류 응답 구조
{
  "success": false,
  "error": "insufficient_balance",
  "message": "프로젝트에 5크레딧이 필요하지만 잔액이 2크레딧입니다."
}
이 페이지가 도움이 되었나요?
전사 (Transcribe) API | SRTGen.com