3.1 创建合成任务

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

Request Params

url * string

视频URL
language string

目标语言（如：zh-CN、en-US），如果包含下划线，会自动提取第一部分
subtitles string/array

字幕数据（JSON字符串或数组），格式：
- start int
  
  开始时间（毫秒）
- end int
  
  结束时间（毫秒）
- text string
  
  字幕文本
- speaker string
  
  说话人标识（如speaker0）
- voice string
  
  音色标识
- modified int
  
  是否已修改（1-已修改）

Response Params

task_id string

任务ID，用于后续查询任务状态和结果

2.2 获取预览任务结果 3.2 获取合成任务结果

X-API-KEY *Header

X-API-KEY

curl --location 'https://techsz.aoscdn.com/api/tasks/media/video-translation/synthesis' \
--header 'TaskSource: ApiKey' \
--header 'x-api-key: {YOUR-API-KEY}' \
--header 'Content-Type: application/json' \
--data '{
  "url": "https://example.com/video.mp4",
  "language": "en",
  "subtitles": "[{\"start\":0,\"end\":1830,\"text\":\"Hello\",\"speaker\":\"speaker0\",\"voice\":\"cv_xxx\"}]"
}'

curl --location 'https://techsz.aoscdn.com/api/tasks/media/video-translation/synthesis' \
--header 'TaskSource: ApiKey' \
--header 'x-api-key: {YOUR-API-KEY}' \
--header 'Content-Type: application/json' \
--data '{
  "url": "https://example.com/video.mp4",
  "language": "en",
  "subtitles": "[{\"start\":0,\"end\":1830,\"text\":\"Hello\",\"speaker\":\"speaker0\",\"voice\":\"cv_xxx\"}]"
}'

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("TaskSource", "ApiKey");
client.DefaultRequestHeaders.Add("x-api-key", "{YOUR-API-KEY}");
var body = new StringContent("""
{
  "url": "https://example.com/video.mp4",
  "language": "en",
  "subtitles": "[{\"start\":0,\"end\":1830,\"text\":\"Hello\",\"speaker\":\"speaker0\",\"voice\":\"cv_xxx\"}]"
}
""", System.Text.Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://techsz.aoscdn.com/api/tasks/media/video-translation/synthesis", body);
Console.WriteLine(await response.Content.ReadAsStringAsync());

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("TaskSource", "ApiKey");
client.DefaultRequestHeaders.Add("x-api-key", "{YOUR-API-KEY}");
var body = new StringContent("""
{
  "url": "https://example.com/video.mp4",
  "language": "en",
  "subtitles": "[{\"start\":0,\"end\":1830,\"text\":\"Hello\",\"speaker\":\"speaker0\",\"voice\":\"cv_xxx\"}]"
}
""", System.Text.Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://techsz.aoscdn.com/api/tasks/media/video-translation/synthesis", body);
Console.WriteLine(await response.Content.ReadAsStringAsync());

HttpURLConnection conn = (HttpURLConnection) new URL("https://techsz.aoscdn.com/api/tasks/media/video-translation/synthesis").openConnection();
conn.setRequestMethod("POST");
conn.setRequestProperty("TaskSource", "ApiKey");
conn.setRequestProperty("x-api-key", "{YOUR-API-KEY}");
conn.setRequestProperty("Content-Type", "application/json");
conn.setDoOutput(true);
String body = "{\"url\":\"https://example.com/video.mp4\",\"language\":\"en\",\"subtitles\":\"[{\\\"start\\\":0,\\\"end\\\":1830,\\\"text\\\":\\\"Hello\\\",\\\"speaker\\\":\\\"speaker0\\\",\\\"voice\\\":\\\"cv_xxx\\\"}]\"}";
conn.getOutputStream().write(body.getBytes());
System.out.println(new String(conn.getInputStream().readAllBytes()));

HttpURLConnection conn = (HttpURLConnection) new URL("https://techsz.aoscdn.com/api/tasks/media/video-translation/synthesis").openConnection();
conn.setRequestMethod("POST");
conn.setRequestProperty("TaskSource", "ApiKey");
conn.setRequestProperty("x-api-key", "{YOUR-API-KEY}");
conn.setRequestProperty("Content-Type", "application/json");
conn.setDoOutput(true);
String body = "{\"url\":\"https://example.com/video.mp4\",\"language\":\"en\",\"subtitles\":\"[{\\\"start\\\":0,\\\"end\\\":1830,\\\"text\\\":\\\"Hello\\\",\\\"speaker\\\":\\\"speaker0\\\",\\\"voice\\\":\\\"cv_xxx\\\"}]\"}";
conn.getOutputStream().write(body.getBytes());
System.out.println(new String(conn.getInputStream().readAllBytes()));

const res = await fetch("https://techsz.aoscdn.com/api/tasks/media/video-translation/synthesis", {
  method: "POST",
  headers: {
    "TaskSource": "ApiKey",
    "x-api-key": "{YOUR-API-KEY}",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    url: "https://example.com/video.mp4",
    language: "en",
    subtitles: JSON.stringify([{ start: 0, end: 1830, text: "Hello", speaker: "speaker0", voice: "cv_xxx" }])
  })
});
console.log(await res.json());

const res = await fetch("https://techsz.aoscdn.com/api/tasks/media/video-translation/synthesis", {
  method: "POST",
  headers: {
    "TaskSource": "ApiKey",
    "x-api-key": "{YOUR-API-KEY}",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    url: "https://example.com/video.mp4",
    language: "en",
    subtitles: JSON.stringify([{ start: 0, end: 1830, text: "Hello", speaker: "speaker0", voice: "cv_xxx" }])
  })
});
console.log(await res.json());

