2.1 合成视频（创建任务）

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

Request Params

url * string

文件URL，文件的URL，必须为可解析的HTTP协议URL；如果URL的path没有文件扩展名，需要额外指定extension参数，比如extension=mp3；最长512个字符串；下载超时5分钟（如果5分钟未下载完成则失败）；文件时长3h，大小4G
language * string

音色语言(依赖于选择的mode)
具体语言可见下方voice支持的音色表格
voice_mode * int

mode(音色库）
1: 经典音色
2: 拓展音色
voice * string

音色，默认是xiaoyun
*根据language匹配对应音色，点击查看
subtitles * array

字幕列表
- start * int
  
  片段开始时间，单位：毫秒
- end * int
  
  片段结束时间，单位：毫秒
- text * string
  
  识别出的文本内容
enable_subtitle int

是否生成字幕, 0-不生成, 1-生成(默认)
subtitle_style object

字幕样式
- alignment int
  
  对齐方式 0:左对齐 2:居中(默认) 3:右对齐
- backcolor string
  
  背景颜色(rgba)，默认黑底80%透明度（0,0,0,0.8 ）
- enable_bg bool
  
  是否启用背景 true:启用(默认) false:禁用
- enable_stroke bool
  
  是否启用文字描边 true: 启用; false: 禁用(默认)
- font int
  
  字体类型Id。选项：0-andalemo（默认），1-open sans，2-comic，3-impat，4-time new roman，5-宋体，6-黑体，7-楷体，8-隶书，9-微软雅黑
- font_bold bool
  
  是否加粗 true: 启用; false: 禁用(默认)
- font_color string
  
  字体颜色(rgba) ，默认纯白不透明（255,255,255,1）
- font_italic bool
  
  是否斜体 true: 启用; false: 禁用(默认)
- font_size int
  
  字体大小单位：像素，默认 20
- font_underline bool
  
  是否下划线 true: 启用; false: 禁用(默认)
- stroke_color string
  
  描边颜色(rgba) ，默认纯白不透明（255,255,255,1）
- stroke_width int
  
  描边宽度单位: 像素, 默认0
- vertical_position int
  
  底部垂直距离单位: 像素, 默认0
volume int

音量，范围是0~100，默认50
filename string

导出文件名称
extension string

文件扩展名，如果URL的path没有文件扩展名，需要额外指定。

Response Params

task_id string

任务ID，后续查询进度需要该task id

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'); } }