2.1 Create Task (Identify Speakers)

POST https://techhk.aoscdn.com/api/tasks/audio/recognition

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.
type * int

Mode: Enter 4
extension string

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

The output subtitle language is optional. By default, the system detects the audio and video languages automatically. You can specify a language for subtitle translation.Supported languages .
speaker_recognition int

Speaker Recognition: Detect different speakers, 0 - no (default), 1 - yes.

Response Params

task_id string

Task ID: Required for subsequent progress queries.

1.2 Query Results 2.1 Query Results (Identify Speakers)

X-API-KEY *Header

X-API-KEY

curl --location 'https://techhk.aoscdn.com/api/tasks/audio/recognition' \
  --header 'TaskSource: ApiKey' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: {YOUR-API-KEY}' \
  --data '
{
  "url": "http://xxx.mp4",
  "type": 4
}
'

curl --location 'https://techhk.aoscdn.com/api/tasks/audio/recognition' \
  --header 'TaskSource: ApiKey' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: {YOUR-API-KEY}' \
  --data '
{
  "url": "http://xxx.mp4",
  "type": 4
}
'

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://techhk.aoscdn.com/api/tasks/audio/recognition";

    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\":\"http://xxx.mp4\",\"type\":4}";
      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}");
    }
  }
}

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://techhk.aoscdn.com/api/tasks/audio/recognition";

    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\":\"http://xxx.mp4\",\"type\":4}";
      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://techhk.aoscdn.com/api/tasks/audio/recognition");
      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\":\"http://xxx.mp4\",\"type\":4}";
      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();
    }
  }
}

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://techhk.aoscdn.com/api/tasks/audio/recognition");
      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\":\"http://xxx.mp4\",\"type\":4}";
      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://techhk.aoscdn.com/api/tasks/audio/recognition";
  const headers = {
    "TaskSource": "ApiKey",
    "Content-Type": "application/json",
    "x-api-key": "{YOUR-API-KEY}"
  };

  const requestData = {
    "url": "http://xxx.mp4",
    "type": 4
  };

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

async function sendRequest() {
  const url = "https://techhk.aoscdn.com/api/tasks/audio/recognition";
  const headers = {
    "TaskSource": "ApiKey",
    "Content-Type": "application/json",
    "x-api-key": "{YOUR-API-KEY}"
  };

  const requestData = {
    "url": "http://xxx.mp4",
    "type": 4
  };

  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://techhk.aoscdn.com/api/tasks/audio/recognition"
headers = {
  "TaskSource": "ApiKey",
  "Content-Type": "application/json",
  "x-api-key": "{YOUR-API-KEY}"
}

request_data = {
  "url": "http://xxx.mp4",
  "type": 4
}

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

url = "https://techhk.aoscdn.com/api/tasks/audio/recognition"
headers = {
  "TaskSource": "ApiKey",
  "Content-Type": "application/json",
  "x-api-key": "{YOUR-API-KEY}"
}

request_data = {
  "url": "http://xxx.mp4",
  "type": 4
}

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://techhk.aoscdn.com/api/tasks/audio/recognition") 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": "http://xxx.mp4",
    "type": 4
  ]

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

import Foundation

func sendRequest() {
  guard let url = URL(string: "https://techhk.aoscdn.com/api/tasks/audio/recognition") 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": "http://xxx.mp4",
    "type": 4
  ]

  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://techhk.aoscdn.com/api/tasks/audio/recognition"

  requestData := map[string]interface{}{
    "url": "http://xxx.mp4",
    "type": 4,
  }

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

package main

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

func main() {
  url := "https://techhk.aoscdn.com/api/tasks/audio/recognition"

  requestData := map[string]interface{}{
    "url": "http://xxx.mp4",
    "type": 4,
  }

  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://techhk.aoscdn.com/api/tasks/audio/recognition");
  final headers = {
    'TaskSource': 'ApiKey',
    'Content-Type': 'application/json',
    'x-api-key': '{YOUR-API-KEY}'
  };

  final requestData = {
    'url': 'http://xxx.mp4',
    'type': 4
  };

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

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

Future<void> main() async {
  final url = Uri.parse("https://techhk.aoscdn.com/api/tasks/audio/recognition");
  final headers = {
    'TaskSource': 'ApiKey',
    'Content-Type': 'application/json',
    'x-api-key': '{YOUR-API-KEY}'
  };

  final requestData = {
    'url': 'http://xxx.mp4',
    'type': 4
  };

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

FAQ

Response

{
  "status": 200,
  "message": "success",
  "data": {
    "task_id": "63d0994f-6f9f-4d98-9299-0afa7f8d4662"
  }
}

{
  "status": 200,
  "message": "success",
  "data": {
    "task_id": "63d0994f-6f9f-4d98-9299-0afa7f8d4662"
  }
}

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