import urllib.request, json
subtitles = json.dumps([{"start": 0, "end": 1830, "text": "Hello", "speaker": "speaker0", "voice": "cv_xxx"}])
data = json.dumps({
  "url": "https://example.com/video.mp4",
  "language": "en",
  "subtitles": subtitles
}).encode()
req = urllib.request.Request(
  "https://techsz.aoscdn.com/api/tasks/media/video-translation/synthesis",
  data=data,
  headers={"TaskSource": "ApiKey", "x-api-key": "{YOUR-API-KEY}", "Content-Type": "application/json"},
  method="POST"
)
print(urllib.request.urlopen(req).read().decode())

import urllib.request, json
subtitles = json.dumps([{"start": 0, "end": 1830, "text": "Hello", "speaker": "speaker0", "voice": "cv_xxx"}])
data = json.dumps({
  "url": "https://example.com/video.mp4",
  "language": "en",
  "subtitles": subtitles
}).encode()
req = urllib.request.Request(
  "https://techsz.aoscdn.com/api/tasks/media/video-translation/synthesis",
  data=data,
  headers={"TaskSource": "ApiKey", "x-api-key": "{YOUR-API-KEY}", "Content-Type": "application/json"},
  method="POST"
)
print(urllib.request.urlopen(req).read().decode())

var req = URLRequest(url: URL(string: "https://techsz.aoscdn.com/api/tasks/media/video-translation/synthesis")!)
req.httpMethod = "POST"
req.addValue("ApiKey", forHTTPHeaderField: "TaskSource")
req.addValue("{YOUR-API-KEY}", forHTTPHeaderField: "x-api-key")
req.addValue("application/json", forHTTPHeaderField: "Content-Type")
let subtitles = "[{\"start\":0,\"end\":1830,\"text\":\"Hello\",\"speaker\":\"speaker0\",\"voice\":\"cv_xxx\"}]"
req.httpBody = try! JSONSerialization.data(withJSONObject: [
  "url": "https://example.com/video.mp4",
  "language": "en",
  "subtitles": subtitles
])
let (data, _) = try await URLSession.shared.data(for: req)
print(String(data: data, encoding: .utf8)!)

