Query a VOD result

Update:

Query a submitted VOD task. Repeated queries do not consume results.

POSThttps://vsafe.ilivedata.com/api/v1/video/check/result

Request format

Send a UTF-8 encoded JSON body.

Request header Required Description
Content-Type Yes application/json; charset=UTF-8
Accept Recommended application/json

For authentication headers and signing rules, see Request signature in the Help Center. Use the submitting project when querying or stopping a task.

Request body

Parameter Type Required Description
taskId String Yes The result.taskId from the successful submission response.

The ID below illustrates the format only. Replace it with the ID returned by your own submission under the same project; do not reuse this fixed example.

{
  "taskId": "cn_00000000-0000-0000-0000-000000000001_1791763200000"
}

Response format

The response body is JSON, with the response header Content-Type: application/json.

Field Type Description
errorCode Integer 0 means the query request succeeded.
errorMessage String Error message; may be omitted.
taskId String Queried task ID.
code Integer 0 completed; 1 failed or no usable completed result; 2 processing; 3 result unavailable. A missing task record can instead return HTTP 400 / 2109.
result Integer Moderation verdict: 0 pass, 1 suspicious, 2 reject. This field may be absent while processing or after failure; do not interpret its absence as pass.
videoSpams Array Returned image/audio evidence; may be empty. Queries filter by verdict/labels and do not guarantee every submitted media item.
detectedLang String Detected audio language.
durationMillis Integer Video duration in milliseconds; can be 0 while processing.
audioText String Available audio transcript.
extra Object Submitted opaque data; may be omitted from status/error responses.

videoSpams[]

These fields describe VOD result items and depend on media type, policy, and processing stage. Omission does not mean zero or pass. VOD times are relative to video start.

Policy can filter the item list; do not replace the top-level result verdict by recomputing it from that list.

Field Type Description
type Integer 1 image, 2 audio.
result Integer Item verdict: 0 pass, 1 suspicious, 2 reject.
taskId String Parent video task ID.
checkTaskId String Downstream check ID for this item; not a substitute for the video taskId, and may be missing on failure.
beginTime Integer Item start time in milliseconds relative to video start.
endTime Integer Item end time in milliseconds relative to video start.
url String Image/audio evidence URL, possibly omitted by policy; audio can also have a URL.
text String Audio transcript or matched text; may be omitted for voiceprint matches or absent transcripts.
vpr Boolean Audio voiceprint match indicator, when supplied by the downstream check.
speaker String Audio speaker label.
tags Array Moderation categories, defined below.
labels Array Image labels, defined below.
ocr String[] Image OCR text.

tags[]

Field Type Description
tag Integer Primary category code; see Category codes. Audio can also return audio-specific categories.
tagName / tagNameEn String Category names in Chinese and English, when supplied.
level Integer 0 normal, 1 suspected, 2 abnormal.
subTags Array An array of subcategories, not a single object.

subTags[]

Field Type Description
subTag Integer Subcategory code.
subTagName / subTagNameEn String Subcategory names in Chinese and English.
wordList String[] Match details; may be empty.

labels[]

Field Type Description
id Integer Image label ID.
name String Label name.
score Integer Model score; range depends on the model, not universally a 0–1 probability.

Response examples

Processing

{
  "errorCode": 0,
  "taskId": "cn_00000000-0000-0000-0000-000000000001_1791763200000",
  "code": 2,
  "videoSpams": [],
  "durationMillis": 0
}

Completed

{
  "errorCode": 0,
  "taskId": "cn_00000000-0000-0000-0000-000000000001_1791763200000",
  "code": 0,
  "result": 2,
  "videoSpams": [
    {
      "taskId": "cn_00000000-0000-0000-0000-000000000001_1791763200000",
      "beginTime": 1000,
      "endTime": 2000,
      "type": 2,
      "result": 2,
      "text": "Example matched text",
      "tags": [
        {
          "tag": 160,
          "level": 2,
          "subTags": [
            {
              "subTag": 160001,
              "wordList": [
                "example match"
              ]
            }
          ]
        }
      ]
    }
  ],
  "detectedLang": "zh-CN",
  "durationMillis": 10000,
  "extra": {
    "bizId": "vod-10001"
  }
}

Times are relative to video start, not Unix timestamps. Media detail and category-name fields are optional.

Retention and task ID validity

Errors

See Error codes and handling; handle HTTP status, errorCode, task/result status code, and moderation verdict result separately.