1.2 Query Results

GET https://techhk.aoscdn.com/api/tasks/media/video-clips/preview/{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 .
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 array

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).
- start int
  
  Segment start time in milliseconds
- end int
  
  Segment end time in milliseconds
- duration int
  
  Segment duration, unit: milliseconds
- file_url string
  
  The URL of the clip file, which allows you to download the corresponding video segment.
- theme string
  
  File Theme
- summary string
  
  Theme Summary

1.1 Create Task

X-API-KEY *Header

X-API-KEY

curl 'https://techhk.aoscdn.com/api/tasks/media/video-clips/preview/{task_id}' \
  --header 'X-API-KEY: {YOUR-API-KEY}'

curl 'https://techhk.aoscdn.com/api/tasks/media/video-clips/preview/{task_id}' \
  --header 'X-API-KEY: {YOUR-API-KEY}'

using System.Text.Json;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-KEY", "{YOUR-API-KEY}");

var response = await client.GetAsync("https://techhk.aoscdn.com/api/tasks/media/video-clips/preview/{task_id}");
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);

using System.Text.Json;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-KEY", "{YOUR-API-KEY}");

var response = await client.GetAsync("https://techhk.aoscdn.com/api/tasks/media/video-clips/preview/{task_id}");
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);

import java.net.http.*;
import java.net.URI;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://techhk.aoscdn.com/api/tasks/media/video-clips/preview/{task_id}"))
    .header("X-API-KEY", "{YOUR-API-KEY}")
    .GET()
    .build();

var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

import java.net.http.*;
import java.net.URI;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://techhk.aoscdn.com/api/tasks/media/video-clips/preview/{task_id}"))
    .header("X-API-KEY", "{YOUR-API-KEY}")
    .GET()
    .build();

var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

const response = await fetch('https://techhk.aoscdn.com/api/tasks/media/video-clips/preview/{task_id}', {
  headers: {
    'X-API-KEY': '{YOUR-API-KEY}'
  }
});

const result = await response.json();
console.log(result);

const response = await fetch('https://techhk.aoscdn.com/api/tasks/media/video-clips/preview/{task_id}', {
  headers: {
    'X-API-KEY': '{YOUR-API-KEY}'
  }
});

const result = await response.json();
console.log(result);

import requests

response = requests.get(
    'https://techhk.aoscdn.com/api/tasks/media/video-clips/preview/{task_id}',
    headers={'X-API-KEY': '{YOUR-API-KEY}'}
)

print(response.json())

import requests

response = requests.get(
    'https://techhk.aoscdn.com/api/tasks/media/video-clips/preview/{task_id}',
    headers={'X-API-KEY': '{YOUR-API-KEY}'}
)

print(response.json())

import Foundation

let url = URL(string: "https://techhk.aoscdn.com/api/tasks/media/video-clips/preview/{task_id}")!
var request = URLRequest(url: url)
request.setValue("{YOUR-API-KEY}", forHTTPHeaderField: "X-API-KEY")

let (data, _) = try! await URLSession.shared.data(for: request)
let result = try! JSONSerialization.jsonObject(with: data)
print(result)

import Foundation

let url = URL(string: "https://techhk.aoscdn.com/api/tasks/media/video-clips/preview/{task_id}")!
var request = URLRequest(url: url)
request.setValue("{YOUR-API-KEY}", forHTTPHeaderField: "X-API-KEY")

let (data, _) = try! await URLSession.shared.data(for: request)
let result = try! JSONSerialization.jsonObject(with: data)
print(result)

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://techhk.aoscdn.com/api/tasks/media/video-clips/preview/{task_id}", nil)
    req.Header.Set("X-API-KEY", "{YOUR-API-KEY}")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://techhk.aoscdn.com/api/tasks/media/video-clips/preview/{task_id}", nil)
    req.Header.Set("X-API-KEY", "{YOUR-API-KEY}")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

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

void main() async {
    final client = HttpClient();
    final request = await client.getUrl(Uri.parse('https://techhk.aoscdn.com/api/tasks/media/video-clips/preview/{task_id}'));

    request.headers.set('X-API-KEY', '{YOUR-API-KEY}');

    final response = await request.close();
    final responseBody = await response.transform(utf8.decoder).join();

    print(responseBody);
}

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

void main() async {
    final client = HttpClient();
    final request = await client.getUrl(Uri.parse('https://techhk.aoscdn.com/api/tasks/media/video-clips/preview/{task_id}'));

    request.headers.set('X-API-KEY', '{YOUR-API-KEY}');

    final response = await request.close();
    final responseBody = await response.transform(utf8.decoder).join();

    print(responseBody);
}

FAQ

Response

{
  "status": 200,
  "data": {
    "completed_at": 1751822613,
    "created_at": 1751822548,
    "processed_at": 1751822547,
    "progress": 100,
    "result": [
      {
        "duration": 44100,
        "end": 33993,
        "file_url": "https://xxx",
        "start": 1170,
        "summary": "这是关于主题1的总结内容",
        "theme": "主题1..."
      },
      {
        "duration": 50500,
        "end": 40367,
        "file_url": "https://xxx",
        "start": 10000,
        "summary": "这是关于主题2的总结内容",
        "theme": "主题2..."
      }
    ],
    "state": 1,
    "state_detail": "Complete",
    "task_id": "50c80a82-a923-491e-bad6-b7e331035f9c"
  }
}

{
  "status": 200,
  "data": {
    "completed_at": 1751822613,
    "created_at": 1751822548,
    "processed_at": 1751822547,
    "progress": 100,
    "result": [
      {
        "duration": 44100,
        "end": 33993,
        "file_url": "https://xxx",
        "start": 1170,
        "summary": "这是关于主题1的总结内容",
        "theme": "主题1..."
      },
      {
        "duration": 50500,
        "end": 40367,
        "file_url": "https://xxx",
        "start": 10000,
        "summary": "这是关于主题2的总结内容",
        "theme": "主题2..."
      }
    ],
    "state": 1,
    "state_detail": "Complete",
    "task_id": "50c80a82-a923-491e-bad6-b7e331035f9c"
  }
}

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