Create translate and dub job

curl --request POST \
  --url https://api.vmeg.ai/openapi/v1/task/media-translation/create-async \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency-Key: <x-idempotency-key>' \
  --data '
{
  "source": {
    "materialId": "<string>"
  },
  "language": {
    "target": "zh-CN",
    "source": "auto"
  },
  "options": {
    "voiceClone": {
      "style": "emotional",
      "mode": "role"
    },
    "transcribe": {
      "mode": "fast",
      "type": "default"
    },
    "translate": {
      "mode": "default",
      "prompt": "<string>"
    },
    "separation": {
      "mode": "auto"
    },
    "dynamicVideoLength": {
      "enable": true
    },
    "lipsync": {
      "enable": false
    },
    "text": {},
    "voiceSpeakers": {
      "selectedVoicesList": [
        {
          "provider": "S1",
          "voiceId": "<string>"
        }
      ],
      "speakerNum": "auto",
      "timbreMethod": "clone"
    }
  },
  "extraData": {}
}
'

import requests

url = "https://api.vmeg.ai/openapi/v1/task/media-translation/create-async"

payload = {
    "source": { "materialId": "<string>" },
    "language": {
        "target": "zh-CN",
        "source": "auto"
    },
    "options": {
        "voiceClone": {
            "style": "emotional",
            "mode": "role"
        },
        "transcribe": {
            "mode": "fast",
            "type": "default"
        },
        "translate": {
            "mode": "default",
            "prompt": "<string>"
        },
        "separation": { "mode": "auto" },
        "dynamicVideoLength": { "enable": True },
        "lipsync": { "enable": False },
        "text": {},
        "voiceSpeakers": {
            "selectedVoicesList": [
                {
                    "provider": "S1",
                    "voiceId": "<string>"
                }
            ],
            "speakerNum": "auto",
            "timbreMethod": "clone"
        }
    },
    "extraData": {}
}
headers = {
    "X-Idempotency-Key": "<x-idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-Idempotency-Key': '<x-idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    source: {materialId: '<string>'},
    language: {target: 'zh-CN', source: 'auto'},
    options: {
      voiceClone: {style: 'emotional', mode: 'role'},
      transcribe: {mode: 'fast', type: 'default'},
      translate: {mode: 'default', prompt: '<string>'},
      separation: {mode: 'auto'},
      dynamicVideoLength: {enable: true},
      lipsync: {enable: false},
      text: {},
      voiceSpeakers: {
        selectedVoicesList: [{provider: 'S1', voiceId: '<string>'}],
        speakerNum: 'auto',
        timbreMethod: 'clone'
      }
    },
    extraData: {}
  })
};

