全部产品
云市场

CreateImageProcessTask

更新时间:2019-12-31 16:03:48

描述

创建一个图片处理的任务。该任务需要一个图片类型的 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,或者进入 钉钉用户群 实时交流。