AI Speech to Text

AI quickly converts audio and video into text with high accuracy using advanced AI models. It also supports translation into major global languages.

1. Create Task

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

Request Params

url * string

File URL: Must be a resolvable HTTP URL. If the URL lacks a file extension, specify extension, e.g., extension=mp3. Max 512 characters. Download timeout is 5 minutes (failure if not completed within 5 minutes).
type * int

Mode: Enter 4
content_type * int

Content Type: Enter 1
extension string

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

Audio Language: Optional. Defaults to automatic detection. Supported languages are listed in the appendix.
speaker_recognition int

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

Response Params

task_id string

Task ID: Needed for progress tracking.

RecCloud API 2. Query Results

X-API-KEY *Header

X-API-KEY

curl --location 'https://techsz.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,
  "content_type": 1
}'

curl --location 'https://techsz.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,
  "content_type": 1
}'

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/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,\"content_type\":1}";
      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)) {
            string result = await reader.ReadToEndAsync();
            Console.WriteLine(result);
          }
        }
      }
    }
    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)) {
            string errorDetails = await reader.ReadToEndAsync();
            Console.WriteLine($"Error details: {errorDetails}");
          }
        }
      }
    }
    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://techsz.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,\"content_type\":1}";
      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)) {
            string result = await reader.ReadToEndAsync();
            Console.WriteLine(result);
          }
        }
      }
    }
    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)) {
            string errorDetails = await reader.ReadToEndAsync();
            Console.WriteLine($"Error details: {errorDetails}");
          }
        }
      }
    }
    catch (Exception e) {
      Console.WriteLine($"An error occurred: {e.Message}");
    }
  }
}

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
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/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,\"content_type\":1}";
      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.BufferedReader;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
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/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,\"content_type\":1}";
      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/audio/recognition";
  const headers = {
    "TaskSource": "ApiKey",
    "Content-Type": "application/json",
    "x-api-key": "{YOUR-API-KEY}"
  };

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

  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://techsz.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,
    "content_type": 1
  };

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

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

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://techsz.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,
  "content_type": 1
}

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/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,
    "content_type": 1
  ]

  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://techsz.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,
    "content_type": 1
  ]

  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/audio/recognition"

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

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

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

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

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

  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://techsz.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,
    'content_type': 1
  };

  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

トップに戻る

弊社のウェブサイトでは最高の体験を提供するためにクッキーを使用します。その他のクッキーは、お客様の同意がある場合にのみ配置されます。詳細については、クッキーポリシーをご覧ください。