2.2 Video Synthesis (Check Results)

GET https://techhk.aoscdn.com/api/tasks/video-translation/export/{task_id}

Request Params

task_id * string

Task ID: Used to query task results.

Response Params

state int

Task Status: <0: Failed; 0: Queued; 1: Completed; 4: In Progress. For details, please check the .
state_detail string

Status Details: For example, Complete
task_id string

Task ID
created_at int

Creation Time (Timestamp)
processed_at int

Processing Time (Timestamp)
completed_at int

Completion Time (Timestamp)
progress int

Progress: Range 0-100
result object

Recognized Content from File: Each array element contains start (segment start time in milliseconds), end (segment end time in milliseconds), and text (recognized text content).
- video string
  
  Export file download link

2.1 Video Synthesis (Create Task) AI Subtitle Generator

X-API-KEY *Header

X-API-KEY

curl 'https://techsz.aoscdn.com/api/tasks/media/video-translation/export/{task_id}' \
--header 'X-API-KEY: {YOUR-API-KEY}'

curl 'https://techsz.aoscdn.com/api/tasks/media/video-translation/export/{task_id}' \
--header 'X-API-KEY: {YOUR-API-KEY}'

using System; using System.IO; using System.Net; using System.Threading.Tasks;

class Program {
  static async Task Main() => await QueryRequest();

