2.1 Video Synthesis (Create Task)

POST https://techhk.aoscdn.com/api/tasks/media/video-translation/export

Request Params

url * string

File URL: The file URL must be a valid HTTP URL. If the URL lacks a file extension, specify the extension parameter (e.g., extension=mp3). The maximum length is 512 characters. The download timeout is 5 minutes (failure if not completed in that time). The file duration is 3 hours and size is 4GB.
language * string

Voice Language (based on the selected mode)
You can find the specific languages in the table below.
voice_mode * int

Mode (Voice Library)
1: Classic Voice
2: Extended Voice
voice * string

Voice: Default is Xiaoyun
*Voices are matched based on the selected language. Click to view the .
subtitles * array

Subtitles
- start * int
  
  Segment start time in milliseconds
- end * int
  
  Segment end time in milliseconds
- text * string
  
  Recognized text content
enable_subtitle int

Generate subtitles? 0 - No, 1 - Yes (default)
subtitle_style object

Subtitle style
- alignment int
  
  Alignment: 0 - Left, 2 - Center (default), 3 - Right
- backcolor string
  
  Background color (rgba): Default black, 80% opacity (0,0,0,0.8)
- enable_bg bool
  
  Enable background: true (enabled, default), false (disabled)
- enable_stroke bool
  
  Enable text outline: true (enabled), false (disabled, default)
- font int
  
  Font Type ID: Options: 0-andalemo (default), 1-open sans, 2-comic, 3-impat, 4-times new roman, 5-SimSun, 6-SimHei, 7-KaiTi, 8-LiShu, 9-Microsoft YaHei
- font_bold bool
  
  Bold text: true (enabled), false (disabled, default)
- font_color string
  
  Font color (rgba), default pure white and opaque (255,255,255,1)
- font_italic bool
  
  Italic text: true (enabled), false (disabled, default)
- font_size int
  
  Font size: unit in pixels, default 20
- font_underline bool
  
  Underline: true (enabled), false (disabled, default)
- stroke_color string
  
  Outline color (rgba), default pure white and opaque (255,255,255,1)
- stroke_width int
  
  Outline width: unit in pixels, default 0
- vertical_position int
  
  Bottom vertical distance: unit in pixels, default 0
volume int

Volume: Range is 0-100, default is 50
filename string

Export file name
extension string

File Extension: Required if the URL path lacks a file extension.

Response Params

task_id string

Task ID: Required for subsequent progress queries.

curl --location 'https://techsz.aoscdn.com/api/tasks/media/video-translation/export' \ --header 'TaskSource: ApiKey' \ --header 'Content-Type: application/json' \ --header 'x-api-key: {YOUR-API-KEY}' \ --data '{ "url": "https://xxx.mp4", "voice": "XiaoxiaoMultilingual", "voice_mode": 2, "volume": 100, "subtitles": [ { "start": 0, "end": 2880, "text": "如何在极短的时间了解5000年历史" }, { "start": 2880, "end": 5360, "text": "40分钟浓缩精华版的中国历史" } ], "enable_subtitle": 1, "subtitle_styles": { "alignment": 2, "backcolor": "0,0,0,0.8", "enable_bg": true, "enable_stroke": false, "font": 9, "font_bold": false, "font_color": "255,255,255,1", "font_italic": false, "font_size": 54, "font_underline": false, "stroke_color": "255,255,255,1", "stroke_width": 0, "vertical_position": 5 } }'

