You need to enable JavaScript to run this app.
导航
Z时代/动画电影/玩偶
最近更新时间:2024.09.12 11:33:01首次发布时间:2024.09.04 19:31:10

接口简介

本文档介绍AIGC图片风格转化的能力接入说明,这项技术能够将输入的人像图片转换成Z时代/动画电影/玩偶的输出作品。

Demo展示

Z时代
图片
动画电影
图片
玩偶
图片

请求说明

名称

内容

接口地址

https://visual.volcengineapi.com

请求方式

POST

Content-Type

application/json

限制条件

名称

内容

图片要求

  1. 图片格式:jpg/jpeg/png,其他暂不支持
  2. 图片大小:5MB以下,256*256以上
  3. 图片质量要求:人脸图像高清不模糊

请求参数

Header参数
完整公共参数列表见 公共参数
Query参数

参数

可选/必选

类型

说明

Action

必选

String

接口名,固定值:
CVProcess

Version

必选

String

版本号,固定值:2022-08-31

Body参数

参数

可选/必选

类型

说明

req_key

必选

String

算法名称,取固定值为img2img_3d_style

sub_req_key

必选

String

Z时代:img2img_3d_style_era
动画电影:img2img_3d_style_movie
玩偶:img2img_3d_style_doll

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

水印的位置,取值如下:
0-右下角
1-左下角
2-左上角
3-右上角
默认0

language

Int

水印的语言,取值如下:
0-中文(AI生成)
1-英文(Generated by AI)
默认0

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等拦截