fetch('https://api.vmeg.ai/openapi/v1/task/media-translation/create-async', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.vmeg.ai/openapi/v1/task/media-translation/create-async",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'source' => [
        'materialId' => '<string>'
    ],
    'language' => [
        'target' => 'zh-CN',
        'source' => 'auto'
    ],
    'options' => [
        'voiceClone' => [
                'style' => 'emotional',
                'mode' => 'role'
        ],
        'transcribe' => [
                'mode' => 'fast',
                'type' => 'default'
        ],
        'translate' => [
                'mode' => 'default',
                'prompt' => '<string>'
        ],
        'separation' => [
                'mode' => 'auto'
        ],
        'dynamicVideoLength' => [
                'enable' => true
        ],
        'lipsync' => [
                'enable' => false
        ],
        'text' => [
                
        ],
        'voiceSpeakers' => [
                'selectedVoicesList' => [
                                [
                                                                'provider' => 'S1',
                                                                'voiceId' => '<string>'
                                ]
                ],
                'speakerNum' => 'auto',
                'timbreMethod' => 'clone'
        ]
    ],
    'extraData' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "X-Idempotency-Key: <x-idempotency-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.vmeg.ai/openapi/v1/task/media-translation/create-async"

	payload := strings.NewReader("{\n  \"source\": {\n    \"materialId\": \"<string>\"\n  },\n  \"language\": {\n    \"target\": \"zh-CN\",\n    \"source\": \"auto\"\n  },\n  \"options\": {\n    \"voiceClone\": {\n      \"style\": \"emotional\",\n      \"mode\": \"role\"\n    },\n    \"transcribe\": {\n      \"mode\": \"fast\",\n      \"type\": \"default\"\n    },\n    \"translate\": {\n      \"mode\": \"default\",\n      \"prompt\": \"<string>\"\n    },\n    \"separation\": {\n      \"mode\": \"auto\"\n    },\n    \"dynamicVideoLength\": {\n      \"enable\": true\n    },\n    \"lipsync\": {\n      \"enable\": false\n    },\n    \"text\": {},\n    \"voiceSpeakers\": {\n      \"selectedVoicesList\": [\n        {\n          \"provider\": \"S1\",\n          \"voiceId\": \"<string>\"\n        }\n      ],\n      \"speakerNum\": \"auto\",\n      \"timbreMethod\": \"clone\"\n    }\n  },\n  \"extraData\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Idempotency-Key", "<x-idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.vmeg.ai/openapi/v1/task/media-translation/create-async")
  .header("X-Idempotency-Key", "<x-idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"source\": {\n    \"materialId\": \"<string>\"\n  },\n  \"language\": {\n    \"target\": \"zh-CN\",\n    \"source\": \"auto\"\n  },\n  \"options\": {\n    \"voiceClone\": {\n      \"style\": \"emotional\",\n      \"mode\": \"role\"\n    },\n    \"transcribe\": {\n      \"mode\": \"fast\",\n      \"type\": \"default\"\n    },\n    \"translate\": {\n      \"mode\": \"default\",\n      \"prompt\": \"<string>\"\n    },\n    \"separation\": {\n      \"mode\": \"auto\"\n    },\n    \"dynamicVideoLength\": {\n      \"enable\": true\n    },\n    \"lipsync\": {\n      \"enable\": false\n    },\n    \"text\": {},\n    \"voiceSpeakers\": {\n      \"selectedVoicesList\": [\n        {\n          \"provider\": \"S1\",\n          \"voiceId\": \"<string>\"\n        }\n      ],\n      \"speakerNum\": \"auto\",\n      \"timbreMethod\": \"clone\"\n    }\n  },\n  \"extraData\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.vmeg.ai/openapi/v1/task/media-translation/create-async")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Idempotency-Key"] = '<x-idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"source\": {\n    \"materialId\": \"<string>\"\n  },\n  \"language\": {\n    \"target\": \"zh-CN\",\n    \"source\": \"auto\"\n  },\n  \"options\": {\n    \"voiceClone\": {\n      \"style\": \"emotional\",\n      \"mode\": \"role\"\n    },\n    \"transcribe\": {\n      \"mode\": \"fast\",\n      \"type\": \"default\"\n    },\n    \"translate\": {\n      \"mode\": \"default\",\n      \"prompt\": \"<string>\"\n    },\n    \"separation\": {\n      \"mode\": \"auto\"\n    },\n    \"dynamicVideoLength\": {\n      \"enable\": true\n    },\n    \"lipsync\": {\n      \"enable\": false\n    },\n    \"text\": {},\n    \"voiceSpeakers\": {\n      \"selectedVoicesList\": [\n        {\n          \"provider\": \"S1\",\n          \"voiceId\": \"<string>\"\n        }\n      ],\n      \"speakerNum\": \"auto\",\n      \"timbreMethod\": \"clone\"\n    }\n  },\n  \"extraData\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "code": 200,
  "message": "",
  "data": {
    "taskId": "<string>",
    "taskType": "vt",
    "status": "running",
    "createdAt": "<string>"
  }
}

Video & audio translate and dub

Create translate and dub job

Start an async translate and dub pipeline for uploaded video or audio: transcribe speech → translate script → generate AI dubbing (voice clone or presets) → render dubbed output. Optional subtitles and lip sync via options. The HTTP response only confirms acceptance (taskId). Dubbed video/audio URLs arrive in your Webhook callback (event: openapi-media-translation).

If you request audio translation (taskType: at) but the material is video, the server may run video translation (vt) instead — check taskType in the acceptance response.

POST

openapi

task

media-translation

create-async

Create translate and dub job

curl --request POST \
  --url https://api.vmeg.ai/openapi/v1/task/media-translation/create-async \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency-Key: <x-idempotency-key>' \
  --data '
{
  "source": {
    "materialId": "<string>"
  },
  "language": {
    "target": "zh-CN",
    "source": "auto"
  },
  "options": {
    "voiceClone": {
      "style": "emotional",
      "mode": "role"
    },
    "transcribe": {
      "mode": "fast",
      "type": "default"
    },
    "translate": {
      "mode": "default",
      "prompt": "<string>"
    },
    "separation": {
      "mode": "auto"
    },
    "dynamicVideoLength": {
      "enable": true
    },
    "lipsync": {
      "enable": false
    },
    "text": {},
    "voiceSpeakers": {
      "selectedVoicesList": [
        {
          "provider": "S1",
          "voiceId": "<string>"
        }
      ],
      "speakerNum": "auto",
      "timbreMethod": "clone"
    }
  },
  "extraData": {}
}
'