using System; using System.IO; using System.Net; using System.Text; using System.Threading.Tasks; class Program { static async Task Main() => await SendRequest(); static async Task SendRequest() { string url = "https://techsz.aoscdn.com/api/tasks/media/video-translation/export"; try { var request = (HttpWebRequest)WebRequest.Create(url); request.Method = "POST"; request.Headers["TaskSource"] = "ApiKey"; request.Headers["Content-Type"] = request.ContentType = "application/json"; request.Headers["x-api-key"] = "{YOUR-API-KEY}"; string jsonData = @"{ ""url"": ""https://xxx.mp4"", ""voice"": ""XiaoxiaoMultilingual"", ""voice_mode"": 2, ""volume"": 100, ""subtitles"": [ { ""start"": 0, ""end"": 2880, ""text"": ""如何在极短的时间了解5000年历史"" }, { ""start"": 2880, ""end"": 5360, ""text"": ""40分钟浓缩精华版的中国历史"" } ], ""enable_subtitle"": 1, ""subtitle_styles"": { ""alignment"": 2, ""backcolor"": ""0,0,0,0.8"", ""enable_bg"": true, ""enable_stroke"": false, ""font"": 9, ""font_bold"": false, ""font_color"": ""255,255,255,1"", ""font_italic"": false, ""font_size"": 54, ""font_underline"": false, ""stroke_color"": ""255,255,255,1"", ""stroke_width"": 0, ""vertical_position"": 5 } }"; byte[] byteArray = Encoding.UTF8.GetBytes(jsonData); request.ContentLength = byteArray.Length; using (var requestStream = request.GetRequestStream()) await requestStream.WriteAsync(byteArray, 0, byteArray.Length); using (var response = await request.GetResponseAsync()) using (var responseStream = response.GetResponseStream()) using (var reader = new StreamReader(responseStream)) Console.WriteLine(await reader.ReadToEndAsync()); } catch (WebException e) { Console.WriteLine($"Request failed: {e.Message}"); if (e.Response != null) { using (var errorStream = e.Response.GetResponseStream()) using (var reader = new StreamReader(errorStream)) Console.WriteLine($"Error details: {await reader.ReadToEndAsync()}"); } } catch (Exception e) { Console.WriteLine($"An error occurred: {e.Message}"); } } }

import java.io.*; import java.net.*; import java.nio.charset.StandardCharsets; public class ApiRequest { public static void main(String[] args) { try { URL url = new URL("https://techsz.aoscdn.com/api/tasks/media/video-translation/export"); HttpURLConnection connection = (HttpURLConnection) url.openConnection(); connection.setRequestMethod("POST"); connection.setRequestProperty("TaskSource", "ApiKey"); connection.setRequestProperty("Content-Type", "application/json"); connection.setRequestProperty("x-api-key", "{YOUR-API-KEY}"); connection.setDoOutput(true); String jsonData = "{" + "\"url\": \"https://xxx.mp4\"," + "\"voice\": \"XiaoxiaoMultilingual\"," + "\"voice_mode\": 2," + "\"volume\": 100," + "\"subtitles\": [" + " {" + " \"start\": 0," + " \"end\": 2880," + " \"text\": \"如何在极短的时间了解5000年历史\"" + " }," + " {" + " \"start\": 2880," + " \"end\": 5360," + " \"text\": \"40分钟浓缩精华版的中国历史\"" + " }" + "]," + "\"enable_subtitle\": 1," + "\"subtitle_styles\": {" + " \"alignment\": 2," + " \"backcolor\": \"0,0,0,0.8\"," + " \"enable_bg\": true," + " \"enable_stroke\": false," + " \"font\": 9," + " \"font_bold\": false," + " \"font_color\": \"255,255,255,1\"," + " \"font_italic\": false," + " \"font_size\": 54," + " \"font_underline\": false," + " \"stroke_color\": \"255,255,255,1\"," + " \"stroke_width\": 0," + " \"vertical_position\": 5" + "}" + "}"; try (OutputStream os = connection.getOutputStream()) { os.write(jsonData.getBytes(StandardCharsets.UTF_8)); } int statusCode = connection.getResponseCode(); System.out.println("Response status code: " + statusCode); try (BufferedReader br = new BufferedReader( new InputStreamReader(connection.getInputStream(), StandardCharsets.UTF_8))) { StringBuilder response = new StringBuilder(); String line; while ((line = br.readLine()) != null) response.append(line); System.out.println("Response content: " + response); } } catch (Exception e) { System.out.println("Request failed: " + e.getMessage()); e.printStackTrace(); } } }

