2.1 Create Preview Task

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

Request Params

url * string

Video URL
language * string

Target Translation Language (e.g.: zh-CN, en-US). If it contains an underscore, the first part will be automatically extracted.
original_srt_url string

Original SRT Subtitle File URL (if provided, this subtitle will be used instead of ASR recognition)
translate_srt_url string

Translated SRT Subtitle File URL (if provided, this subtitle will be used instead of translation result)
speaker_identification int

Distinguish Speakers (default: no). If not distinguishing, the selected voice must be specified.
voice string

Voice. If not distinguishing speakers, the selected voice must be specified.

Response Params

task_id string

Task ID, used for subsequent task status query and result retrieval

1.0 Get Voice List 2.2 Get Preview Task Result

X-API-KEY *Header

X-API-KEY

curl --location 'https://techhk.aoscdn.com/api/tasks/media/video-translation/preview' \
--header 'TaskSource: ApiKey' \
--header 'x-api-key: {YOUR-API-KEY}' \
--header 'Content-Type: application/json' \
--data '{
  "url": "https://example.com/video.mp4",
  "original_srt_url": "https://example.com/original.srt",
  "translate_srt_url": "https://example.com/translate.srt",
  "language": "en-US"
}'

curl --location 'https://techhk.aoscdn.com/api/tasks/media/video-translation/preview' \
--header 'TaskSource: ApiKey' \
--header 'x-api-key: {YOUR-API-KEY}' \
--header 'Content-Type: application/json' \
--data '{
  "url": "https://example.com/video.mp4",
  "original_srt_url": "https://example.com/original.srt",
  "translate_srt_url": "https://example.com/translate.srt",
  "language": "en-US"
}'

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",
  "original_srt_url": "https://example.com/original.srt",
  "translate_srt_url": "https://example.com/translate.srt",
  "language": "en-US"
}
""", System.Text.Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://techhk.aoscdn.com/api/tasks/media/video-translation/preview", 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",
  "original_srt_url": "https://example.com/original.srt",
  "translate_srt_url": "https://example.com/translate.srt",
  "language": "en-US"
}
""", System.Text.Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://techhk.aoscdn.com/api/tasks/media/video-translation/preview", body);
Console.WriteLine(await response.Content.ReadAsStringAsync());

HttpURLConnection conn = (HttpURLConnection) new URL("https://techhk.aoscdn.com/api/tasks/media/video-translation/preview").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\",\"original_srt_url\":\"https://example.com/original.srt\",\"translate_srt_url\":\"https://example.com/translate.srt\",\"language\":\"en-US\"}";
conn.getOutputStream().write(body.getBytes());
System.out.println(new String(conn.getInputStream().readAllBytes()));

HttpURLConnection conn = (HttpURLConnection) new URL("https://techhk.aoscdn.com/api/tasks/media/video-translation/preview").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\",\"original_srt_url\":\"https://example.com/original.srt\",\"translate_srt_url\":\"https://example.com/translate.srt\",\"language\":\"en-US\"}";
conn.getOutputStream().write(body.getBytes());
System.out.println(new String(conn.getInputStream().readAllBytes()));

const res = await fetch("https://techhk.aoscdn.com/api/tasks/media/video-translation/preview", {
  method: "POST",
  headers: {
    "TaskSource": "ApiKey",
    "x-api-key": "{YOUR-API-KEY}",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    url: "https://example.com/video.mp4",
    original_srt_url: "https://example.com/original.srt",
    translate_srt_url: "https://example.com/translate.srt",
    language: "en-US"
  })
});
console.log(await res.json());

const res = await fetch("https://techhk.aoscdn.com/api/tasks/media/video-translation/preview", {
  method: "POST",
  headers: {
    "TaskSource": "ApiKey",
    "x-api-key": "{YOUR-API-KEY}",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    url: "https://example.com/video.mp4",
    original_srt_url: "https://example.com/original.srt",
    translate_srt_url: "https://example.com/translate.srt",
    language: "en-US"
  })
});
console.log(await res.json());

import urllib.request, json
data = json.dumps({
  "url": "https://example.com/video.mp4",
  "original_srt_url": "https://example.com/original.srt",
  "translate_srt_url": "https://example.com/translate.srt",
  "language": "en-US"
}).encode()
req = urllib.request.Request(
  "https://techhk.aoscdn.com/api/tasks/media/video-translation/preview",
  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
data = json.dumps({
  "url": "https://example.com/video.mp4",
  "original_srt_url": "https://example.com/original.srt",
  "translate_srt_url": "https://example.com/translate.srt",
  "language": "en-US"
}).encode()
req = urllib.request.Request(
  "https://techhk.aoscdn.com/api/tasks/media/video-translation/preview",
  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://techhk.aoscdn.com/api/tasks/media/video-translation/preview")!)
req.httpMethod = "POST"
req.addValue("ApiKey", forHTTPHeaderField: "TaskSource")
req.addValue("{YOUR-API-KEY}", forHTTPHeaderField: "x-api-key")
req.addValue("application/json", forHTTPHeaderField: "Content-Type")
req.httpBody = try! JSONSerialization.data(withJSONObject: [
  "url": "https://example.com/video.mp4",
  "original_srt_url": "https://example.com/original.srt",
  "translate_srt_url": "https://example.com/translate.srt",
  "language": "en-US"
])
let (data, _) = try await URLSession.shared.data(for: req)
print(String(data: data, encoding: .utf8)!)

var req = URLRequest(url: URL(string: "https://techhk.aoscdn.com/api/tasks/media/video-translation/preview")!)
req.httpMethod = "POST"
req.addValue("ApiKey", forHTTPHeaderField: "TaskSource")
req.addValue("{YOUR-API-KEY}", forHTTPHeaderField: "x-api-key")
req.addValue("application/json", forHTTPHeaderField: "Content-Type")
req.httpBody = try! JSONSerialization.data(withJSONObject: [
  "url": "https://example.com/video.mp4",
  "original_srt_url": "https://example.com/original.srt",
  "translate_srt_url": "https://example.com/translate.srt",
  "language": "en-US"
])
let (data, _) = try await URLSession.shared.data(for: req)
print(String(data: data, encoding: .utf8)!)

body := strings.NewReader(`{"url":"https://example.com/video.mp4","original_srt_url":"https://example.com/original.srt","translate_srt_url":"https://example.com/translate.srt","language":"en-US"}`)
req, _ := http.NewRequest("POST", "https://techhk.aoscdn.com/api/tasks/media/video-translation/preview", 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","original_srt_url":"https://example.com/original.srt","translate_srt_url":"https://example.com/translate.srt","language":"en-US"}`)
req, _ := http.NewRequest("POST", "https://techhk.aoscdn.com/api/tasks/media/video-translation/preview", 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://techhk.aoscdn.com/api/tasks/media/video-translation/preview"));
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","original_srt_url":"https://example.com/original.srt","translate_srt_url":"https://example.com/translate.srt","language":"en-US"}');
final res = await req.close();
print(await res.transform(utf8.decoder).join());

final req = await HttpClient().postUrl(Uri.parse("https://techhk.aoscdn.com/api/tasks/media/video-translation/preview"));
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","original_srt_url":"https://example.com/original.srt","translate_srt_url":"https://example.com/translate.srt","language":"en-US"}');
final res = await req.close();
print(await res.transform(utf8.decoder).join());

FAQ

Response

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "abc123-def456-ghi789"
  }
}

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "abc123-def456-ghi789"
  }
}

{
  "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"
}

More Status Codes

返回頂部