API 참조
VoiceCheap API는 표준 HTTP 메서드와 상태 코드를 사용합니다. 대부분의 엔드포인트는 JSON을 반환하고, 전사 내보내기는 SRT 또는 VTT도 반환할 수 있습니다. 계정 설정, 팀 관리, 미디어 도구 및 기타 워크플로에는 작업 카탈로그를 사용하세요. 이러한 워크플로는 계정 MCP 서버에서도 사용할 수 있습니다. 단, 웹훅 서명 비밀 키 생성과 교체에는 REST가 필요합니다. 연동에서 자격 증명을 관리하고 사용 제한을 확인하세요.기본 URL
모든 API 요청은 다음 주소로 보내야 합니다:인증
비공개 REST 호출은x-api-key 또는 Authorization: Bearer의 API 키로 인증하세요. OpenAPI 문서는 공개되어 있습니다. 권한 범위가 지정된 자격 증명과 MCP용 OAuth는 인증을 참고하세요.
JSON 작업 API
계정, 팀, 프로젝트, 음성 및 미디어 도구 섹션에서 각 JSON 작업을 개별적으로 설명합니다. 이 경로들은 조회와 삭제를 포함하여 모두POST를 사용합니다. 인수는 JSON 본문으로 보내세요. 아래의 파일 업로드 및 기존 프로젝트 경로는 각자의 HTTP 메서드를 유지합니다.
account:read 권한이 있는 API 키를 만들고 VOICECHEAP_API_KEY 환경 변수를 설정한 다음 이 읽기 전용 요청을 실행하세요.
data에 결과를 반환합니다. 오래 걸리는 작업은 HTTP 202와 requestId를 반환합니다. 요청 상태를 조회하여 결과를 가져오세요. 작업 요청이 완료된 후에도 미디어 처리가 계속될 수 있습니다.
분야별 전체 작업을 살펴보거나 키에 허용된 작업과 스키마를 확인하세요. 각 페이지에 권한, 매개변수, 예제 및 오류가 설명되어 있습니다.
콘텐츠 유형
- 요청: 파일 업로드에는
multipart/form-data을, 기타 요청에는application/json을 사용하십시오. - 응답: JSON 엔드포인트는
application/json을 반환합니다. 대본 내보내기는 SRT 또는 VTT 텍스트를 반환할 수도 있습니다.
파일 업로드 및 기존 프로젝트 경로
미디어 전사
POST /v1/transcribe업로드된 파일을 JSON, SRT 또는 VTT로 전사합니다.프로젝트 대본 내보내기
POST /v1/projects/{projectId}/transcript원본 또는 번역된 프로젝트 대본을 검색합니다.프로젝트 만들기
POST /v1/projects동영상 또는 오디오 파일을 업로드하고 번역 없이 전사만 시작합니다.번역 시작
POST /v1/translate비디오 또는 오디오 파일을 업로드하고 번역 프로젝트를 시작합니다.프로젝트 더빙
POST /v1/projects/{projectId}/dub전사가 완료된 프로젝트를 직접 번역한 SRT로 더빙합니다.번역 상태 가져오기
GET /v1/translate/{projectId}/status번역 프로젝트의 상태를 확인하고 결과를 검색합니다.프로젝트 세부 정보 가져오기
GET /v1/projects/{projectId}번역된 버전 기록, 립싱크 기록 및 프로젝트 상태를 검색합니다.프로젝트 삭제
DELETE /v1/translate/{projectId}번역 프로젝트와 해당 자산을 영구적으로 삭제합니다.번역 워크플로우
비디오 번역을 위한 일반적인 워크플로우는 다음과 같습니다:응답 형식
아래의 기존 파일 업로드 및 프로젝트 경로는 엔드포인트별 응답 형식을 유지합니다. 성공 응답의 필드는 엔드포인트마다 다릅니다. 프로젝트 생성과 더빙 시작 요청은success, message, projectId를 반환합니다. 상태 및 프로젝트 세부 정보 요청은 프로젝트 상태를 반환하고, 전사 요청은 JSON, SRT 또는 VTT를 반환합니다. 정확한 필드는 각 엔드포인트 페이지를 확인하세요.
오류는 code와 message가 포함된 JSON 객체로 반환되며 details가 포함될 수도 있습니다. 오류 코드를 참조하세요.