개발자 API
워크플로에 Addavox 현지화를 통합하세요. 독립형 번역 오디오를 원하시면 번역 API 을, 타이밍, QA 및 자막을 포함한 전체 비디오 현지화를 원하시면 비디오 더빙 API 선택하세요.
API 키
Addavox 앱에서 API 키를 생성하세요. 각 키는 계정과 동일한 요금제 및 포함된 통화 시간을 사용합니다.
API 키 관리기본 URL:
https://api.addavox.com/api/v1
인증 헤더:
X- API -키: YOUR_KEY
서비스 개요
서로 다른 현지화 요구 사항을 위한 두 개의 API .
번역 API
단일 엔드포인트: POST /api/v1/localize — 원본 콘텐츠에서 독립형 번역 오디오를 생성합니다.
웹 앱과 API 비교: 브라우저에서 Addavox 제품을 사용할 경우, 세그먼트 편집 및 현지화 작업은 각 세그먼트의 미리 보기 오디오를 유지하고 프로젝트 페이지에서 에셋을 다운로드할 때까지 전체 믹싱 프로그램을 지연시킵니다. 이러한 v1 엔드포인트는 작업의 일부로 스티칭된 출력을 생성하므로 API 클라이언트는 별도의 내보내기 단계 없이 결과를 가져올 수 있습니다.
당신이 제공하는 것
- 원본 오디오
- 원어 + 대상어
저희가 처리합니다
- 전사
- 번역
- 화자 일치 음성 오디오
- 순차적 스티칭
에서 $0.08/분
사업 계획 요금. 가격 보기 →
당신이 제공하는 것
- 원본 오디오
- 구간별 타임스탬프가 포함된 녹취록
- 원어 + 대상어
저희가 처리합니다
- 번역
- 화자 일치 음성 오디오
- 순차적 스티칭
에서 $0.06/분
사업 계획 요금. 가격 보기 →
당신이 제공하는 것
- 원본 오디오
- 부분별 타임스탬프가 포함된 녹취록 및 번역
저희가 처리합니다
- 화자 일치 음성 오디오
- 순차적 스티칭
에서 $0.05/분
사업 계획 요금. 가격 보기 →
작동 방식
출력 형식
API 은 독립적인 순차 오디오 파일을 생성합니다. 번역된 각 부분은 순서대로 생성되어 짧은 간격을 두고 이어 붙여집니다. 출력 파일은 원본 소스와 시간적으로 정렬되지 않으며, 독립적으로 청취하도록 설계된 새로운 오디오 파일입니다.
왜 원본 오디오와 타임스탬프를 제공해야 할까요?
원본 오디오 및 세그먼트 타임스탬프(시작 시간, 종료 시간)는 원본 녹음에서 각 화자의 음성을 식별하고 일치시키는 데 사용됩니다. 이를 통해 생성된 오디오가 원본 화자의 음성처럼 들리도록 할 수 있습니다. 이러한 타임스탬프는 출력 타이밍을 제어하지 않습니다.
QA 또는 기간 일치 없음
비디오 더빙과 달리, 번역 API 은 텍스트 수정, 템포 조정 또는 타이밍 정렬을 수행하지 않습니다. 이것이 번역이 더 빠르고 저렴한 이유입니다. 프레임 단위로 원본 비디오와 오디오를 동기화해야 하는 경우 비디오 더빙 API 을 사용하십시오.
코드 예제
비디오 더빙 API 용어집_0__
엔드포인트: POST /api/v1/localize-video — 타이밍, QA 및 자막을 포함한 전체 비디오 현지화.
이 API 통해 시작된 작업은 완료 시 언어별 결과물을 생성합니다. 브라우저 기반 Addavox 앱은 동일한 현지화 엔진을 사용하지만, 별도의 언급이 없는 한 모든 혼합 에셋은 프로젝트 다운로드 흐름으로 전달됩니다.
당신이 제공하는 것
- 동영상 URL
- 원어
- 대상 언어 (하나 이상)
저희가 처리합니다
- 오디오/비디오 분리
- 전사
- 번역
- LLM QA
- 음성 합성
- 타이밍 정렬
- 자막 생성
- 언어별 비디오 렌더링
출력 형식
언어별 비디오, 오디오 및 자막을 제공합니다. 모든 언어가 포함된 ZIP 파일도 다운로드할 수 있습니다. 서명된 URL은 24시간 후 만료됩니다.
다국어 구사 가능자 채용
하나의 요청으로 여러 언어를 지원합니다. 마스터 작업은 언어별로 하위 작업을 생성합니다. 마스터 작업에서 언어별 상태를 주기적으로 확인하세요. 상태 값은 다음과 같습니다: 대기 중 → 실행 중 → 완료됨 | 실패함.
검토자 워크플로
API 을 통해 사람 검토자를 초대하세요. 각 검토자는 웹 편집기에서 현지화를 수정할 수 있는 링크가 포함된 이메일을 받게 되며, 계정은 필요하지 않습니다.
코드 예제
동의 및 승인
모든 API 요청에는 동의 객체와 최상위 모드 필드가 포함되어야 합니다. 이 두 가지를 통해 작업별 인증 기록이 생성되어 필요한 권한과 발언자 동의를 보유하고 있음을 확인합니다.
모드 필드는 음성 합성 방식을 결정합니다. "voice_matched"는 화자 음성 복제를 사용하고, "standard"는 합성 TTS를 사용합니다. 두 모드 모두 가격은 동일하며, 선택은 전적으로 사용자의 동의에 달려 있습니다.
음성 인식 모드 - 전체 동의 필요
표준 모드 - 콘텐츠 권한만 표시
필드 참조
| 필드 | 유형 | 필수의 | 설명 |
|---|---|---|---|
| mode | string | 최상위 | voice_matched 또는 standard |
| speaker_consent_obtained | boolean | 음성 일치 전용 | 식별 가능한 화자로부터의 명시적 동의 |
| content_rights_confirmed | boolean | 두 모드 모두 | 콘텐츠에 대한 소유권 또는 유효한 라이선스 |
| eula_accepted | boolean | 두 모드 모두 | Addavox 최종 사용자 라이선스 계약(EULA)에 동의합니다. |
| attested_by | string | 두 모드 모두 | 책임자의 이메일 또는 신원 정보 |
| attested_at | ISO 8601 | 두 모드 모두 | 요청 시간으로부터 24시간 이내 |
동의 오류 코드
| HTTP | 암호 | 상태 |
|---|---|---|
| 403 | CONSENT_MISSING | 동의 반대 없음 |
| 403 | CONSENT_INCOMPLETE | attested_by가 누락되었거나 attested_at이 잘못되었습니다. |
| 403 | CONSENT_NOT_AFFIRMED | 권리 또는 최종 사용자 라이선스 계약(EULA)이 확인되지 않았습니다. |
| 403 | CONSENT_EXPIRED | 24시간 이상 경과된 인증 |
| 403 | SPEAKER_CONSENT_REQUIRED | 화자의 동의 없이 음성 일치 |
| 400 | INVALID_MODE | 잘못된 모드 값 |
API 참조
완전한 대화형 스키마 및 추가 엔드포인트는 Open API 통해 이용할 수 있습니다.
엔드포인트
| POST /localize | 사전 번역/부분 녹취록 오디오 현지화 |
| POST /localize-video | 전체 영상 더빙 (다국어 지원) |
| GET /jobs/{job_id} | 직무 상태 |
| GET /jobs/{job_id}/result | 결과물 (URL, 압축 파일) |
| GET /jobs | 채용 공고 목록 |
| DELETE /jobs/{job_id} | 작업 취소 |
| GET /account | 계정 정보 |
| GET /voices | TTS 음성 카탈로그 |
| GET /languages | 지원되는 언어 |
| POST /projects/{id}/reviewers | 리뷰어 초대 |
| GET|POST /jobs/{id}/webhooks | 웹훅 상태 / 재시도 |
API 서비스 가격 책정
구독 플랜별 분당 요금입니다. 아래 요금은 비즈니스 플랜 연간 가격(20% 할인)을 반영합니다. 모든 플랜 및 서비스에 대한 전체 요금은 표를 참조하십시오.
연간 할인율이 적용된 비즈니스 플랜 요금입니다.
무료
비디오 더빙
포함됨 (~분)
2 min
기본 금리(연간)
/min
초과
$4.00/min
API 서비스
오디오 분리
독자적인 노이즈 제거 음성 트랙
기준 금리
$0.03/min
초과
$0.04/min
포함됨 (~분)
~— min
성별 감지
음성 및 문맥을 통한 성별 분류
기준 금리
$0.02/min
초과
$0.02/min
포함됨 (~분)
~— min
전사(STT)
Deepgram 음성-텍스트 변환 및 화자 분리 기능
기준 금리
$0.05/min
초과
$0.06/min
포함됨 (~분)
~— min
번역
구글 번역
기준 금리
$0.03/min
초과
$0.04/min
포함됨 (~분)
~— min
텍스트 음성 변환
구글 TTS 및 기타 제공업체
기준 금리
$0.06/min
초과
$0.08/min
포함됨 (~분)
~— min
음성 일치
독자적인 음성 복제(올인원)
기준 금리
$0.08/min
초과
$0.10/min
포함됨 (~분)
~— min
기동기
비디오 더빙
포함됨 (~분)
10 min
기본 금리(연간)
$2.80/min
초과
$3.60/min
API 서비스
오디오 분리
독자적인 노이즈 제거 음성 트랙
기준 금리
$0.02/min
초과
$0.03/min
포함됨 (~분)
~— min
성별 감지
음성 및 문맥을 통한 성별 분류
기준 금리
$0.02/min
초과
$0.02/min
포함됨 (~분)
~— min
전사(STT)
Deepgram 음성-텍스트 변환 및 화자 분리 기능
기준 금리
$0.04/min
초과
$0.05/min
포함됨 (~분)
~— min
번역
구글 번역
기준 금리
$0.02/min
초과
$0.03/min
포함됨 (~분)
~— min
텍스트 음성 변환
구글 TTS 및 기타 제공업체
기준 금리
$0.05/min
초과
$0.06/min
포함됨 (~분)
~— min
음성 일치
독자적인 음성 복제(올인원)
기준 금리
$0.08/min
초과
$0.10/min
포함됨 (~분)
~— min
창조자
비디오 더빙
포함됨 (~분)
30 min
기본 금리(연간)
$2.64/min
초과
$3.20/min
API 서비스
텍스트 입력 + 번역 + 음성 오디오
전체 번역 API 번들
기준 금리
$0.11/min
초과
$0.13/min
포함됨 (~분)
~— min
번역 + 음성 오디오
번역 + 음성 오디오 패키지
기준 금리
$0.10/min
초과
$0.11/min
포함됨 (~분)
~— min
음성 오디오만
음성 오디오 전용 번들
기준 금리
$0.08/min
초과
$0.10/min
포함됨 (~분)
~— min
오디오 분리
독자적인 노이즈 제거 음성 트랙
기준 금리
$0.02/min
초과
$0.02/min
포함됨 (~분)
~— min
성별 감지
음성 및 문맥을 통한 성별 분류
기준 금리
$0.01/min
초과
$0.02/min
포함됨 (~분)
~— min
전사(STT)
Deepgram 음성-텍스트 변환 및 화자 분리 기능
기준 금리
$0.03/min
초과
$0.04/min
포함됨 (~분)
~— min
번역
구글 번역
기준 금리
$0.02/min
초과
$0.03/min
포함됨 (~분)
~— min
텍스트 음성 변환
구글 TTS 및 기타 제공업체
기준 금리
$0.04/min
초과
$0.05/min
포함됨 (~분)
~— min
음성 일치
독자적인 음성 복제(올인원)
기준 금리
$0.06/min
초과
$0.08/min
포함됨 (~분)
~— min
찬성
비디오 더빙
포함됨 (~분)
120 min
기본 금리(연간)
$1.99/min
초과
$2.80/min
API 서비스
텍스트 입력 + 번역 + 음성 오디오
전체 번역 API 번들
기준 금리
$0.10/min
초과
$0.11/min
포함됨 (~분)
~— min
번역 + 음성 오디오
번역 + 음성 오디오 패키지
기준 금리
$0.08/min
초과
$0.10/min
포함됨 (~분)
~— min
음성 오디오만
음성 오디오 전용 번들
기준 금리
$0.06/min
초과
$0.08/min
포함됨 (~분)
~— min
오디오 분리
독자적인 노이즈 제거 음성 트랙
기준 금리
$0.02/min
초과
$0.02/min
포함됨 (~분)
~— min
성별 감지
음성 및 문맥을 통한 성별 분류
기준 금리
$0.01/min
초과
$0.01/min
포함됨 (~분)
~— min
전사(STT)
Deepgram 음성-텍스트 변환 및 화자 분리 기능
기준 금리
$0.02/min
초과
$0.03/min
포함됨 (~분)
~— min
번역
구글 번역
기준 금리
$0.02/min
초과
$0.02/min
포함됨 (~분)
~— min
텍스트 음성 변환
구글 TTS 및 기타 제공업체
기준 금리
$0.03/min
초과
$0.04/min
포함됨 (~분)
~— min
음성 일치
독자적인 음성 복제(올인원)
기준 금리
$0.05/min
초과
$0.06/min
포함됨 (~분)
~— min
사업
비디오 더빙
포함됨 (~분)
500 min
기본 금리(연간)
$1.60/min
초과
$2.40/min
API 서비스
텍스트 입력 + 번역 + 음성 오디오
전체 번역 API 번들
기준 금리
$0.08/min
초과
$0.10/min
포함됨 (~분)
~— min
번역 + 음성 오디오
번역 + 음성 오디오 패키지
기준 금리
$0.06/min
초과
$0.08/min
포함됨 (~분)
~— min
음성 오디오만
음성 오디오 전용 번들
기준 금리
$0.05/min
초과
$0.06/min
포함됨 (~분)
~— min
오디오 분리
독자적인 노이즈 제거 음성 트랙
기준 금리
$0.01/min
초과
$0.02/min
포함됨 (~분)
~— min
성별 감지
음성 및 문맥을 통한 성별 분류
기준 금리
$0.01/min
초과
$0.01/min
포함됨 (~분)
~— min
전사(STT)
Deepgram 음성-텍스트 변환 및 화자 분리 기능
기준 금리
$0.02/min
초과
$0.03/min
포함됨 (~분)
~— min
번역
구글 번역
기준 금리
$0.02/min
초과
$0.02/min
포함됨 (~분)
~— min
텍스트 음성 변환
구글 TTS 및 기타 제공업체
기준 금리
$0.02/min
초과
$0.03/min
포함됨 (~분)
~— min
음성 일치
독자적인 음성 복제(올인원)
기준 금리
$0.03/min
초과
$0.05/min
포함됨 (~분)
~— min
표시된 시간은 동일한 사용 시간을 나타냅니다. 크레딧은 모든 서비스에서 공유됩니다. 저렴한 서비스를 이용하면 분당 차감되는 크레딧 수가 줄어듭니다.