var req = URLRequest(url: URL(string: "https://techsz.aoscdn.com/api/tasks/media/video-translation/synthesis")!)
req.httpMethod = "POST"
req.addValue("ApiKey", forHTTPHeaderField: "TaskSource")
req.addValue("{YOUR-API-KEY}", forHTTPHeaderField: "x-api-key")
req.addValue("application/json", forHTTPHeaderField: "Content-Type")
let subtitles = "[{\"start\":0,\"end\":1830,\"text\":\"Hello\",\"speaker\":\"speaker0\",\"voice\":\"cv_xxx\"}]"
req.httpBody = try! JSONSerialization.data(withJSONObject: [
  "url": "https://example.com/video.mp4",
  "language": "en",
  "subtitles": subtitles
])
let (data, _) = try await URLSession.shared.data(for: req)
print(String(data: data, encoding: .utf8)!)

body := strings.NewReader(`{"url":"https://example.com/video.mp4","language":"en","subtitles":"[{\"start\":0,\"end\":1830,\"text\":\"Hello\",\"speaker\":\"speaker0\",\"voice\":\"cv_xxx\"}]"}`)
req, _ := http.NewRequest("POST", "https://techsz.aoscdn.com/api/tasks/media/video-translation/synthesis", body)
req.Header.Set("TaskSource", "ApiKey")
req.Header.Set("x-api-key", "{YOUR-API-KEY}")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
b, _ := io.ReadAll(resp.Body)
fmt.Println(string(b))

body := strings.NewReader(`{"url":"https://example.com/video.mp4","language":"en","subtitles":"[{\"start\":0,\"end\":1830,\"text\":\"Hello\",\"speaker\":\"speaker0\",\"voice\":\"cv_xxx\"}]"}`)
req, _ := http.NewRequest("POST", "https://techsz.aoscdn.com/api/tasks/media/video-translation/synthesis", body)
req.Header.Set("TaskSource", "ApiKey")
req.Header.Set("x-api-key", "{YOUR-API-KEY}")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
b, _ := io.ReadAll(resp.Body)
fmt.Println(string(b))

final req = await HttpClient().postUrl(Uri.parse("https://techsz.aoscdn.com/api/tasks/media/video-translation/synthesis"));
req.headers..set("TaskSource", "ApiKey")..set("x-api-key", "{YOUR-API-KEY}")..set("Content-Type", "application/json");
req.write('{"url":"https://example.com/video.mp4","language":"en","subtitles":"[{\\"start\\":0,\\"end\\":1830,\\"text\\":\\"Hello\\",\\"speaker\\":\\"speaker0\\",\\"voice\\":\\"cv_xxx\\"}]"}');
final res = await req.close();
print(await res.transform(utf8.decoder).join());

final req = await HttpClient().postUrl(Uri.parse("https://techsz.aoscdn.com/api/tasks/media/video-translation/synthesis"));
req.headers..set("TaskSource", "ApiKey")..set("x-api-key", "{YOUR-API-KEY}")..set("Content-Type", "application/json");
req.write('{"url":"https://example.com/video.mp4","language":"en","subtitles":"[{\\"start\\":0,\\"end\\":1830,\\"text\\":\\"Hello\\",\\"speaker\\":\\"speaker0\\",\\"voice\\":\\"cv_xxx\\"}]"}');
final res = await req.close();
print(await res.transform(utf8.decoder).join());

常见问题

Response

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "synthesis-task-456"
  }
}

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "synthesis-task-456"
  }
}

{
  "status": 401,
  "message": "You have exceeded your request quota for this API key"
}

{
  "status": 401,
  "message": "You have exceeded your request quota for this API key"
}

{
  "status": 413,
  "message": "Request Entity Too Large"
}

{
  "status": 413,
  "message": "Request Entity Too Large"
}

{
  "status": 429,
  "message": "Too Many Requests"
}

{
  "status": 429,
  "message": "Too Many Requests"
}

更多状态码

返回顶部