import requests

url = "https://api.vmeg.ai/openapi/v1/task/media-translation/create-async"

payload = {
    "source": { "materialId": "<string>" },
    "language": {
        "target": "zh-CN",
        "source": "auto"
    },
    "options": {
        "voiceClone": {
            "style": "emotional",
            "mode": "role"
        },
        "transcribe": {
            "mode": "fast",
            "type": "default"
        },
        "translate": {
            "mode": "default",
            "prompt": "<string>"
        },
        "separation": { "mode": "auto" },
        "dynamicVideoLength": { "enable": True },
        "lipsync": { "enable": False },
        "text": {},
        "voiceSpeakers": {
            "selectedVoicesList": [
                {
                    "provider": "S1",
                    "voiceId": "<string>"
                }
            ],
            "speakerNum": "auto",
            "timbreMethod": "clone"
        }
    },
    "extraData": {}
}
headers = {
    "X-Idempotency-Key": "<x-idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-Idempotency-Key': '<x-idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    source: {materialId: '<string>'},
    language: {target: 'zh-CN', source: 'auto'},
    options: {
      voiceClone: {style: 'emotional', mode: 'role'},
      transcribe: {mode: 'fast', type: 'default'},
      translate: {mode: 'default', prompt: '<string>'},
      separation: {mode: 'auto'},
      dynamicVideoLength: {enable: true},
      lipsync: {enable: false},
      text: {},
      voiceSpeakers: {
        selectedVoicesList: [{provider: 'S1', voiceId: '<string>'}],
        speakerNum: 'auto',
        timbreMethod: 'clone'
      }
    },
    extraData: {}
  })
};

fetch('https://api.vmeg.ai/openapi/v1/task/media-translation/create-async', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.vmeg.ai/openapi/v1/task/media-translation/create-async",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'source' => [
        'materialId' => '<string>'
    ],
    'language' => [
        'target' => 'zh-CN',
        'source' => 'auto'
    ],
    'options' => [
        'voiceClone' => [
                'style' => 'emotional',
                'mode' => 'role'
        ],
        'transcribe' => [
                'mode' => 'fast',
                'type' => 'default'
        ],
        'translate' => [
                'mode' => 'default',
                'prompt' => '<string>'
        ],
        'separation' => [
                'mode' => 'auto'
        ],
        'dynamicVideoLength' => [
                'enable' => true
        ],
        'lipsync' => [
                'enable' => false
        ],
        'text' => [
                
        ],
        'voiceSpeakers' => [
                'selectedVoicesList' => [
                                [
                                                                'provider' => 'S1',
                                                                'voiceId' => '<string>'
                                ]
                ],
                'speakerNum' => 'auto',
                'timbreMethod' => 'clone'
        ]
    ],
    'extraData' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "X-Idempotency-Key: <x-idempotency-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.vmeg.ai/openapi/v1/task/media-translation/create-async"

	payload := strings.NewReader("{\n  \"source\": {\n    \"materialId\": \"<string>\"\n  },\n  \"language\": {\n    \"target\": \"zh-CN\",\n    \"source\": \"auto\"\n  },\n  \"options\": {\n    \"voiceClone\": {\n      \"style\": \"emotional\",\n      \"mode\": \"role\"\n    },\n    \"transcribe\": {\n      \"mode\": \"fast\",\n      \"type\": \"default\"\n    },\n    \"translate\": {\n      \"mode\": \"default\",\n      \"prompt\": \"<string>\"\n    },\n    \"separation\": {\n      \"mode\": \"auto\"\n    },\n    \"dynamicVideoLength\": {\n      \"enable\": true\n    },\n    \"lipsync\": {\n      \"enable\": false\n    },\n    \"text\": {},\n    \"voiceSpeakers\": {\n      \"selectedVoicesList\": [\n        {\n          \"provider\": \"S1\",\n          \"voiceId\": \"<string>\"\n        }\n      ],\n      \"speakerNum\": \"auto\",\n      \"timbreMethod\": \"clone\"\n    }\n  },\n  \"extraData\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Idempotency-Key", "<x-idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.vmeg.ai/openapi/v1/task/media-translation/create-async")
  .header("X-Idempotency-Key", "<x-idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"source\": {\n    \"materialId\": \"<string>\"\n  },\n  \"language\": {\n    \"target\": \"zh-CN\",\n    \"source\": \"auto\"\n  },\n  \"options\": {\n    \"voiceClone\": {\n      \"style\": \"emotional\",\n      \"mode\": \"role\"\n    },\n    \"transcribe\": {\n      \"mode\": \"fast\",\n      \"type\": \"default\"\n    },\n    \"translate\": {\n      \"mode\": \"default\",\n      \"prompt\": \"<string>\"\n    },\n    \"separation\": {\n      \"mode\": \"auto\"\n    },\n    \"dynamicVideoLength\": {\n      \"enable\": true\n    },\n    \"lipsync\": {\n      \"enable\": false\n    },\n    \"text\": {},\n    \"voiceSpeakers\": {\n      \"selectedVoicesList\": [\n        {\n          \"provider\": \"S1\",\n          \"voiceId\": \"<string>\"\n        }\n      ],\n      \"speakerNum\": \"auto\",\n      \"timbreMethod\": \"clone\"\n    }\n  },\n  \"extraData\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.vmeg.ai/openapi/v1/task/media-translation/create-async")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Idempotency-Key"] = '<x-idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"source\": {\n    \"materialId\": \"<string>\"\n  },\n  \"language\": {\n    \"target\": \"zh-CN\",\n    \"source\": \"auto\"\n  },\n  \"options\": {\n    \"voiceClone\": {\n      \"style\": \"emotional\",\n      \"mode\": \"role\"\n    },\n    \"transcribe\": {\n      \"mode\": \"fast\",\n      \"type\": \"default\"\n    },\n    \"translate\": {\n      \"mode\": \"default\",\n      \"prompt\": \"<string>\"\n    },\n    \"separation\": {\n      \"mode\": \"auto\"\n    },\n    \"dynamicVideoLength\": {\n      \"enable\": true\n    },\n    \"lipsync\": {\n      \"enable\": false\n    },\n    \"text\": {},\n    \"voiceSpeakers\": {\n      \"selectedVoicesList\": [\n        {\n          \"provider\": \"S1\",\n          \"voiceId\": \"<string>\"\n        }\n      ],\n      \"speakerNum\": \"auto\",\n      \"timbreMethod\": \"clone\"\n    }\n  },\n  \"extraData\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "code": 200,
  "message": "",
  "data": {
    "taskId": "<string>",
    "taskType": "vt",
    "status": "running",
    "createdAt": "<string>"
  }
}

