PopNowAPI
API 키 받기

Video Translator API

PopNow

클립을 28개 언어로 더빙하고 자막을 넣으며, 분 단위로 과금

popnow/video-translator-v1/video-translate
  • 동영상 번역

Video Translator 소개

클립을 28개 언어로 더빙하고 자막을 넣으며, 분 단위로 과금.

POST /jobs/createTask에서 모델 이름을 popnow/video-translator-v1/video-translate(으)로 지정하면 호출할 수 있습니다. US$0.005부터.

소개

Video Translator는 말하는 클립을 다른 언어로 더빙합니다. 영상을 video_url로 보내고 target_language를 고르면, 도구가 발화를 전사하고 번역한 뒤, 원래 대사의 타이밍에 맞춰 다시 음성으로 만들고, 같은 화면에 새 오디오를 입혀 반환합니다. clone_voice를 켜면 각 화자는 자신의 목소리를 본뜬 음성을 유지합니다.

주요 특징

화자는 여전히 본인처럼 들린다

clone_voice를 켜면, 더빙은 각 화자 본인의 목소리로 만든 음성으로 말해집니다. 두 사람이 나오는 저희 테스트에서 여성과 남성은 각자의 음색을 유지한 채 스페인어로 반환되었고, 각 대사는 원래 대사가 시작된 지점에서 시작했습니다.

고유 이름은 고유 이름으로 남는다

glossary에 {term, translation} 쌍으로 용어를 나열하면, 매번 지정한 방식대로 번역됩니다. 저희 테스트에서는 용어집에 등록한 구절이 그것이 나온 두 대사 모두에서 그대로 사용되었습니다.

요청 파라미터

파라미터필수설명
clone_voice아니요화자마다 본인과 비슷한 목소리로 다시 더빙합니다. 기본값: false
glossary아니요번역을 고정할 이름과 표현, 최대 100쌍.
keep_background_audio아니요더빙 아래 원래 음악과 효과음을 남깁니다. 끄면 목소리만. 기본값: true
source_language아니요영상 속 언어. 자동 인식하며, 음악이나 강한 억양, 긴 쉼이 있으면 직접 고르세요. auto · en · zh-CN · zh-TW · yue · es · fr · de · it · pt · ru · ja · ko · ar · hi · tr · vi · th · id · ms · nl · pl · uk · sv · fi · da · no · nn · cs · sk · ro · hu · el · bg · hr · sr · sl · bs · mk · sq · lt · lv · et · he · fa · ur · ps · sd · bn · as · pa · gu · mr · ne · sa · ta · te · kn · ml · si · my · km · lo · bo · ka · hy · az · kk · uz · tg · tk · mn · ba · tt · be · is · fo · cy · br · eu · gl · ca · oc · lb · la · mt · af · sw · so · am · ha · yo · ln · sn · mg · tl · jw · su · haw · mi · ht · yi · 기본값: auto
speaker_count아니요말하는 사람 수(1~4). 비우면 자동 인식. 1 · 2 · 3 · 4
target_language아니요더빙할 언어. 영상 속 언어와 달라야 합니다. en · es · fr · de · it · pt · nl · sv · da · no · fi · el · ru · pl · tr · he · id · ms · vi · th · tl · sw · zh-CN · zh-TW · ja · ko · ar · hi · 기본값: en
video_url예작업할 영상.

가격

요금은 미국 달러 기준입니다. API는 별도의 미국 달러 잔액을 사용합니다. 웹사이트 크레딧은 API에 사용할 수 없으며, API 잔액과 웹사이트 크레딧 간 전환도 지원하지 않습니다. 작업이 접수되면 견적의 최대 금액을 API 잔액에서 예약합니다. 완료 후 실제 사용량으로 정산하고 남은 예약 금액을 해제합니다. 청구액은 예약 금액을 넘지 않으며, 작업이 실패하면 예약 금액을 해제합니다.

옵션USD /초
기본US$0.005

