本文档为您介绍图像裁剪ChangeImageSize的语法及示例。

功能描述

ChangeImageSize可以对输入的图片按照指定尺寸变换。支持自动判断主体区域位置,使用更好的裁剪方式对图片进行裁剪。

示意图如下:

前提条件

请确保您已开通图像生产服务,详情请参见服务开通

输入限制

  • 图片大小不超过3.5 MB。
  • 图像都必须是RGB 3通道。
  • 输入的内容图和风格图尺寸不得超过2000×2000像素。
  • URL地址中不能包含中文字符。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ChangeImageSize

要执行的操作。取值:ChangeImageSize。

Height Integer 600

目标高度,单位:像素。

Url String http://ivpd-demo.oss-cn-shanghai.aliyuncs.com/ivpd-demo/images/ChangeImageSize/change-image-size-src.png

图片URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL

Width Integer 800

目标宽度,单位:像素。

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。

RetainLocation Struct

原图数据在生成图像中的坐标信息。

Height Integer 224

输出根据指定高度等比缩放后的原图高度。单位:像素。

Width Integer 298

输出根据指定宽度等比缩放后的原图宽度。单位:像素。

X Integer 0

原图左上角x坐标。

Y Integer 0

原图左上角y坐标。

Url String http://ivpd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/upload/result_filter/2019-11-21/invi_filter_015743271470661000112_NVKmET.png?Expires=1574586347&OSSAccessKeyId=LTAI4FeJ8qKkYn6SrHhQ****&Signature=QqRAiqvyXsVlZ77M8yFc5QKJDE****

尺寸变换后的图片URL地址。

RequestId String 2833446F-A431-40EB-A502-6EC9DFEEEEB0

请求ID。

示例

请求示例

http(s)://imageenhan.cn-shanghai.aliyuncs.com/?Action=ChangeImageSize
&Height=600
&Url=http://ivpd-demo.oss-cn-shanghai.aliyuncs.com/ivpd-demo/images/ChangeImageSize/change-image-size-src.png
&Width=800
&<公共请求参数>

正常返回示例

XML 格式

<RequestId>00E74FE0-1A72-4995-A6BF-84B2F0C3DE99</RequestId>
<Data>
    <RetainLocation>
        <X>0</X>
        <Y>0</Y>
        <Height>224</Height>
        <Width>298</Width>
    </RetainLocation>
    <Url>http://viapi-cn-shanghai-dha-filter.oss-cn-shanghai.aliyuncs.com/upload/result_/2020-3-13/invi__015840697106921000105_c4TIab.jpg?Expires=1584071510&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=V0L6zLm2R6T5BBqBjjppeC7I%2BV****</Url>
</Data>

JSON 格式

{
	"RequestId": "00E74FE0-1A72-4995-A6BF-84B2F0C3DE99",
	"Data": {
		"RetainLocation": {
			"X": 0,
			"Y": 0,
			"Height": 224,
			"Width": 298
		},
		"Url": "http://viapi-cn-shanghai-dha-filter.oss-cn-shanghai.aliyuncs.com/upload/result_/2020-3-13/invi__015840697106921000105_c4TIab.jpg?Expires=1584071510&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=V0L6zLm2R6T5BBqBjjppeC7I%2BV****"
	}
}

错误码

关于图像裁剪的错误码,详情请参见常见错误码

SDK参考

单击SDK简介查看SDK信息。