Seedance 2.5 is live — 30-second cinematic video with native audio & real-person references

보이스 체인저 API

설정된 보이스 팩으로 소스 보컬을 변환하세요. 보이스 체인저 API는 억양 강도, 톤 기준, 비동기 출력 전달을 지원합니다.

모델 특징
음성 팩 · 악센트 강도 제어
적합한 용도
음성 오버, 캐릭터 음성, 더빙
입력
오디오 파일 URL + 음성 팩
출력
변환된 오디오
Input
0/1 file

MP3 / WAV / AAC / OGG

필수

0~1 사이 임의의 숫자; 기본값 1

source_file 또는 voice_pack

선택 사항

mp3, wav, flac, aac 또는 ogg

Result

이 모델로 만들 수 있는 것

이 모델로 구축하고 배포할 수 있는 실제 워크플로우와 프로덕션 활용 사례입니다.

타겟 보이스 팩으로 변환된 보컬 녹음

보이스 팩 변환을 위한 보이스 체인저 API

제품에 이미 타겟 보이스 팩 id가 있고 비동기 백엔드 호출로 소스 보컬을 변환해야 할 때 보이스 체인저 API를 사용하세요. 사용자가 팩을 선택하면 백엔드가 voice_pack_id를 전송하고, 작업은 converted_mix 출력을 반환합니다. 오디오 처리 전에 보이스 선택이 자체 제품에서 이루어지는 앱에 적합합니다. 보이스 체인저 API는 오디오 작업을 변환에 집중시키고, 팩 탐색과 권한은 앱이 담당하게 합니다.

음성 변환하기
억양과 톤을 위한 보이스 스타일 컨트롤

억양과 톤을 위한 보이스 체인저 API 컨트롤

accent는 0~1로, tonality는 source_file 또는 voice_pack으로 설정하세요. 보이스 체인저 API는 복잡한 오디오 편집기 없이도 제품 팀에 명확한 컨트롤을 제공합니다. 비엔지니어 사용자도 변환 폼을 이해할 수 있을 만큼 단순합니다. UI는 먼저 간단한 기본값을 노출한 다음, 이해하는 필드만 고급 사용자가 조정하도록 할 수 있습니다. 풀스케일 편집 화면이 아닌 가이드형 보이스 팩 흐름이 필요한 제품에 보이스 체인저 API가 잘 맞습니다.

오디오 변환 작업과 연결된 보이스 팩 라이브러리

퍼블리싱 흐름을 위한 보이스 체인저 API 출력

완료된 보이스 체인저 API 작업은 변환된 음성을 다운로드 가능한 트랙으로 반환합니다. 저장하거나 미리 듣거나, 모더레이션과 퍼블리싱 흐름으로 전달하세요. 라벨을 사용할 수 있을 때 output.tracks가 converted_mix를 식별할 수 있습니다.

가격

크레딧 기반 — 1 크레딧 = 0.001 USD. 성공한 생성에 대해서만 비용을 지불합니다.

첫 테스트 비용
$0.2200 credits

최저 등급 1회 생성(1 started minute).

테스트 예산 가이드
크레딧 충전
$10
약 50회 테스트
$50
약 250회 테스트
$100
약 500회 테스트
모델카테고리가격
음성 변환소스 음성
$0.2
200 credits · 1 started minute

reApi를 선택해야 하는 이유

이 보이스 체인저 API가 보이스 팩을 요구하는 이유

보이스 체인저 API는 voice_pack_id를 필수로 요구하므로 각 작업이 제품이 선택한 설정된 음성 자산을 타겟으로 합니다. 그 결과 변환 동작이 알려진 팩에 묶입니다. 팩 선택도 오디오 업로드 바깥에 머무릅니다.

작지만 유용한 범위의 컨트롤

accent는 실수 0~1 값을 사용하고 tonality_reference는 source_file 또는 voice_pack을 받습니다. 이 필드들은 오디오 전문 용어로 사용자를 덮지 않고 일반적인 스타일 선택을 다룹니다. 지원과 모더레이션 팀이 나중에 결과를 재현할 수 있도록 제출된 값을 각 작업과 함께 저장하세요.

동일한 폴링 계약의 보이스 체인저 API

작업을 제출하고 완료될 때까지 /api/v1/tasks/:id를 폴링하세요. 보이스 체인저 API는 다른 reAPI 오디오 페이지와 동일한 비동기 모델을 따릅니다. 백엔드 팀은 task 저장, 재시도, 결과 처리를 재사용할 수 있습니다. UI가 queued, processing, completed, failed 상태를 명확히 보여줄 때 보이스 체인저 API가 가장 잘 작동합니다.

3단계로 보이스 체인저 API 통합하기

  1. step 01

    API 키 발급

    워크스페이스 설정에서 reAPI 키를 생성하세요. 보이스 팩 id와 키가 서버 측에 머물도록 보이스 체인저 API 호출은 백엔드에서 유지하세요.

    열기
  2. step 02

    변환 작업 제출

    model을 audio-voice-change로 지정하고 audio_url, voice_pack_id를 함께 POST 요청하세요. 흐름에서 필요한 경우 accent, tonality_reference, dereverb_enabled 또는 encoder_format을 추가하세요.

    열기
  3. step 03

    폴링 후 결과 재생

    작업이 완료될 때까지 GET /api/v1/tasks/:id를 호출하세요. output.audio_urls를 다운로드하거나 output.tracks를 사용해 converted_mix 트랙을 찾으세요.

    열기
docs/api/voice-changer

API 레퍼런스

바로 사용 가능한 코드와 전체 파라미터 표입니다.

curl https://reapi.ai/api/v1/audio/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"audio-voice-change","audio_url":"https://cdn.example.com/source-vocal.wav","voice_pack_id":"voice_pack_id_here","accent":1,"encoder_format":"mp3"}'

파라미터 검증 실패

제출 시 동기적으로 거부되며 문제 필드가 명시됩니다. 열거 값·범위·URL 필드를 확인하세요. 과금은 발생하지 않습니다.

인증 또는 잔액 문제

401은 Bearer 키 누락/무효, 402는 선차감액이 잔액을 초과함을 뜻합니다. 키와 크레딧은 콘솔에서 관리합니다.

콘텐츠 또는 소재 거부

참조 소재와 생성 결과는 자동 심사를 거칩니다. 거부된 작업은 명확한 오류와 함께 실패하고 전액 환불됩니다.

작업 실패 또는 시간 초과

실패 상태에 도달한 작업은 과금되지 않으며 선차감액이 자동 환불됩니다. 작업 ID를 보관했다가 재시도하세요.

자주 묻는 질문

이 모델에 대한 일반적인 질문입니다.

보이스 체인저 API는 비동기 음성 변환 엔드포인트입니다. 필수 voice_pack_id와 함께 소스 보컬 audio_url을 보낸 다음 converted_mix 오디오 출력이 준비될 때까지 폴링하세요. 편집기를 직접 만들지 않고도 보이스 팩 변환이 필요한 제품에 보이스 체인저 API를 사용하세요.

start building

이제 출시할 준비가 되셨나요?

Playground에서 시험해 보거나 API 키를 발급받아 바로 연동해 보세요.