  static async Task QueryRequest() {
    string taskId = "{task_id}";
    string url = $"https://techsz.aoscdn.com/api/tasks/media/video-translation/export/{taskId}";

    try {
      var request = (HttpWebRequest)WebRequest.Create(url);
      request.Method = "GET";
      request.Headers["X-API-KEY"] = "{YOUR-API-KEY}";

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

using System; using System.IO; using System.Net; using System.Threading.Tasks;

class Program {
  static async Task Main() => await QueryRequest();

  static async Task QueryRequest() {
    string taskId = "{task_id}";
    string url = $"https://techsz.aoscdn.com/api/tasks/media/video-translation/export/{taskId}";

    try {
      var request = (HttpWebRequest)WebRequest.Create(url);
      request.Method = "GET";
      request.Headers["X-API-KEY"] = "{YOUR-API-KEY}";

      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 {
      String taskId = "{task_id}";
      URL url = new URL("https://techsz.aoscdn.com/api/tasks/media/video-translation/export/" + taskId);
      HttpURLConnection connection = (HttpURLConnection) url.openConnection();

      connection.setRequestMethod("GET");
      connection.setRequestProperty("X-API-KEY", "{YOUR-API-KEY}");

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

import java.io.*; import java.net.*; import java.nio.charset.StandardCharsets;

public class ApiRequest {
  public static void main(String[] args) {
    try {
      String taskId = "{task_id}";
      URL url = new URL("https://techsz.aoscdn.com/api/tasks/media/video-translation/export/" + taskId);
      HttpURLConnection connection = (HttpURLConnection) url.openConnection();

      connection.setRequestMethod("GET");
      connection.setRequestProperty("X-API-KEY", "{YOUR-API-KEY}");

      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 queryTask() {
  const taskId = "{task_id}";
  const url = `https://techsz.aoscdn.com/api/tasks/media/video-translation/export/${taskId}`;
  const headers = {
    "X-API-KEY": "{YOUR-API-KEY}"
  };

  try {
    const response = await fetch(url, {
      method: "GET",
      headers
    });

    console.log(await response.json());
  } catch (error) {
    console.error("Request failed:", error);
  }
}

queryTask();

async function queryTask() {
  const taskId = "{task_id}";
  const url = `https://techsz.aoscdn.com/api/tasks/media/video-translation/export/${taskId}`;
  const headers = {
    "X-API-KEY": "{YOUR-API-KEY}"
  };

  try {
    const response = await fetch(url, {
      method: "GET",
      headers
    });

    console.log(await response.json());
  } catch (error) {
    console.error("Request failed:", error);
  }
}

queryTask();

import json, urllib.request

task_id = "{task_id}"
url = f"https://techsz.aoscdn.com/api/tasks/media/video-translation/export/{task_id}"
headers = {
  "X-API-KEY": "{YOUR-API-KEY}"
}

req = urllib.request.Request(
  url=url,
  headers=headers,
  method="GET"
)

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 json, urllib.request

task_id = "{task_id}"
url = f"https://techsz.aoscdn.com/api/tasks/media/video-translation/export/{task_id}"
headers = {
  "X-API-KEY": "{YOUR-API-KEY}"
}

req = urllib.request.Request(
  url=url,
  headers=headers,
  method="GET"
)

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 queryTask() {
  let taskId = "{task_id}"
  guard let url = URL(string: "https://techsz.aoscdn.com/api/tasks/media/video-translation/export/\(taskId)") else {
    print("Invalid URL")
    return
  }

  var request = URLRequest(url: url)
  request.httpMethod = "GET"
  request.addValue("{YOUR-API-KEY}", forHTTPHeaderField: "X-API-KEY")

  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()
}

queryTask();

import Foundation

func queryTask() {
  let taskId = "{task_id}"
  guard let url = URL(string: "https://techsz.aoscdn.com/api/tasks/media/video-translation/export/\(taskId)") else {
    print("Invalid URL")
    return
  }

  var request = URLRequest(url: url)
  request.httpMethod = "GET"
  request.addValue("{YOUR-API-KEY}", forHTTPHeaderField: "X-API-KEY")

  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()
}

queryTask();

package main

import (
  "encoding/json"
  "fmt"
  "io/ioutil"
  "net/http"
)

func main() {
  taskId := "{task_id}"
  url := fmt.Sprintf("https://techsz.aoscdn.com/api/tasks/media/video-translation/export/%s", taskId)

  req, err := http.NewRequest("GET", url, nil)
  if err != nil {
    fmt.Println("Error creating request:", err)
    return
  }

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

package main

import (
  "encoding/json"
  "fmt"
  "io/ioutil"
  "net/http"
)

func main() {
  taskId := "{task_id}"
  url := fmt.Sprintf("https://techsz.aoscdn.com/api/tasks/media/video-translation/export/%s", taskId)

  req, err := http.NewRequest("GET", url, nil)
  if err != nil {
    fmt.Println("Error creating request:", err)
    return
  }

  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 taskId = "{task_id}";
  final url = Uri.parse("https://techsz.aoscdn.com/api/tasks/media/video-translation/export/$taskId");
  final headers = {
    'X-API-KEY': '{YOUR-API-KEY}'
  };

  try {
    final httpClient = HttpClient();
    final request = await httpClient.getUrl(url);

    headers.forEach((key, value) => request.headers.set(key, value));

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

import 'dart:convert';
import 'dart:io';

Future<void> main() async {
  final taskId = "{task_id}";
  final url = Uri.parse("https://techsz.aoscdn.com/api/tasks/media/video-translation/export/$taskId");
  final headers = {
    'X-API-KEY': '{YOUR-API-KEY}'
  };

  try {
    final httpClient = HttpClient();
    final request = await httpClient.getUrl(url);

    headers.forEach((key, value) => request.headers.set(key, value));

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

FAQ

Response

{
  "status": 200,
  "data": {
    "completed_at": 1743579855,
    "created_at": 1743579824,
    "processed_at": 1743579823,
    "progress": 100,
    "state": 1,
    "state_detail": "Complete",
    "task_id": "440a12e3-0d6d-4363-9bac-c197fa802661",
    "result": {
      "video": "https://wxtechdev.oss-cn-shenzhen.aliyuncs.com/tasks/output/media_video_translation_export/440a12e3-0d6d-4363-9bac-c197fa802661-1.mp4?x-oss-credential=LTAI5tGjJnh66c1txANiRBQN/20250402/cn-shenzhen/oss/aliyun_v4_request&x-oss-date=20250402T074927Z&x-oss-expires=3600&x-oss-signature=ad64b11e7a8541ab51e46a03dcd57a458cc14387a91fc564b121cdc5c8f05022&x-oss-signature-version=OSS4-HMAC-SHA256"
    }
  }
}

{
  "status": 200,
  "data": {
    "completed_at": 1743579855,
    "created_at": 1743579824,
    "processed_at": 1743579823,
    "progress": 100,
    "state": 1,
    "state_detail": "Complete",
    "task_id": "440a12e3-0d6d-4363-9bac-c197fa802661",
    "result": {
      "video": "https://wxtechdev.oss-cn-shenzhen.aliyuncs.com/tasks/output/media_video_translation_export/440a12e3-0d6d-4363-9bac-c197fa802661-1.mp4?x-oss-credential=LTAI5tGjJnh66c1txANiRBQN/20250402/cn-shenzhen/oss/aliyun_v4_request&x-oss-date=20250402T074927Z&x-oss-expires=3600&x-oss-signature=ad64b11e7a8541ab51e46a03dcd57a458cc14387a91fc564b121cdc5c8f05022&x-oss-signature-version=OSS4-HMAC-SHA256"
    }
  }
}

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

This website uses cookies that are essential for the operations of this website and its core functions. Other cookies will only be placed with your consent. For more details visit our Cookies Policy.