소개
이 엔드포인트의 기능
VEED Dubbing은 video_url의 음성을 듣고 target_language로 번역한 뒤 각 화자의 복제 목소리로 다시 입힙니다. 입 주변을 새 단어에 맞게 다시 그리며 각 프레임의 나머지 영역은 그대로 둡니다.
중요한 입력값
target_language는 86개 기본 언어 중 하나입니다. source_language의 기본값은 auto이며 언어 감지가 틀릴 때만 지정하세요. keyterms에는 음성 인식 시 입력한 표기 그대로 쓸 이름이나 짧은 구문을 최대 열 개까지 넣을 수 있습니다.
반환 결과
원본 화면 크기와 비슷한 길이의 MP4 하나를 25 fps로 반환합니다. 테스트에서는 길이 사 초인 영상이 약 80초에, 두 사람이 나누는 길이 팔 초의 대화가 약 사 분에 완료되었습니다.
| 항목 | 값 |
|---|---|
| 입력 | 영상 |
| 출력 | 영상 |
| 필수 입력 | 말소리가 있는 영상(업로드 또는 파일 직접 링크)과 대상 언어 |
| 영상 길이 | 최대 10분 |
| 더빙 언어 | 86개 기본 언어 |
| 원본 언어 | 자동 감지 또는 86개 언어 중 선택 |
| 목소리 | 영상에서 각 화자의 목소리 복제 |
| 과금 | 원본 영상의 초 단위, 소수점 이하 올림 |
핵심 기능 및 하이라이트
두 사람의 장면을 스페인어로 더빙하고 입 모양까지 다시 그립니다
와인 저장고에서 나눈 8초 분량의 대화를 스페인어로 더빙하자 두 화자의 입 모양이 모두 새 대사에 맞춰졌습니다. 각 화자의 입 주변만 다시 그립니다. 와인통과 잔, 조명은 프레임마다 원본과 일치합니다.
같은 프레임에서 달라지는 입 모양
같은 순간을 나란히 비교합니다. 왼쪽은 영어 원본, 오른쪽은 스페인어 더빙 버전입니다. 남성의 입은 스페인어 대사를 말하는 모양으로 바뀌고, 얼굴의 나머지 부분과 수염, 배경은 촬영 당시 모습 그대로 유지됩니다.
영상 속 대사로 각 화자의 목소리를 복제합니다
별도로 켜야 할 설정도, 업로드할 참조 음성도 없습니다. 더빙에 쓰이는 각 목소리는 해당 화자가 영상에서 말한 대사로 만들어집니다. 두 사람이 등장하면 새 언어에서도 서로 다른 두 음색을 유지합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
video_url | 예 | 더빙할 영상으로, 최대 10분이며 오디오 트랙에 말소리가 있어야 합니다. 업로드하거나 동영상 파일의 직접 링크를 넣으세요. 1자 이상 |
target_language | 예 | 필수 항목입니다. 86개 기본 언어 중 더빙할 언어를 선택하세요. |
source_language | 아니요 | 영상에서 쓰는 언어입니다. 기본값 auto는 언어를 자동 감지합니다. |
keyterms | 아니요 | 입력한 그대로 받아쓸 이름이나 짧은 구문을 최대 10개까지 지정합니다. 항목당 최대 50자, 5단어이며 < > { } [ ] 또는 역슬래시는 사용할 수 없습니다. 10개 이하 |
요금
$0.144 / 출력 초
최대 10분까지 원본 영상의 초 단위로 과금하며 소수점 이하는 올림합니다. 제출 전 예상 금액은 업로드한 영상의 길이를 사용하고, 링크는 최대 길이인 10분을 기준으로 합니다. 차액은 작업 최종 정산 시 해제됩니다. 언어 선택과 keyterms는 가격에 영향을 주지 않습니다. 실패한 요청에는 요금이 부과되지 않습니다.
활용 사례
새로운 시장을 위한 카메라 토크 영상
카메라를 보며 말하는 크리에이터가 같은 촬영분을 스페인어, 독일어, 일본어로 게시할 수 있습니다. 시청자에게는 새 대사에 맞는 입 움직임이 보입니다.
광고와 제품 소개 영상
진행자가 나오는 짧은 영상을 재촬영이나 성우 없이 현지화하세요. 비용은 영상 길이의 초 수에 따라 정해집니다.
영상 모델로 만든 캐릭터
영어로 말하는 생성 캐릭터를 더빙하고 립싱크를 맞춰 다른 언어에서도 자연스러운 장면으로 만들 수 있습니다.
프롬프트 가이드 및 실전 팁
말소리가 또렷한 영상을 보내세요
영상을 업로드하거나 파일의 직접 링크를 넣으세요. 조명이 밝고 카메라를 향한 얼굴일수록 입 움직임이 깔끔합니다.
더빙할 언어를 고르세요
86개 기본 언어 중에서 target_language를 선택하세요. 언어 감지가 계속 틀리지 않는 한 source_language는 auto로 두세요.
정확히 인식할 이름을 알려주세요
브랜드나 캐릭터 이름 등 keyterms를 최대 열 개까지 추가하면 음성 인식 시 입력한 표기를 따릅니다.
소개
VEED Dubbing은 VEED 더빙 API의 표준 버전입니다. 말소리가 담긴 영상을 video_url로 보내고 target_language를 선택하면, 각 화자의 목소리를 복제하고 번역된 말에 입 모양을 맞춘 영상을 해당 언어로 받습니다.
주요 기능과 장점
새 언어에 맞춰 움직이는 입
보이는 화자마다 입 주변을 다시 그립니다. 와인 저장고 테스트에서는 여성과 남성 모두 스페인어에 맞게 립싱크가 조정되었고, 와인통과 잔, 조명은 그대로 유지되었습니다.
알아볼 수 있는 목소리
따로 켜는 설정은 없습니다. 영상 자체에서 각 화자의 목소리를 복제하므로 별도의 음성 샘플 없이도 더빙에 원래 음색이 유지됩니다.
의미를 살리는 번역
테스트에서 한 여성이 자신을 혼자 저장고로 데려왔다고 말한 대사는 “a solas”로 번역되었습니다. 덕분에 직역 시 생길 수 있는 문법적 성별 오류를 피했습니다.
활용 사례
한 크리에이터, 여러 언어
한 번 촬영하고 각 시장에 맞는 버전을 게시하세요. 입 움직임도 버전마다 맞춰집니다.
생성 장면 현지화
영상 모델의 캐릭터를 시청자의 언어로 더빙하면서 설득력 있는 입 움직임을 유지하세요.
입력 가이드와 활용 팁
얼굴이 보이게 하세요
조명이 밝고 카메라를 향한 얼굴에서 립싱크가 가장 또렷합니다. 넓게 잡은 화면이나 가려진 얼굴에도 새 오디오는 적용되지만 입 주변의 눈에 보이는 변화는 적습니다.
keyterms는 번역이 아닌 이름에 쓰세요
Keyterms는 이름이나 브랜드를 정확히 받아쓰도록 돕습니다. 용어와 번역을 짝지어 넣는 기능이 아닙니다. 각 용어는 영상에서 발음되는 대로 적으세요.
지역별 억양이 필요한가요?
이 버전은 기본 언어로 더빙합니다. 지역별 억양과 목소리 유사도 조절은 VEED Dubbing Pro에서 제공합니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "veed/dubbing/video-translate",
"input": {
"source_language": "auto",
"target_language": "af",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.
