curl --request POST \
--url https://api.vozo.ai/v1/media/translate \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"media_url": "<string>",
"source_language": "<string>",
"target_language": "<string>",
"subtitle_url": "<string>",
"subtitle_style_id": "<string>",
"subtitle_position_y": 0.5,
"ocr_text_box": {
"x": 0.5,
"y": 0.5,
"width": 0.5,
"height": 0.5
},
"speaker_number": {
"min": 2,
"max": 34
},
"glossary_ids": [
"<string>"
],
"align_video": true,
"enable_proofreading": true,
"user_prompt": "<string>",
"selected_voice_id": "<string>",
"callback_url": "<string>"
}
'import requests
url = "https://api.vozo.ai/v1/media/translate"
payload = {
"media_url": "<string>",
"source_language": "<string>",
"target_language": "<string>",
"subtitle_url": "<string>",
"subtitle_style_id": "<string>",
"subtitle_position_y": 0.5,
"ocr_text_box": {
"x": 0.5,
"y": 0.5,
"width": 0.5,
"height": 0.5
},
"speaker_number": {
"min": 2,
"max": 34
},
"glossary_ids": ["<string>"],
"align_video": True,
"enable_proofreading": True,
"user_prompt": "<string>",
"selected_voice_id": "<string>",
"callback_url": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
media_url: '<string>',
source_language: '<string>',
target_language: '<string>',
subtitle_url: '<string>',
subtitle_style_id: '<string>',
subtitle_position_y: 0.5,
ocr_text_box: {x: 0.5, y: 0.5, width: 0.5, height: 0.5},
speaker_number: {min: 2, max: 34},
glossary_ids: ['<string>'],
align_video: true,
enable_proofreading: true,
user_prompt: '<string>',
selected_voice_id: '<string>',
callback_url: '<string>'
})
};
fetch('https://api.vozo.ai/v1/media/translate', 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.vozo.ai/v1/media/translate",
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([
'media_url' => '<string>',
'source_language' => '<string>',
'target_language' => '<string>',
'subtitle_url' => '<string>',
'subtitle_style_id' => '<string>',
'subtitle_position_y' => 0.5,
'ocr_text_box' => [
'x' => 0.5,
'y' => 0.5,
'width' => 0.5,
'height' => 0.5
],
'speaker_number' => [
'min' => 2,
'max' => 34
],
'glossary_ids' => [
'<string>'
],
'align_video' => true,
'enable_proofreading' => true,
'user_prompt' => '<string>',
'selected_voice_id' => '<string>',
'callback_url' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.vozo.ai/v1/media/translate"
payload := strings.NewReader("{\n \"media_url\": \"<string>\",\n \"source_language\": \"<string>\",\n \"target_language\": \"<string>\",\n \"subtitle_url\": \"<string>\",\n \"subtitle_style_id\": \"<string>\",\n \"subtitle_position_y\": 0.5,\n \"ocr_text_box\": {\n \"x\": 0.5,\n \"y\": 0.5,\n \"width\": 0.5,\n \"height\": 0.5\n },\n \"speaker_number\": {\n \"min\": 2,\n \"max\": 34\n },\n \"glossary_ids\": [\n \"<string>\"\n ],\n \"align_video\": true,\n \"enable_proofreading\": true,\n \"user_prompt\": \"<string>\",\n \"selected_voice_id\": \"<string>\",\n \"callback_url\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
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.vozo.ai/v1/media/translate")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"media_url\": \"<string>\",\n \"source_language\": \"<string>\",\n \"target_language\": \"<string>\",\n \"subtitle_url\": \"<string>\",\n \"subtitle_style_id\": \"<string>\",\n \"subtitle_position_y\": 0.5,\n \"ocr_text_box\": {\n \"x\": 0.5,\n \"y\": 0.5,\n \"width\": 0.5,\n \"height\": 0.5\n },\n \"speaker_number\": {\n \"min\": 2,\n \"max\": 34\n },\n \"glossary_ids\": [\n \"<string>\"\n ],\n \"align_video\": true,\n \"enable_proofreading\": true,\n \"user_prompt\": \"<string>\",\n \"selected_voice_id\": \"<string>\",\n \"callback_url\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vozo.ai/v1/media/translate")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"media_url\": \"<string>\",\n \"source_language\": \"<string>\",\n \"target_language\": \"<string>\",\n \"subtitle_url\": \"<string>\",\n \"subtitle_style_id\": \"<string>\",\n \"subtitle_position_y\": 0.5,\n \"ocr_text_box\": {\n \"x\": 0.5,\n \"y\": 0.5,\n \"width\": 0.5,\n \"height\": 0.5\n },\n \"speaker_number\": {\n \"min\": 2,\n \"max\": 34\n },\n \"glossary_ids\": [\n \"<string>\"\n ],\n \"align_video\": true,\n \"enable_proofreading\": true,\n \"user_prompt\": \"<string>\",\n \"selected_voice_id\": \"<string>\",\n \"callback_url\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"task_id": "<string>"
}{
"code": "<string>",
"message": "<string>",
"serverTs": "<string>"
}Crear trabajo de Traducción y doblaje
Create a translate & dub job for video or audio media
curl --request POST \
--url https://api.vozo.ai/v1/media/translate \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"media_url": "<string>",
"source_language": "<string>",
"target_language": "<string>",
"subtitle_url": "<string>",
"subtitle_style_id": "<string>",
"subtitle_position_y": 0.5,
"ocr_text_box": {
"x": 0.5,
"y": 0.5,
"width": 0.5,
"height": 0.5
},
"speaker_number": {
"min": 2,
"max": 34
},
"glossary_ids": [
"<string>"
],
"align_video": true,
"enable_proofreading": true,
"user_prompt": "<string>",
"selected_voice_id": "<string>",
"callback_url": "<string>"
}
'import requests
url = "https://api.vozo.ai/v1/media/translate"
payload = {
"media_url": "<string>",
"source_language": "<string>",
"target_language": "<string>",
"subtitle_url": "<string>",
"subtitle_style_id": "<string>",
"subtitle_position_y": 0.5,
"ocr_text_box": {
"x": 0.5,
"y": 0.5,
"width": 0.5,
"height": 0.5
},
"speaker_number": {
"min": 2,
"max": 34
},
"glossary_ids": ["<string>"],
"align_video": True,
"enable_proofreading": True,
"user_prompt": "<string>",
"selected_voice_id": "<string>",
"callback_url": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
media_url: '<string>',
source_language: '<string>',
target_language: '<string>',
subtitle_url: '<string>',
subtitle_style_id: '<string>',
subtitle_position_y: 0.5,
ocr_text_box: {x: 0.5, y: 0.5, width: 0.5, height: 0.5},
speaker_number: {min: 2, max: 34},
glossary_ids: ['<string>'],
align_video: true,
enable_proofreading: true,
user_prompt: '<string>',
selected_voice_id: '<string>',
callback_url: '<string>'
})
};
fetch('https://api.vozo.ai/v1/media/translate', 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.vozo.ai/v1/media/translate",
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([
'media_url' => '<string>',
'source_language' => '<string>',
'target_language' => '<string>',
'subtitle_url' => '<string>',
'subtitle_style_id' => '<string>',
'subtitle_position_y' => 0.5,
'ocr_text_box' => [
'x' => 0.5,
'y' => 0.5,
'width' => 0.5,
'height' => 0.5
],
'speaker_number' => [
'min' => 2,
'max' => 34
],
'glossary_ids' => [
'<string>'
],
'align_video' => true,
'enable_proofreading' => true,
'user_prompt' => '<string>',
'selected_voice_id' => '<string>',
'callback_url' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.vozo.ai/v1/media/translate"
payload := strings.NewReader("{\n \"media_url\": \"<string>\",\n \"source_language\": \"<string>\",\n \"target_language\": \"<string>\",\n \"subtitle_url\": \"<string>\",\n \"subtitle_style_id\": \"<string>\",\n \"subtitle_position_y\": 0.5,\n \"ocr_text_box\": {\n \"x\": 0.5,\n \"y\": 0.5,\n \"width\": 0.5,\n \"height\": 0.5\n },\n \"speaker_number\": {\n \"min\": 2,\n \"max\": 34\n },\n \"glossary_ids\": [\n \"<string>\"\n ],\n \"align_video\": true,\n \"enable_proofreading\": true,\n \"user_prompt\": \"<string>\",\n \"selected_voice_id\": \"<string>\",\n \"callback_url\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
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.vozo.ai/v1/media/translate")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"media_url\": \"<string>\",\n \"source_language\": \"<string>\",\n \"target_language\": \"<string>\",\n \"subtitle_url\": \"<string>\",\n \"subtitle_style_id\": \"<string>\",\n \"subtitle_position_y\": 0.5,\n \"ocr_text_box\": {\n \"x\": 0.5,\n \"y\": 0.5,\n \"width\": 0.5,\n \"height\": 0.5\n },\n \"speaker_number\": {\n \"min\": 2,\n \"max\": 34\n },\n \"glossary_ids\": [\n \"<string>\"\n ],\n \"align_video\": true,\n \"enable_proofreading\": true,\n \"user_prompt\": \"<string>\",\n \"selected_voice_id\": \"<string>\",\n \"callback_url\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vozo.ai/v1/media/translate")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"media_url\": \"<string>\",\n \"source_language\": \"<string>\",\n \"target_language\": \"<string>\",\n \"subtitle_url\": \"<string>\",\n \"subtitle_style_id\": \"<string>\",\n \"subtitle_position_y\": 0.5,\n \"ocr_text_box\": {\n \"x\": 0.5,\n \"y\": 0.5,\n \"width\": 0.5,\n \"height\": 0.5\n },\n \"speaker_number\": {\n \"min\": 2,\n \"max\": 34\n },\n \"glossary_ids\": [\n \"<string>\"\n ],\n \"align_video\": true,\n \"enable_proofreading\": true,\n \"user_prompt\": \"<string>\",\n \"selected_voice_id\": \"<string>\",\n \"callback_url\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"task_id": "<string>"
}{
"code": "<string>",
"message": "<string>",
"serverTs": "<string>"
}Autorizaciones
Bearer authentication header of the form Bearer <api_key>, where <api_key> is your API Key. The token in the sample code is referring to this api_key as well.
Cuerpo
Media type of input: video or audio
video, audio Publicly accessible URL of input media (video/audio) for the server to download. Maximum supported input duration is 2 hours.
Source language code. Supports 'auto' or language codes such as en-US.
^(auto|[a-z]{2}(-[A-Za-z]{2})?)$Target language code. Locale is optional (e.g., en, en-US, zh, zh-CN). Only the language part is validated against the supported list.
^[a-z]{2}(-[A-Za-z]{2})?$Publicly accessible URL of subtitle file (SRT only). Server will download and validate timestamps (non-overlap, start<=end, within media duration, total <=2h). Mutually exclusive with ocr_text_box.
Whether the provided subtitle is original or final translated
original, final_translated Subtitle rendering mode. none: do not render subtitles; add: add subtitles to the output; replace: erase existing subtitles from the video, then render new subtitles.
none, add, replace Subtitle style ID copied from a project in the Vozo web.
Vertical subtitle position in normalized coordinates, from 0 (top) to 1 (bottom). For example, 0.75 places subtitles at 75% of the video height. When omitted, the position does not come from subtitle_style_id: for subtitle_mode=add, it defaults to 0.9 for landscape and square videos and 0.75 for portrait videos; for subtitle_mode=replace, subtitles are placed at the original subtitle position. When enable_proofreading=true and subtitle_mode=replace, this field is ignored: after project dubbing is completed, the subtitle position remains at the region where the original subtitles were erased.
0 <= x <= 1OCR text region in normalized coordinates [0–1], origin at top-left. Only applicable when media_type=video. Mutually exclusive with subtitle_url.
Show child attributes
Show child attributes
Controls whether an editable project is created in the web dashboard. editable creates an editable project; none skips creating an editable project and only outputs the translated result.
none, editable Specify speaker count range or leave empty for auto
Show child attributes
Show child attributes
List of glossary IDs from the product. Each ID refers to a predefined glossary that can be copied from the glossary management interface. These glossaries will be applied during translation to ensure consistent terminology.
3Optional. Whether to automatically adjust the video speed to align with the translated audio duration.
Optional. Whether to enable the proofreading workflow. When enabled, no final media will be exported regardless of export_type, and project_mode will be ignored. A project will always be created in the product for proofreading. When enabled with subtitle_mode=replace, subtitle_position_y is ignored: after project dubbing is completed, the subtitle position remains at the region where the original subtitles were erased.
Optional. Which voice cloning model to use for cloning.
auto, real, native Optional translation or dubbing prompt to guide style
Output type. auto: match input type; video: output video; audio: output audio; all: both video and audio. When media_type=audio, export_type cannot be video or all.
auto, video, audio, all Optional. The ID of the voice to use for dubbing. When specified, this voice will be used instead of cloning a voice.
Webhook callback URL for status changes
Respuesta
Job queued
ID of the task
¿Esta página le ayudó?