Video summarization

General notes

• The video summarization service supports only asynchronous calls. You must first create an asynchronous task and then query the result by using the task ID.

• The request body cannot exceed 8 MB.

Create an asynchronous task

{host}/v3/openapi/workspaces/{workspace_name}/video-summarization/{service_id}/async

Get the status of an asynchronous task

{host}/v3/openapi/workspaces/{workspace_name}/video-summarization/{service_id}/async/task-status?task_id={task_id}

Header parameters

API-KEY authentication

Body parameters (create task)

Query parameters (get task status)

Create an asynchronous task

Get the status of an asynchronous task

Create an asynchronous task

curl --location 'http://****-hangzhou.opensearch.aliyuncs.com/v3/openapi/workspaces/default/video-summarization/ops-video-summarize-001/async' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "input": {
    "oss": "oss://my-bucket-name/example/test.mp4"
  },
  "parameters": {
    "rewrite_transcript": true,
    "generate_tags": true,
    "extract_snapshot": true
  },
  "output": {
    "type": "oss",
    "oss": "oss://my-bucket-name/dump/result/path"
  }
}'

Get the status of an asynchronous task

curl --location 'http://****-hangzhou.opensearch.aliyuncs.com/v3/openapi/workspaces/default/video-summarization/ops-video-summarize-001/async/task-status?task_id=summarization-xxxx-abc-123' \
--header 'Authorization: Bearer YOUR_API_KEY'

Create an asynchronous task

{
  "request_id": "f4a95b66efd25e6c94d0a1861cd3cf88",
  "latency": 39,
  "usage": {},
  "result": {
    "task_id": "video_summarize-2026031310xxxx-xxxxxxxxxxxxxxxx-e19ee37c",
    "status": "PENDING"
  }
}

Get task status (completed)

{
  "request_id": "1",
  "latency": 0,
  "usage": {
    "audio_token": 200,
    "image_token": 100,
    "input_token": 300,
    "output_token": 300
  },
  "result": {
    "task_id": "test-summary-001",
    "status": "SUCCESS",
    "data": {
      "video_metadata": {
        "title": "Video Title",
        "summary": "This is a summary of a product introduction video.",
        "tags": [
          "Product Introduction",
          "Technology"
        ]
      },
      "chunks": [
        {
          "index": 0,
          "enhanced_transcript": "This is the enhanced transcript text.",
          "metadata": {
            "title": "Title of the First Segment",
            "summary": "Summary of the first segment.",
            "tags": [
              "Segment Tag 1",
              "Segment Tag 2"
            ]
          }
        }
      ]
    }
  }
}