接口描述
支持自定义风格图+待处理图片进行风格迁移处理,自定义图片的风格,同时也提供30种艺术风格供选择,可用于开展趣味活动,或集成到美图应用中对图像进行风格转换。 以自定义风格为例示意图如下:
在线调试
您可以在 示例代码中心 中调试该接口,可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。
请求说明
请求示例
HTTP 方法:POST
请求URL: https://aip.baidubce.com/rest/2.0/image-process/v1/customize_stylization
URL参数:
参数 | 值 |
---|---|
access_token | 通过API Key和Secret Key获取的access_token,参考”Access Token获取” |
Header如下:
参数 | 值 |
---|---|
Content-Type | application/x-www-form-urlencoded |
Body中放置请求参数,参数详情如下:
请求参数
参数 | 是否必选 | 类型 | 可选值范围 | 说明 |
---|---|---|---|---|
image | 和url二选一 | string | - | base64编码后大小不超过4M,最短边至少50px,最长边最大4096px。注意:图片的base64编码是不包含图片头的,如(data:image/jpg;base64,) |
url | 和image二选一 | string | - | 图片完整URL,URL长度不超过1024字节,URL对应的图片base64编码后大小不超过4M,最短边至少50px,最长边最大4096px,长宽比4:1以内,支持jpg/png/bmp格式,当image字段存在时url字段失效。 |
style_id | 和style二选一 | int | 0<= style_id < 30 | 预设风格,共30个,具体图像风格样式可见下表,不超过已经提供默认风格数量,否则会报错。若自定义style字段已填写,则此字段可不填 |
style | 和syle_id二选一 | string | - | 自定义风格style,输入期望风格图像数据,Base64编码字符串,不超过4M,最短边至少50px,最长边最多4096px。支持图片格式:jpg/bmp/png。 若style_id字段已填写,则此字段可不填。 |
- 当style和style_id均填写时,则请求参数只读取style
style_id对应风格如下:
style_id | 风格样式 | style_id | 风格样式 | style_id | 风格样式 |
---|---|---|---|---|---|
0 | ![]() |
1 | ![]() |
2 | ![]() |
3 | ![]() |
4 | ![]() |
5 | ![]() |
6 | ![]() |
7 | ![]() |
8 | ![]() |
9 | ![]() |
10 | ![]() |
11 | ![]() |
12 | ![]() |
13 | ![]() |
14 | ![]() |
15 | ![]() |
16 | ![]() |
17 | ![]() |
18 | ![]() |
19 | ![]() |
20 | ![]() |
21 | ![]() |
22 | ![]() |
23 | ![]() |
24 | ![]() |
25 | ![]() |
26 | ![]() |
27 | ![]() |
28 | ![]() |
29 | ![]() |
请求代码示例
提示一:使用示例代码前,请记得替换其中的示例Token、图片地址或Base64信息。
提示二:部分语言依赖的类或库,请在代码注释中查看下载地址。
# 图像风格自定义 curl -i -k 'https://aip.baidubce.com/rest/2.0/image-process/
v1/customize_stylization?access_token=【调用鉴权接口获取的token】'
--data 'style_id=1&image=【图片Base64编码,需UrlEncode】
' -H 'Content-Type:application/x-www-form-urlencoded'
返回说明
返回参数
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
log_id | 是 | uint64 | 唯一的log id,用于问题定位 |
image | 否 | string | base64编码图片 |
返回示例
{
"log_id": "6876747463538438254",
"image": "处理后图片的Base64编码"
}