接口文档--人像漫画风-火山引擎

文档中心

导航

接口文档

最近更新时间：2022.01.06 18:20:53首次发布时间：2021.02.23 10:42:15

接入指引

请先查看接入指引了解具体接入方式，再参考此文档完成接入。

请求API

名称	内容
请求方式	POST
Content-Type	application/x-www-form-urlencoded
图片要求	1. 图片格式：JPG、JPEG、PNG、BMP等常见格式，建议使用JPG格式。 2. 图片文件大小：最大 5 MB。

输入参数

Query参数：

参数	可选/必选	类型	说明
Action	必选	String	接口名，取值：JPCartoon
Version	必选	String	版本号，取值：2020-08-26

Body参数：

参数	可选/必选	类型	说明
image_base64	必选	String	图片文件，base64编码
cartoon_type	可选	String	漫画类型
rotation	可选	int	仅在漫画类型为`jpcartoon_head`时生效，控制漫画图旋转

备注

接口支持cartoon_type通过参数配置漫画图种类。其中除jpcartoon_head以外，其他能力也支持不包含人脸的输入图片。目前支持的漫画种类如下：

jpcartoon_head：人像日漫风（默认）
jpcartoon：全图日漫风
hkcartoon：国潮风
classic_cartoon：复古漫画风
tccartoon：萌漫风

接口支持通过rotaion参数配置是否进行漫画图旋转，仅在cartoon_type为jpcartoon_head时生效。0为漫画图有可能旋转（默认），1为漫画图不会旋转。

API返回

通用返回字段说明

请参考通用返回字段及错误码

data 字段说明

字段	类型	说明	备注
image	string	变换后的漫画图，返回图片的Base64编码
clip	string	经裁剪后的原图，返回图片的Base64编码。此字段仅在cartoon_type为`jpcartoon_head`时会返回。

错误码

HttpCode	错误码	错误消息	描述
200	10000	无	请求成功
400	60101	"Image Decode Error: image format unsupported."	图像解析错误
400	60102	"Invalid Input Parameters: no face detected in image"	图片中未找到人脸，仅在cartoon_type为`jpcartoon_head`时生效。
400	60103	"Missing Input Parameters: empty input image"	缺少输入图片
400	60106	"Invalid Input Parameters: input Image Damaged"	输入图片损坏

其他错误码请参考通用返回字段及错误码

返回值示例

{
    "code":10000,
    "data":{
        "image": "",
        "clip": ""
    },
    "message":"Success",
    "request_id":"6838889517957515275",
    "time_elapsed":"41.897331ms"
}