› 推特 ›阿里云技术文档›正文

CreateImageProcessTask_图片管理类操作_API手册_智能媒体管理

admin 阿里云技术文档 2020-02-11 220 0
阿里云服务器优惠

CreateImageProcessTask

描述

创建一个图片处理的任务。该任务需要一个图片类型的 project，目前为 PhotoStarter / PhotoProfessional。

请求参数

名称 类型 是否必填 描述
Project string 是 Project
Action String 是 CreateImageProcessTask
ImageUri string 是 图片 Uri
OSS 地址规则为：oss://bucket/object，其中 bucket 为和当前 Project 在同一区域的 OSS 桶名， object 为文件路径。
TargetList []Target 是 处理后的图片。可对同一图片做不同的处理。
NotifyTopicName String 否 异步通知的 TopicName
NotifyEndpoint String 否 异步反向通知的 Endpoint，作业处理状态可以通过该 Endpoint 异步通知到调用者

关于 MNS 的使用方式，参考 消息服务 MNS 概述

数据类型Target

IMM 参数 类型 是否必填 描述
Actions []String 否 需要的处理，和oss的图片处理参数统一，将每个“/”分割放在Actions数组中
TargetUri String 否 输出文件的OSS URI。

返回参数

名称 类型 描述
RequestId String 用户发送的每次接口调用请求，无论成功与否，系统都会返回一个唯一识别码 RequestId 给用户
TaskId String 该任务对唯一 ID
TaskType String Task 所属类型，固定值 ImageProcessTask

示例

请求示例

  1. POST https://imm.cn-shanghai.aliyuncs.com
  2. ?Action= CreateImageProcessTask
  3. &Project=test
  4. &ImageUri=oss://xxx/test/res.jpg
  5. &TargetList=[]

成功返回示例

  1. {
  2.   "RequestId": "10AFFE69-73BA-47C2-8A85-029AA9DA72A3", 
  3.   "TaskId": "ImageProcessTask-ffcdec0c-73ba-451a-bec4-a9fe3f4cd765", 
  4.   "TaskType": "ImageProcessTask"
  5. }

订阅消息返回示例

返回参数

Parameter Type Comment
eventName string 任务类型，返回固定值 ImageProcessTask 。
imm.TaskId string 任务唯一 ID
imm.Results json string 图片处理结果

MNS 返回的消息格式如：

  1. {
  2.     "events": [
  3.         {
  4.             "eventName": "ImageProcessTask",
  5.             "eventSource": "acs:imm",
  6.             "eventTime": "2019-02-20T11:06:25.264Z",
  7.             "eventVersion": "1.0",
  8.             "imm": {
  9.                   “Success”: “”,
  10.                   “CompressDuration”: “”,
  11.                   “Results”: “[{\”Success\”:\”true\”,\”TargetUri\”:\”oss://abc/p1.jpg\”,\”Reason\”:\”\”},{\”Success\”:\”true\”,\”TargetUri\”:\”oss://abc/p2.heic\”,\”Reason\”:\”\”}]”,
  12.                   “JobId”: “ImageProcessTask-f8ba005b-52d7-462e-bf1b-e9a36a62170b”,
  13.                   “ErrorCode”: “”,
  14.                   “SourceResolution”: “340x247”,
  15.                   “TaskId”: “ImageProcessTask-f8ba005b-52d7-462e-bf1b-e9a36a62170b”,
  16.                   “ImageUri”: “oss://imm-test-spark-cn-shanghai/test/tt/bmp1.bmp”,
  17.                   “SourceCodec”: “BMP3”
  18.                 }
  19.         }
  20.     ]
  21. }

若在使用中有疑问，请参考 FAQ，或者进入 钉钉用户群 实时交流。

版权声明

本文仅代表作者观点，不代表本站立场。
本文系作者授权发表，未经许可，不得转载。

评论

-----