async function sendRequest() { const url = "https://techsz.aoscdn.com/api/tasks/media/video-translation/export"; const headers = { "TaskSource": "ApiKey", "Content-Type": "application/json", "x-api-key": "{YOUR-API-KEY}" }; const requestData = { "url": "https://xxx.mp4", "voice": "XiaoxiaoMultilingual", "voice_mode": 2, "volume": 100, "subtitles": [ { "start": 0, "end": 2880, "text": "如何在极短的时间了解5000年历史" }, { "start": 2880, "end": 5360, "text": "40分钟浓缩精华版的中国历史" } ], "enable_subtitle": 1, "subtitle_styles": { "alignment": 2, "backcolor": "0,0,0,0.8", "enable_bg": true, "enable_stroke": false, "font": 9, "font_bold": false, "font_color": "255,255,255,1", "font_italic": false, "font_size": 54, "font_underline": false, "stroke_color": "255,255,255,1", "stroke_width": 0, "vertical_position": 5 } }; try { const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(requestData) }); console.log(await response.json()); } catch (error) { console.error("Request failed:", error); } } sendRequest();

import json, urllib.request url = "https://techsz.aoscdn.com/api/tasks/media/video-translation/export" headers = { "TaskSource": "ApiKey", "Content-Type": "application/json", "x-api-key": "{YOUR-API-KEY}" } request_data = { "url": "https://xxx.mp4", "voice": "XiaoxiaoMultilingual", "voice_mode": 2, "volume": 100, "subtitles": [ { "start": 0, "end": 2880, "text": "如何在极短的时间了解5000年历史" }, { "start": 2880, "end": 5360, "text": "40分钟浓缩精华版的中国历史" } ], "enable_subtitle": 1, "subtitle_styles": { "alignment": 2, "backcolor": "0,0,0,0.8", "enable_bg": True, "enable_stroke": False, "font": 9, "font_bold": False, "font_color": "255,255,255,1", "font_italic": False, "font_size": 54, "font_underline": False, "stroke_color": "255,255,255,1", "stroke_width": 0, "vertical_position": 5 } } req = urllib.request.Request( url=url, data=json.dumps(request_data).encode('utf-8'), headers=headers, method="POST" ) try: with urllib.request.urlopen(req) as response: result = json.loads(response.read().decode('utf-8')) print(result) except Exception as e: print(f"Request failed: {e}")

import Foundation func sendRequest() { guard let url = URL(string: "https://techsz.aoscdn.com/api/tasks/media/video-translation/export") else { print("Invalid URL") return } var request = URLRequest(url: url) request.httpMethod = "POST" request.addValue("ApiKey", forHTTPHeaderField: "TaskSource") request.addValue("application/json", forHTTPHeaderField: "Content-Type") request.addValue("{YOUR-API-KEY}", forHTTPHeaderField: "x-api-key") let requestData: [String: Any] = [ "url": "https://xxx.mp4", "voice": "XiaoxiaoMultilingual", "voice_mode": 2, "volume": 100, "subtitles": [ [ "start": 0, "end": 2880, "text": "如何在极短的时间了解5000年历史" ], [ "start": 2880, "end": 5360, "text": "40分钟浓缩精华版的中国历史" ] ], "enable_subtitle": 1, "subtitle_styles": [ "alignment": 2, "backcolor": "0,0,0,0.8", "enable_bg": true, "enable_stroke": false, "font": 9, "font_bold": false, "font_color": "255,255,255,1", "font_italic": false, "font_size": 54, "font_underline": false, "stroke_color": "255,255,255,1", "stroke_width": 0, "vertical_position": 5 ] ] do { request.httpBody = try JSONSerialization.data(withJSONObject: requestData) URLSession.shared.dataTask(with: request) { data, response, error in if let error = error { print("Request failed: \(error)") return } guard let data = data else { print("No data returned") return } do { if let result = try JSONSerialization.jsonObject(with: data) as? [String: Any] { print(result) } } catch { print("JSON parsing error: \(error)") } }.resume() } catch { print("JSON encoding error: \(error)") } } sendRequest();

