本文档介绍AIGC图片风格转化的能力接入说明,这项技术能够将输入的人像图片转换成Z时代/动画电影/玩偶的输出作品。
Z时代
动画电影
玩偶
名称 | 内容 |
---|---|
接口地址 | |
请求方式 | POST |
Content-Type | application/json |
名称 | 内容 |
---|---|
图片要求 |
|
Header参数
完整公共参数列表见 公共参数
Query参数
参数 | 可选/必选 | 类型 | 说明 |
---|---|---|---|
Action | 必选 | String | 接口名,固定值: |
Version | 必选 | String | 版本号,固定值:2022-08-31 |
Body参数
参数 | 可选/必选 | 类型 | 说明 | |
---|---|---|---|---|
req_key | 必选 | String | 算法名称,取固定值为img2img_3d_style | |
sub_req_key | 必选 | String | Z时代:img2img_3d_style_era | |
binary_data_base64 | 可选 | array of String | 如果需要传图,与image_urls二选一传入 | |
image_urls | 可选 | array of String | 如果需要传图,与binary_data_base64二选一传入 | |
return_url | 可选 | bool | 如果为true,则输出参数不再返回binary_data_base64,而是图片的url | |
logo_info | 可选 | LogoInfo | 水印信息 |
LogoInfo
水印相关信息。
名称 | 类型 | 必选 | 描述 | 备注 |
---|---|---|---|---|
add_logo | Boolean | 否 | 是否添加水印。True为添加,False不添加。默认不添加 | |
position | Int | 否 | 水印的位置,取值如下: | |
language | Int | 否 | 水印的语言,取值如下: | |
opacity | Float | 否 | 水印的不透明度,取值范围0-1,1表示完全不透明,默认0.3 |
(1)通用返回参数
请参考通用返回字段及错误码
(2)业务返回参数
data 字段说明
字段 | 类型 | 说明 |
---|---|---|
binary_data_base64 | array of string | 返回图片的base64数组。 |
image_urls | array of string | 输出处理过的图片url |
请求示例:
{ "req_key": "img2img_3d_style", "sub_req_key":"img2img_3d_style_era", "image_urls": [ "https://xxx" ], // "binary_data_base64":[], "return_url": True, "logo_info": { "add_logo": True, "position": 2, "language": 0, "opacity": 1.0 } }
返回示例:
{ "code": 10000, "data": { "SaveImage_935": [ "uri://binary_data?index=0" ], "algorithm_base_resp": { "status_code": 0, "status_message": "Success" }, "binary_data_base64": [], "comfyui_cost": 5, "image_urls": [ "https://xxx" ] }, "message": "Success", "request_id": "20240904180441C5D6EE24B449448EB683", "status": 10000, "time_elapsed": "7.624110469s" }
(1)通用错误码
请参考通用返回字段及错误码
(2)业务错误码
HttpCode | 错误码 | 错误消息 | 描述 |
---|---|---|---|
200 | 10000 | 无 | 请求成功 |
400 | 50411 | Pre Img Risk Not Pass | 输入图片前审核未通过 |
400 | 50511 | Post Img Risk Not Pass | 输出图片后审核未通过 |
400 | 50412 | Text Risk Not Pass | 输入文本前审核未通过 |
400 | 50512 | Post Text Risk Not Pass | 输出文本后审核未通过 |
400 | 50413 | Post Text Risk Not Pass | 输入文本NER、IP、Blocklist等拦截 |