Authorizations

Authorization

string

header

required

Send your API Key in the Authorization header (Bearer <api_key>). See Authentication.

Headers

X-Idempotency-Key

string

required

Required on mutating POST requests that create tasks or change persisted data (max 64 characters). See Idempotency.

Maximum string length: 64

Body

application/json

taskType

enum<string>

required

vt = video translation, at = audio translation. If at is used with a video material, the job may run as video translation

Available options:

vt,

at

source

object

required

Input material for this translation job

Show child attributes

language

object

required

Source and target locales for localization

Show child attributes

options

object

required

Pipeline options: dubbing, ASR, translation, separation, lip sync, and captions

Show child attributes

extraData

object

Optional client metadata; echoed in the completion webhook

Callbacks

POST

https://{yourWebhookUrl}taskCompleted

Body

application/json

Webhook callback request body for Media translation when event is openapi-media-translation. data.result with CDN deliverables. See Webhook request body and Create media translation (async) → Callbacks.

data

object

required

Task payload inside webhook data when event is openapi-media-translation. data.result with CDN deliverables.

Show child attributes

code

integer

Business outcome for this delivery

Example:

200

version

string

API version of the task (e.g. v1, v2). Matches the version in the request path (/openapi/v1/...).

Example:

"v1"

event

enum<string>

Which product completed. Route your handler by this value: openapi-tts (TTS), openapi-translate (text translation), openapi-clone-voice (voice clone), openapi-media-translation (media translation). Listed in Webhook request body.

Available options:

openapi-tts,

openapi-translate,

openapi-clone-voice,

openapi-media-translation

Example:

"openapi-tts"

pipelineKey

string

Stable ID for this async completion. Deduplicate webhook handling by this value — see Webhook request body.

Example:

"a1b2c3d4e5f6789012345678901234ab"

message

string

Detail when code is not success

extraData

object

Echo of extraData from your async submit request

Response

200

Return 2xx promptly to stop retries

Response

200 - application/json

Acceptance only (taskId, taskType, status, createdAt). Final results are in the Webhook callback request body.

code

integer

required

Business code; 200 means success

Example:

200

message

string

Human-readable detail when code is not success

Example:

""

data

object

Immediate response for media translation async create (no deliverables)

Show child attributes

Clone voice from sample audio (async)List API jobs

Overview

Endpoints

Create translate and dub job

Authorizations

Headers

Body

Callbacks

Body

Response

Response