package main import ( "bytes" "encoding/json" "fmt" "io/ioutil" "net/http" ) func main() { url := "https://techsz.aoscdn.com/api/tasks/media/video-translation/export" subtitles := []map[string]interface{}{ { "start": 0, "end": 2880, "text": "如何在极短的时间了解5000年历史", }, { "start": 2880, "end": 5360, "text": "40分钟浓缩精华版的中国历史", }, } subtitleStyles := map[string]interface{}{ "alignment": 2, "backcolor": "0,0,0,0.8", "enable_bg": true, "enable_stroke": false, "font": 9, "font_bold": false, "font_color": "255,255,255,1", "font_italic": false, "font_size": 54, "font_underline": false, "stroke_color": "255,255,255,1", "stroke_width": 0, "vertical_position": 5, } requestData := map[string]interface{}{ "url": "https://xxx.mp4", "voice": "XiaoxiaoMultilingual", "voice_mode": 2, "volume": 100, "subtitles": subtitles, "enable_subtitle": 1, "subtitle_styles": subtitleStyles, } jsonData, err := json.Marshal(requestData) if err != nil { fmt.Println("JSON encoding error:", err) return } req, err := http.NewRequest("POST", url, bytes.NewBuffer(jsonData)) if err != nil { fmt.Println("Error creating request:", err) return } req.Header.Set("TaskSource", "ApiKey") req.Header.Set("Content-Type", "application/json") req.Header.Set("x-api-key", "{YOUR-API-KEY}") client := &http.Client{} resp, err := client.Do(req) if err != nil { fmt.Println("Error sending request:", err) return } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err != nil { fmt.Println("Error reading response:", err) return } var result interface{} err = json.Unmarshal(body, &result) if err != nil { fmt.Println("JSON parsing error:", err) return } fmt.Println(result) }

import 'dart:convert'; import 'dart:io'; Future<void> main() async { final url = Uri.parse("https://techsz.aoscdn.com/api/tasks/media/video-translation/export"); final headers = { 'TaskSource': 'ApiKey', 'Content-Type': 'application/json', 'x-api-key': '{YOUR-API-KEY}' }; final requestData = { 'url': 'https://xxx.mp4', 'voice': 'XiaoxiaoMultilingual', 'voice_mode': 2, 'volume': 100, 'subtitles': [ { 'start': 0, 'end': 2880, 'text': '如何在极短的时间了解5000年历史' }, { 'start': 2880, 'end': 5360, 'text': '40分钟浓缩精华版的中国历史' } ], 'enable_subtitle': 1, 'subtitle_styles': { 'alignment': 2, 'backcolor': '0,0,0,0.8', 'enable_bg': true, 'enable_stroke': false, 'font': 9, 'font_bold': false, 'font_color': '255,255,255,1', 'font_italic': false, 'font_size': 54, 'font_underline': false, 'stroke_color': '255,255,255,1', 'stroke_width': 0, 'vertical_position': 5 } }; try { final httpClient = HttpClient(); final request = await httpClient.postUrl(url); headers.forEach((key, value) => request.headers.set(key, value)); request.write(jsonEncode(requestData)); final response = await request.close(); final responseBody = await response.transform(utf8.decoder).join(); if (response.statusCode == 200) { print(jsonDecode(responseBody)); } else { print('Request failed, status code: ${response.statusCode}'); print('Response content: ${responseBody}'); } } catch (e) { print('An error occurred: $e'); } }