结果查询接口

查询已提交的点播任务。接口可重复查询，不会因为读取而消费结果。

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

请求格式

请求体使用 UTF-8 编码的 JSON。

请求头	必需	说明
`Content-Type`	是	`application/json; charset=UTF-8`
`Accept`	建议	`application/json`

鉴权相关请求头及签名规则见帮助中心请求签名。查询和停止任务时，请使用提交任务时的项目。

请求体

参数	类型	必需	说明
`taskId`	String	是	提交成功后响应体中的 `result.taskId`。

以下 ID 仅展示格式；实际请求必须替换为本项目刚提交任务返回的 ID，不要直接复用文档中的固定 ID。

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

响应格式

响应体为 JSON，响应头 Content-Type: application/json。

字段	类型	说明
`errorCode`	Integer	0 表示查询请求成功。
`errorMessage`	String	错误消息，可能省略。
`taskId`	String	查询的任务 ID。
`code`	Integer	`0` 审核完成；`1` 审核失败或无可用完成结果；`2` 检测中；`3` 结果不可用。任务记录不存在还可能返回 HTTP 400 / 2109。
`result`	Integer	审核结论：`0` 通过，`1` 疑似，`2` 不通过。检测中或失败时该字段可能不存在，不能视为通过。
`videoSpams`	Array	返回的图片/音频证据片段，可能为空；查询按检出及标签条件过滤，不保证包含全部送检片段。
`detectedLang`	String	检测到的音频语种。
`durationMillis`	Integer	视频时长，毫秒；检测中可能为 0。
`audioText`	String	可用的音频转写文本。
`extra`	Object	提交时的透传数据；状态或错误响应可能省略。

`videoSpams[]`

以下为点播结果的片段字段，按媒体类型、策略和处理阶段返回；省略不等于零或审核通过。点播时间均相对视频起点。

片段数组可能按策略筛选，不应通过重算数组来替代顶层 result 审核结论。

字段	类型	说明
`type`	Integer	`1` 图片，`2` 音频。
`result`	Integer	片段审核结论：`0` 通过，`1` 疑似，`2` 不通过。
`taskId`	String	所属视频任务 ID。
`checkTaskId`	String	该片段下游审核任务标识；不可代替视频 `taskId` 查询，失败时可能缺失。
`beginTime`	Integer	片段开始时间，相对视频起点的毫秒数。
`endTime`	Integer	片段结束时间，相对视频起点的毫秒数。
`url`	String	对应图片/音频证据地址，可能按策略省略；不要假定音频一定没有 URL。
`text`	String	音频识别/命中文本；声纹或无转写结果时可能省略。
`vpr`	Boolean	音频是否命中声纹检测；按下游结果返回。
`speaker`	String	音频说话人标识。
`tags`	Array	审核分类，结构见下表。
`labels`	Array	图片识别标签，结构见下表。
`ocr`	String[]	图片 OCR 文本。

`tags[]`

字段	类型	说明
`tag`	Integer	一级分类编码；详见分类编码对照表。音频还可能返回音频专用分类。
`tagName / tagNameEn`	String	一级分类名称及英文名称，按下游结果返回。
`level`	Integer	`0` 正常，`1` 疑似，`2` 异常。
`subTags`	Array	二级分类数组，不是单个对象。

`subTags[]`

字段	类型	说明
`subTag`	Integer	二级分类编码。
`subTagName / subTagNameEn`	String	二级分类名称及英文名称。
`wordList`	String[]	命中详情，可能为空。

`labels[]`

字段	类型	说明
`id`	Integer	图像标签编号。
`name`	String	标签名称。
`score`	Integer	模型得分；取值范围由标签模型决定，不统一解释为 0～1 概率。

响应示例

检测中

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

审核完成

{
  "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": "示例命中文本",
      "tags": [
        {
          "tag": 160,
          "level": 2,
          "subTags": [
            {
              "subTag": 160001,
              "wordList": [
                "示例命中词"
              ]
            }
          ]
        }
      ]
    }
  ],
  "detectedLang": "zh-CN",
  "durationMillis": 10000,
  "extra": {
    "bizId": "vod-10001"
  }
}

时间相对视频起点，不是 Unix 时间戳。媒体详情及名称字段按实际结果可选返回。

结果保留期与 taskId 有效期

错误处理

参见错误码与处理建议。HTTP 状态、errorCode、任务状态 code 和审核结论 result 必须分别处理。