描述

传入一张图片,根据用户输入的预期裁剪比例,通过 AI 计算给出适合的裁剪框位置。该功能不依赖媒体集 Set

请求参数

Parameter Type Required Comment
Project string Y Project
ImageUri string Y 图片 OSS URI,如 oss://imm-test/testcases/cropping.jpg

OSS 地址规则为:oss://bucket/object,其中 bucket 为和当前 Project 在同一区域的 OSS 桶名, object 为文件路径。

AspectRatios string Y 希望的裁剪比例列表,格式如:["1:1","2:3"],仅支持整数比例

返回参数

Parameter Type Comment
RequestId string 该次请求的唯一识别码。
ImageUri string 图片 URI
CroppingSuggestions string []CroppingSuggestion(数据类型CroppingSuggestion)
数据类型 CroppingSuggestion
Parameter Type Comment
Score float 该裁剪方案的美学分数,越高表示该方案效果越好,0~1
AspectRatio string 裁剪比例
CroppingBoundary Boundary 裁剪框

示例

请求示例

POST https://imm.cn-shanghai.aliyuncs.com
?Action=GetImageCroppingSuggestions
&Project=test-project
&ImageUri=oss://imm-test/testcases/crop.jpg
&AspectRatios=["1:1","2:3"]
...
            

此处的示例,目的是展示关键参数,还需要其他的公共参数才能正常调用,推荐使用SDK来发送API

成功返回示例

{
  "RequestId": "F3FC0F19-569E-43AC-BAB5-62CFB1EB20C5",
  "ImageUri": "oss://imm-test/testcases/crop.jpg",
  "CroppingSuggestions": [
    {
      "AspectRatio": "1:1",
      "Score": 0.14999999999999997,
      "CroppingBoundary": {
        "Left": 0,
        "Top": 504,
        "Height": 3024,
        "Width": 3024,
      }
    },
    {
      "AspectRatio": "2:3",
      "Score": 0.17738095238095233,
      "CroppingBoundary": {
        "Left": 162,
        "Top": 0,
        "Height": 4032,
        "Width": 2682
    }
  ]
}
            

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