Skip to main content
POST
/
api
/
open
/
v3
/
content
/
video
/
createbytranslate
Create Video Translation
curl --request POST \
  --url https://openapi.akool.com/api/open/v3/content/video/createbytranslate \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "url": "https://d11fbe263bhqij.cloudfront.net/agicontent/video/translate/cut3_content_create_EN_01.mp4",
  "language": "ja,zh-CN-shandong,zh-CN-sichuan",
  "source_language": "en",
  "lipsync": false,
  "speaker_num": 1,
  "webhookUrl": "",
  "remove_bgm": true,
  "caption_type": 2,
  "caption_url": "https://drz0f01yeq1cx.cloudfront.net/1759979948074-b14aeb874a4547ca81373d140edd02d2-1758273867083fa8fa1ca7cfe409ab7fb07abdb931660translatedsubtitles.srt",
  "studio_voice": {
    "no_translate_words": [
      "kaka",
      "lal"
    ],
    "fixed_words": {
      "hi": "hello",
      "bad": "good"
    },
    "pronounced_words": {
      "lel": "lele",
      "gga": "gaga"
    },
    "style": "professional"
  },
  "dynamic_duration": false
}'
{
  "code": 123,
  "msg": "<string>",
  "data": {
    "_id": "<string>",
    "video_status": 123,
    "video": "<string>"
  }
}
Create a video translation job to translate your video content into one or multiple target languages. The API supports automatic source language detection, custom AI voices, lip-sync, and various caption options.
The merge_interval and face_enhance parameters have been deprecated and are no longer supported.

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
url
string
required

The video URL address you want to translate

​
language
string
required

Target language(s) for translation. For multiple languages, separate with commas (e.g., "ja,zh-CN-shandong,zh-CN-sichuan")

​
source_language
string
default:DEFAULT

The original language of the video. Use "DEFAULT" for automatic language detection, or specify a language code (e.g., "en" for English, "zh" for Chinese, "es" for Spanish)

​
lipsync
boolean
default:false

Enable synchronized mouth movements with the audio track in translated video

​
webhookUrl
string

Callback URL address for HTTP notifications when processing completes

​
speaker_num
integer
default:0

Number of speakers in the video (0 = Auto Detect)

​
remove_bgm
boolean
default:false

Whether to remove background music from the video

​
caption_type
enum<integer>
default:0

Caption handling: 0=none, 1=add original subtitle, 2=add target subtitle, 3=translate and replace original subtitle, 4=add translated subtitle

Available options:
0,
1,
2,
3,
4
​
caption_url
string

Subtitle file URL (supports SRT or ASS files)

​
studio_voice
object

Advanced voice and translation settings

​
dynamic_duration
boolean
default:false

Control the dynamic duration of the video

Response

200 - application/json

Video translation request submitted successfully

​
code
integer

Business status code (1000 = success)

​
msg
string

Status message

​
data
object