You need to enable JavaScript to run this app.
导航
人像人体
  • 文档首页
    • /人像人体/人像编辑/AIGC图像风格化/3D-游戏_Z时代/动画电影/玩偶
3D-游戏_Z时代/动画电影/玩偶
最近更新时间：2024.10.29 19:05:06首次发布时间：2024.09.04 19:31:10
我的收藏

接口简介

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

Demo展示

Image

3D-游戏_Z时代.zip
未知大小

动画电影.zip
未知大小

玩偶.zip
未知大小

请求说明

名称

内容

接口地址

https://visual.volcengineapi.com

请求方式

POST

Content-Type

application/json

限制条件

名称

内容

图片要求

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

Header参数

完整公共参数列表见 公共参数
本服务Region为cn-north-1； Service为cv

Query参数

拼接到url后的参数，示例：https://visual.volcengineapi.com?Action=CVProcess&Version=2022-08-31

参数

可选/必选

类型

说明

Action

必选

String

接口名，固定值：
CVProcess

Version

必选

String

版本号，固定值：2022-08-31

Body参数

业务请求参数，放到request.body中，MIME-Type为application/json

参数

可选/必选

类型

说明

req_key

必选

String

算法名称，取固定值为img2img_3d_style

sub_req_key

必选

String

3D-游戏_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

logo_text_content

String

否

明水印自定义内容

输出说明

通用输出参数

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

业务输出参数

重点关注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, 
        "logo_text_content": "这里是明水印内容"
    }
}

返回示例：

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

SDK使用说明

请参考SDK使用说明