PopNowAPI Docs
Main content

Video Translator API reference

Dub a clip into 28 languages with subtitles, billed per minute

Call Video Translator from your own code with one PopNow API key. Below are the exact model IDs to send, every input field the model accepts, what each request costs in USD, and a request you can paste into a terminal.

At a glance

Made by
PopNow
Output
Video
From
$0.005 USD per second of output

Prices are in USD, charged to your separate API wallet. A task reserves the maximum possible charge when accepted and settles actual usage on completion; any remainder is released. Failed tasks are not charged. Call POST /api/v1/jobs/quote for an exact quote before running.

Video Translator

popnow/video-translator-v1/video-translate

Price

OptionUSD
Default$0.005 per second of output

Parameters

FieldTypeDefaultAllowedWhat it does
video_urlRequiredstring——Clip to translate, 1 second to 10 minutes. The picture is kept; the returned clip carries the dubbed audio. Billed per started minute of this clip.
target_languageOptionalstringenen, es, fr, de, it, pt, nl, sv, da, no, fi, el, ru, pl, … (+14)Language to dub into. It must differ from the language spoken in the clip.
source_languageOptionalstringautoauto, en, zh-CN, zh-TW, yue, es, fr, de, it, pt, ru, ja, ko, ar, … (+88)Language spoken in the clip. auto detects it; set it when there is music under the voice, a heavy accent or long pauses.
clone_voiceOptionalbooleanfalse—Re-voice each speaker in a voice modelled on their own.
keep_background_audioOptionalbooleantrue—Keep the original music and sound effects under the dub; off returns the translated voices only.
speaker_countOptionalinteger—1, 2, 3, 4Number of people speaking, 1 to 4. Leave it out to detect it.
glossaryOptionalarray<object>—up to 100 itemsNames and phrases with a fixed translation, up to 100 pairs.

Example request

This request runs as it is; any field you leave out uses its default. Put your key in POPNOW_API_KEY first.

The example uses PopNow sample files in video_url. Replace them with your own public HTTPS links, uploads or saved assets.

POST /api/v1/jobs/createTask
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: $(uuidgen)" \
  -d '{
  "model": "popnow/video-translator-v1/video-translate",
  "input": {
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4"
  }
}'

The response carries a taskId straight away. Read the result with GET /api/v1/jobs/recordInfo, or add callBackUrl to be notified.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Next steps

On this page