文档首页 > > API参考> 视频内容审核> 创建作业

创建作业

分享
更新时间:2020/09/28 GMT+08:00

功能介绍

该接口用于创建视频内容审核的作业。

URI

  • URI格式
POST /v1/{project_id}/services/video-moderation/tasks
  • 参数说明

    名称

    是否必选

    类型

    说明

    project_id

    String

    服务所在区域对应的项目ID,获取方法请参见获取项目ID

请求消息

  • 示例
    POST /v1/6204a5bd270343b5885144cf9c8c158d/services/video-moderation/tasks  
     {    
         "taskName": "task-test",    
         "description": "description",    
         "input": {    
                "type": "obs",    
                "data": [    
                       {    
                         "bucket": "obs-iva",
                         "index": 0,    
                         "path": "input/demo.mp4"    
                       } 
                ]    
         },    
         "output": {    
                "obs": {    
                       "bucket": "obs-iva",    
                       "path": "output/"    
                },
           "hosting": {}    
         },    
         "serviceConfig": {    
                "common": {    
                       "frame_interval": 5,    
                       "categories": "porn,terrorism,politics",
                       "text_categories": "porn,politics",
                       "upload": "false",
                       "use_ocr": "true",
                       "use_sis": "true"  
                }    
         },    
        "serviceVersion":"1.2"    
     }
  • 参数说明

名称

是否必选

类型

说明

taskName

String

作业名称,只能由中文、字母(a~zA~Z)、数字(0~9)、中划线(-)、下划线(_)组成,长度范围为[1,100]。

description

String

作业描述信息,最大长度为500字符长度。

input

Object

视频数据的输入列表,目前只支持以下输入类型,且只支持一路输入,不支持多个OBS文件或URL:

  • obs:从华为云OBS中读取视频数据。
  • url:从指定的URL地址中读取视频数据。

详细参数定义参见task.input(任务输入参数)

output

Object

结果数据的输出列表,目前只支持以下输出类型:

  • obs:将结果输出到指定的OBS桶中。
  • hosting:结果将托管到服务侧的OBS,该OBS路径由服务指定,您可以通过调用查询单个作业API获取该路径。

详细参数定义参见task.output(任务输出参数)

serviceConfig

Object

服务算法配置,字段结构跟服务相关,目前配置项为common,详细参数定义参见serviceConfig.common字段结构...

serviceVersion

String

功能版本为“1.2”。

  • serviceConfig.common字段结构说明

参数

是否必选

类型

说明

frame_interval

Integer

截帧时间间隔,单位为秒/帧。

categories

String

视频检测场景。

  • politics:政治人物的检测。
  • terrorism:暴恐元素的检测。
  • porn:涉黄内容元素的检测。

可通过配置上述场景,来完成对应场景元素的检测,支持的详细场景请参见图像内容审核

text_categories

String

语音或文字审核服务的检测场景,目前支持默认场景和用户自定义场景:

默认场景支持以下五种:

  • politics:政治人物的检测。
  • porn:涉黄内容元素的检测。
  • ad:广告内容元素的检测。
  • abuse:辱骂内容元素的检测。
  • contraband:违禁品内容元素的检测。

当使用语音或文字检测服务时,这里应当设置出对应的场景,如果没有设置,默认会使用politics、porn两种场景。

用户自定义场景:需要用户自定义黑名单/白名单词库,自定义词库的创建和使用请参见配置自定义词库

use_sis

String

是否使用语音审核服务。

  • true:使用
  • false:不使用

当不设置该参数或参数为空时,默认为不使用。

use_ocr

String

是否使用文字审核服务。

  • true:使用
  • false:不使用

当不设置该参数或参数为空时,默认为不使用。

upload

String

是否使用问题场景图片上传服务。

  • true:使用
  • false:不使用

当不设置该参数或参数为空时,默认为不使用。

当使用该服务时,必须设置obs输出目录,否则图片无法上传。问题图片会自动上传至输出路径/task_id目录下。

响应消息

  • 响应示例
    [  
      {      "id": "taskef683016"   }  
    ]
  • 返回作业ID列表

    参数名称

    类型

    描述信息

    id

    String

    作业ID。

返回值

  • 正常

    201

  • 异常

    返回值

    说明

    400 Bad Request

    请求错误,具体返回错误码请参考错误码

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源。

    500 Internal Server Error

    服务内部错误。

    503 Service Unavailable

    服务不可用。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问