실행 전에 같은 요청 본문을 POST /jobs/quote로 보내면 예상 요금과 최대 요금을 미국 달러로 확인할 수 있습니다. 견적만으로는 작업이 실행되거나 요금이 청구되지 않습니다.

활용 사례

짧은 형식 영상의 현지화

언어 시장마다 성우를 따로 섭외하지 않아도, 같은 클립을 여러 언어 시장에 게시할 수 있습니다.

영상 모델의 캐릭터 더빙

영어로 말하는 생성 캐릭터를, 캐릭터의 목소리를 유지한 채 시청자의 언어로 더빙할 수 있습니다.

프롬프트 가이드와 고급 팁

음악이 있을 때는 말하는 언어를 지정하기

깨끗한 발화에서는 자동 감지가 안정적입니다. 영상 처리에 관한 메시지와 함께 작업이 실패하면 source_language를 설정한 뒤 다시 보내세요.

말하는 사람 수를 알려 주기

speaker_count는 선택 사항이지만, 두 사람의 대화에서 설정하면 각 대사가 올바른 목소리에 할당됩니다.

영상도 계획에 포함하기

교체되는 것은 오디오뿐입니다. 입 움직임이 중요한 클로즈업이라면, 더빙된 클립을 나중에 Lip Sync 도구에 넣어 보세요.

API 빠른 시작

Video Translator API를 3단계로 호출하기

  1. API 키 만들기. PopNow에 로그인하고 API 콘솔에서 키를 만드세요. 키는 sk-popnow-로 시작하며 API 호출은 별도의 달러 잔액을 사용합니다.
  2. 요청 보내기. POST /jobs/createTask에 model은 popnow/video-translator-v1/video-translate, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
  3. 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "popnow/video-translator-v1/video-translate",
  "input": {
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "target_language": "en",
    "source_language": "auto"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.

Video Translator API 질문

Video Translator API 요금은 얼마인가요?

Video Translator 가격은 US$0.005 /초입니다. API는 별도의 미국 달러 잔액을 사용합니다. 웹사이트 크레딧은 API에 사용할 수 없으며, API 잔액과 웹사이트 크레딧 간 전환도 지원하지 않습니다. 작업이 접수되면 견적의 최대 금액을 API 잔액에서 예약합니다. 완료 후 실제 사용량으로 정산하고 남은 예약 금액을 해제합니다. 청구액은 예약 금액을 넘지 않으며, 작업이 실패하면 예약 금액을 해제합니다.

API에서 Video Translator의 모델 이름은 무엇인가요?

POST /jobs/createTask의 model 필드에 모델 이름 동영상 번역: popnow/video-translator-v1/video-translate 값을 입력하세요.

입 모양도 바뀌나요?

아니요. 화면은 보내신 그대로 프레임 단위로 돌아오고, 바뀌는 것은 오디오뿐입니다. 새 언어에 맞춰 입 모양을 바꿔야 한다면 결과물을 Lip Sync 도구에 한 번 더 돌리십시오.

음악과 효과음은 어떻게 되나요?

keep_background_audio가 켜져 있으면(기본값) 음악과 효과음이 새 목소리 아래에 그대로 남습니다. 끄면 돌아오는 클립에는 번역된 대사만 남고, 대사 사이는 무음이 됩니다.

자막도 받을 수 있나요?

네. 모든 결과에는 번역된 대사의 자막 파일(.srt)이 함께 옵니다. 더빙 음성에 맞춰 시간이 찍혀 있으며, 영상 옆에 역할이 subtitle인 두 번째 에셋으로 돌아옵니다.

Video Translator 모델을 코드 없이 사용해 볼 수 있나요?

Playground에서 API 키 없이 API의 미국 달러 잔액으로 Video Translator 모델을 실행할 수 있습니다. 각 실행은 해당 코드와 함께 개발자 기록에 저장됩니다.

Video Translator 더 알아보기