소개
말소리가 담긴 녹화 영상 번역
video_url을 입력하고 target_language를 선택하면 말하는 영상을 번역하고 립싱크를 맞춥니다. 영상 속 사람이 자신의 목소리와 비슷한 음성으로 새 언어를 말하는 것처럼 표현하기 전에 해당 인물의 동의를 받아야 합니다.
설정 선택
178개 언어 및 방언 옵션 중 기본 대상 언어는 영어입니다. generation_mode의 기본값은 더 높은 립싱크 품질을 목표로 하는 precision입니다. speed는 초당 요금이 절반이며 더 빠른 결과를 목표로 합니다. 여기에는 프롬프트, 원본 언어 설정, 자막 옵션이 없습니다.
측정 결과
테스트 출력은 원본 화면 크기를 유지한 AAC 오디오의 MP4였습니다. 1280x720 원본은 1280x720으로 반환되었습니다. 테스트에서 68초 영상은 약 100120초가 걸렸습니다. 이 측정값이 완료 시간을 보장하지는 않습니다. 결과가 원본보다 길어질 수 있지만, 과금은 원본의 초 수를 기준으로 합니다.
| 항목 | 값 |
|---|---|
| 입력 | 영상 |
| 출력 | 영상 |
| 입력 영상 |
|
| 원본 길이 제한 | 120초, 초과 영상은 요금 부과 없이 거부 |
| 번역 옵션 | 178개 언어 및 방언 옵션, 기본값은 영어 |
| 모드 설정 | 기본값 precision 또는 speed |
| 목소리 처리 | HeyGen 설명에 따르면 목소리 복제로 언어가 바뀌어도 화자의 음색 유지 |
| 출력 측정 결과 | 테스트 결과: MP4, AAC 오디오, 원본 화면 크기 유지 |
| 과금 기준 | 원본 길이를 초 단위로 올림, 최소 1초·최대 120초 |
핵심 기능 및 하이라이트
와인 저장고의 대화를 스페인어로 번역합니다
두 사람이 등장하는 와인 저장고 장면에 스페인어와 Precision 모드를 적용한 예시입니다. 테스트에서 원본과 결과의 같은 순간을 비교하자 입 모양은 달라졌고 얼굴, 의상, 장면은 그대로 유지되었습니다.
같은 원본 영상으로 일본어를 시험합니다
일본어 예시는 와인 저장고 영상에 Speed 모드를 적용합니다. Speed는 더 빠른 결과를 목표로 하며 초당 요금은 Precision의 절반입니다. 과금할 초 수는 여전히 원본 길이를 기준으로 정해집니다.
지역별 방언도 언어 옵션에 포함됩니다
178개 옵션에는 Spanish (Mexico), French (Canada), Chinese (Cantonese, Traditional)가 포함됩니다. HeyGen은 목소리 복제를 통해 언어를 바꿔도 화자의 음색을 유지한다고 설명합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
video_url | 예 | 말소리가 있는 영상이 필수이며 길이는 120초로 제한됩니다. 모델 페이지에서는 MP4와 WebM을 받습니다. 1자 이상 |
target_language | 아니요 | 기본값은 영어입니다. 영어 억양 2종을 포함한 178개 기본 언어 및 지역별 방언 옵션 중에서 선택합니다. |
generation_mode | 아니요 | 더 높은 립싱크 품질을 목표로 하는 기본값 precision을 사용합니다. 더 빠른 결과를 목표로 하며 Precision의 절반 요금으로 처리하려면 speed를 사용합니다. |
요금
원본 영상의 길이를 초 단위로 올림하여 최소 1초, 최대 120초를 과금합니다. Precision의 요금은 Speed의 2배입니다. 선택한 언어는 요금에 영향을 주지 않습니다. 120초 초과로 거부된 영상을 포함해 실패하거나 거부된 작업에는 요금이 부과되지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.048 / 초 |
| $0.096 / 초 |
활용 사례
강좌 소개를 번역합니다
직접 촬영한 짧은 환영 영상을 번역하고 립싱크를 맞춰 스페인어권 학습자에게 강좌를 소개합니다.
제품 사용 안내를 현지화합니다
진행자의 동의를 받아 말로 설명하는 제품 시연 영상을 프랑스어로 번역하고 다른 시장의 고객에게 전달합니다.
크리에이터의 소식을 해외에 전합니다
녹화한 공지 영상을 일본어로 번역하여 시청자가 자신의 언어로 새 소식을 들을 수 있게 합니다.
프롬프트 가이드 및 실전 팁
번역 전에 동의를 받습니다
본인의 녹화 영상이나 이번 번역에 동의한 사람의 영상을 사용합니다. 모델 페이지에서 처음 실행하기 전에 표시되는 동의 안내를 확인하고 수락합니다.
말소리가 있는 짧은 영상을 준비합니다
말소리가 들리는 MP4 또는 WebM의 video_url을 입력합니다. 원본 길이는 120초 이하여야 합니다.
언어와 모드를 선택합니다
target_language를 선택합니다. 기본값은 영어입니다. 더 높은 립싱크 품질을 목표로 하는 Precision이나, 더 빠른 결과와 낮은 요금을 위한 Speed를 사용합니다.
소개
HeyGen Video Translate는 짧은 영상의 말소리를 다른 언어로 바꾸고 번역에 맞게 립싱크를 조정합니다. HeyGen은 실제 같은 AI 음성으로 175개 이상의 언어와 방언을 지원하며, 목소리 복제로 언어가 바뀌어도 화자의 음색을 유지한다고 설명합니다. 이 페이지에서는 대상 옵션 178개를 제공합니다.
영상을 보내기 전에 동의를 받아야 합니다. 본인이나 이 용도에 동의한 사람의 녹화 영상을 사용합니다. 번역을 하면 출연자가 자신의 목소리와 비슷한 음성으로 다른 언어의 말을 하는 것처럼 보입니다. 모델 페이지에서 처음 실행할 때 동의 안내를 수락해야 합니다.
말소리가 담긴 120초 이하의 MP4 또는 WebM을 준비합니다. target_language를 설정하고 필요하면 generation_mode도 지정합니다. 작성할 프롬프트는 없습니다. 기본값은 영어와 Precision입니다.
주요 기능과 특징
- 말소리에 맞춰 입 움직임을 바꿉니다. 테스트에서 원본과 번역 영상의 같은 순간을 비교했을 때 입 모양이 달랐으며, 얼굴과 의상, 장면은 그대로였습니다.
- 지역에 맞는 대상을 선택합니다. 178개 옵션에는 기본 언어와 함께 Spanish (Mexico), French (Canada), Chinese (Cantonese, Traditional)가 포함됩니다.
- 두 모드 중 우선순위에 따라 선택합니다. Precision은 더 높은 립싱크 품질을, Speed는 더 빠른 결과를 목표로 합니다. Speed의 초당 요금은 절반입니다.
- 영어 억양도 선택할 수 있습니다. 대상 옵션에는 ‘English - Your Accent’와 ‘English - American Accent’가 있습니다.
- 테스트에서 화면 크기가 유지되었습니다. AAC 오디오를 포함한 MP4가 반환되었으며, 1280x720 입력은 같은 크기로 출력되었습니다.
- 원본 길이로 요금을 계산합니다. 번역 결과가 길어져도 과금할 원본 초 수는 늘어나지 않습니다. 실패하거나 거부된 작업에는 요금이 부과되지 않습니다.
활용 사례
- 스페인어 강좌 환영 영상: 직접 녹화한 소개를 번역하여 스페인어권 학생들이 말에 맞는 입 움직임과 함께 환영 인사를 들을 수 있게 합니다.
- 프랑스어 제품 시연: 진행자의 동의를 받은 뒤 짧은 사용 안내를 프랑스어권 고객을 위해 번역합니다.
- 일본어 크리에이터 공지: 같은 원본 녹화 영상으로 소식을 일본어권 시청자에게 전달합니다.
입력 가이드와 활용 팁
- 먼저 허락을 확인합니다. 번역된 대사를 말하는 모습으로 표현될 모든 사람의 동의를 받습니다. 유명인이나 공인, 지인의 영상을 허락 없이 사용해서는 안 됩니다.
- 제출 전에 녹화 내용을 확인합니다. 말소리가 들리는지 확인하고 원본을 120초 이하로 잘라 준비합니다. 더 긴 영상은 요금 부과 전에 거부됩니다.
- 대상 언어를 의도에 맞게 지정합니다. 기본값인 영어를 실수로 그대로 두지 않도록, 기본 언어와 지역별 방언 중 시청자에게 맞는 옵션을 확인합니다.
- 립싱크 품질을 우선하면 Precision을 선택합니다. 기본 모드이며 더 높은 립싱크 품질을 목표로 합니다. 요금이 Speed의 2배라는 점도 선택에 반영합니다.
- Speed의 요금과 처리 목표가 작업에 맞으면 선택합니다. 초당 요금이 절반이며 더 이른 완료를 목표로 하지만, 실제 완료 시간은 달라질 수 있습니다.
- 번역된 말이 길어질 여유를 둡니다. 테스트에서 8.00초 녹화 영상이 8.68초 스페인어 영상으로 반환되었습니다. 다른 영상과 이어 편집하기 전에 완성본의 길이를 확인합니다.
- 반환된 영상은 14일 안에 저장합니다. 생성된 영상은 보관 기간이 끝나면 삭제됩니다.
- 제공되는 설정을 사용합니다. 이 페이지에는 프롬프트, 원본 언어 입력란, 자막 옵션이 없습니다. 영상과 대상 언어, 모드를 선택해 사용합니다.
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": "heygen/video-translate/video-translate",
"input": {
"generation_mode": "precision",
"target_language": "English",
"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 레퍼런스에서 확인하세요.

