本文介绍图像生产（imageenhan）类目下的风格迁移ExtendImageStyle的语法及示例。
服务说明
由于产品业务调整，风格迁移服务于 即日起停止新用户开通调用，历史开通过该服务的老用户可继续调用，2026年04月20日后该服务将下架，不再支持新老用户调用，请尽早寻找替代方案。如果对风格迁移 API 服务使用有疑问，可通过搜索钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。
功能描述
风格迁移能力可以对输入图像的风格进行转换，使得图像的色彩、笔触等视觉风格发生转化。
关于该接口功能的示例图如下：
- 您可以进入在线咨询获取在线人工帮助。
- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。
输入限制
- 图像格式：JPEG、JPG、BMP、PNG。
- 图像大小：不超过3 MB。
- 图像分辨率：小于1200×1200像素。
- 图像都必须是RGB 3通道。
- URL地址中不能包含中文字符。
计费说明
关于风格迁移的计费方式及报价，请参见计费介绍。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
|
名称 |
类型 |
是否必选 |
示例值 |
描述 |
| Action | String | 是 | ExtendImageStyle | 系统规定参数。取值：ExtendImageStyle。 |
| StyleUrl | String | 是 | http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageenhan/ExtendImageStyle/ExtendImageStyle6.jpg | 风格图片URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见文件URL处理。 |
| MajorUrl | String | 是 | http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageenhan/ExtendImageStyle/ExtendImageStyle1.jpg | 内容图片URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见文件URL处理。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
| RequestId | String | F1ABC965-2612-4680-9DE3-B5C77434B9B7 | 请求ID。 |
| Data | Object | 返回的结果数据内容。 |
|
| Url | String | http://luban-vgd-invi.oss-cn-hangzhou.aliyuncs.com/upload/result_/2019-9-26/invi__015694889247201016812_spCq4n.jpg?Expires=1569492524&OSSAccessKeyId=LTAI****************&Signature=uOEP8gKvdgPtDcrXxRz1v37dsT**** | 进行风格化的结果图片URL地址，图片格式：PNG。 说明 该URL地址为临时地址，有效期为30分钟，过期后将无法访问。若需要长时间或者永久保存文件，请在30分钟内访问URL地址，下载文件转存到自己的OSS或者其他存储空间。 |
| MajorUrl | String | - | 由于版本升级，该字段废弃，不返回结果。 |
SDK参考
阿里云视觉AI图像生产类目下的风格迁移能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为图像生产（imageenhan）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见SDK总览。
示例代码
该能力常用语言的示例代码，请参见风格迁移示例代码。
示例
请求示例
http(s)://imageenhan.cn-shanghai.aliyuncs.com/?Action=ExtendImageStyle //更多关于访问域名（Endpoint）信息，请参见：https://help.aliyun.com/document_detail/143103.html
&StyleUrl=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageenhan/ExtendImageStyle/ExtendImageStyle6.jpg
&MajorUrl=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageenhan/ExtendImageStyle/ExtendImageStyle1.jpg
&公共请求参数正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ExtendImageStyleResponse>
<RequestId>F1ABC965-2612-4680-9DE3-B5C77434B9B7</RequestId>
<Data>
<Url>http://luban-vgd-invi.oss-cn-hangzhou.aliyuncs.com/upload/result_/2019-9-26/invi__015694889247201016812_spCq4n.jpg?Expires=1569492524&OSSAccessKeyId=LTAI****************&Signature=uOEP8gKvdgPtDcrXxRz1v37dsT****</Url>
<MajorUrl>-</MajorUrl>
</Data>
</ExtendImageStyleResponse>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "F1ABC965-2612-4680-9DE3-B5C77434B9B7",
"Data" : {
"Url" : "http://luban-vgd-invi.oss-cn-hangzhou.aliyuncs.com/upload/result_/2019-9-26/invi__015694889247201016812_spCq4n.jpg?Expires=1569492524&OSSAccessKeyId=LTAI****************&Signature=uOEP8gKvdgPtDcrXxRz1v37dsT****",
"MajorUrl" : "-"
}
}错误码
关于风格迁移的错误码，详情请参见常见错误码。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。