URL 및 API로 오디오 보내기
인터페이스에서 직접 URL로 오디오를 가져오는 방법과 API로 프로그래밍 방식으로 전사 요청을 보내는 방법: 자격 요건, 키, 인증, 한도 및 웹훅.
파일 업로드 외에도 "손에 파일이 없는" 두 가지 방법이 있습니다. 인터페이스에 미디어 URL을 붙여넣는 방법(모든 사용자)과 API로 보내는 방법(Profissional 플랜 이상)입니다. 전사 기능을 시스템, PABX 및 자동화에 통합하는 데 적합합니다.
1. 인터페이스에서 URL로 가져오기
새 전사 화면에서 YouTube를 허용하는 동일한 옵션이 오디오/비디오 파일의 직접 URL(https)도 허용합니다. 서버가 미디어를 다운로드한 후 일반적인 흐름을 따릅니다: 언어 선택(또는 자동 감지), 플랜의 엔진, 그리고 길이에 따른 사이클 비용이 적용됩니다. 플랜의 길이 및 크기 제한도 동일하게 적용됩니다.
2. 전사 API
누가 사용할 수 있나요?
API는 Profissional 플랜(월 R$ 39,90)부터 사용할 수 있습니다. Premium, 기업 플랜 및 이에 상응하는 레거시 플랜도 포함됩니다. 다른 플랜에서는 키를 생성할 때 플랜이 자격이 없다는 메시지가 반환됩니다.
API 키
- 토큰 형식:
vpt_live_...; - 시크릿은 생성 시 단 한 번만 표시됩니다. 안전한 곳에 보관하세요. 우리는 시크릿을 저장하지 않으며, 해당 시크릿의 지문만 저장합니다.
- 계정당 활성 키 최대 20개; 언제든 원하는 키를 해지할 수 있습니다.
- 인터페이스의 개인 키 관리 영역은 아직 구축 중입니다. 계정에서 옵션을 찾을 수 없다면 티켓을 열어 주시면 활성화해 드리겠습니다.
호출 과정
Authorization: Bearer vpt_live_... 헤더로 인증합니다. 본문에는 오디오 URL(audio_url, https만), 결과를 받을 웹훅 URL을 입력하고, 선택적으로 엔진, 언어, 내보내기 형식 및 멱등성 키를 지정할 수 있습니다.
- Rate limit: 키당 분당 60회 요청;
- 크기: 서버에서 다운로드할 URL당 최대 500MB의 오디오; Premium 엔진의 경우 최대 5GB까지의 URL을 중간 다운로드 없이 엔진이 직접 읽을 수 있습니다.
- 비용: 사이트와 동일하게 길이와 엔진에 따라 사이클이 차감됩니다.
결과 수신(웹훅)
결과는 HMAC-SHA256으로 서명된 웹훅으로 전달됩니다(헤더 X-VPT-Signature 및 X-VPT-Event). 페이로드를 신뢰하기 전에 서명을 검증하세요. 엔드포인트가 중단된 경우 점진적 백오프로 재전송합니다: 약 24시간에 걸쳐 최대 6회 시도합니다.
보안상 https URL만 허용하며 내부/사설 주소는 차단합니다. 오디오가 인증 뒤에 있다면 API를 호출하기 전에 스토리지에서 서명된 임시 URL을 생성하세요.
파일에 공개 URL이 없나요(예: PABX 녹음)? 기업 감사 API에는 임시 업로드 URL(1시간 유효)을 반환하는 업로드 엔드포인트가 있습니다. 대량 통화 감사 용도라면 영업팀에 문의하세요.
자주 묻는 질문
키의 시크릿을 잃어버렸습니다. 어떻게 복구하나요?
복구할 수 없습니다. 키를 해지하고 새로 생성하세요. 시크릿은 생성 시에만 존재합니다.