通用1.4-文生图--人像人体-火山引擎

文档中心

导航

通用1.4-文生图

最近更新时间：2024.12.11 15:22:37首次发布时间：2024.06.13 18:00:36

接口简介

通用V1.4文生图模型，是原生中英文双语模型，在效果在内的多项指标显著提升，并已在字节内部业务广泛应用。推荐在通用类别、效果要求较高、延迟要求较高的场景进行使用。

请求说明

名称	内容
接口地址	https://visual.volcengineapi.com
请求方式	POST
Content-Type	application/json

完整公共参数列表见公共参数
本服务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	算法名称，取固定值为high_aes_general_v14
prompt	必选	String	用于生成图像的提示词，中英文均可输入
model_version	必选	String	模型版本名称取固定值为 general_v1.4
seed	可选	int	随机种子，-1为不随机种子；其他为指定随机种子默认值：-1
scale	可选	float	影响文本描述的程度默认值：3.0 取值范围[1, 30]
ddim_steps	可选	int	生成图像的步数默认值：25 取值范围[1-50]
width	可选	int	生成图像的宽默认值：512，取值范围[128-768]	宽、高与512差距过大，则出图效果不佳、延迟过长概率显著增加。超分前建议比例及对应宽高：widthheight 1:1：512512 4:3：512384 3:4：384512 3:2：512341 2:3：341512 16:9：512288 9:16：288512
height	可选	int	生成图像的高默认值：512，取值范围[128-768]
use_rephraser	可选	bool	开启中文prompt扩写默认值：True
return_url	可选	bool	输出是否返回图片链接（链接有效期为1小时）
use_predict_tags	可选	bool	开启predict_tags 默认值：True
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
logo_text_content	String	否	明水印自定义内容

输出说明

通用输出参数

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

业务输出参数

重点关注data 字段，其他字段为公共返回

字段	类型	说明
binary_data_base64	array of string	返回图片的base64数组。
image_urls	array of string	输出处理过的图片url 数组（单张图）

请求&返回完整示例

请求示例

{
    "req_key": "high_aes_general_v14",
    "prompt": "千军万马",
    "model_version": "general_v1.4",
    "seed": -1,
    "scale": 3.0,
    "ddim_steps": 25,
    "width": 512,
    "height": 512,
    "use_rephraser": True,
    "return_url":False,
    "use_predict_tags": True,
    "logo_info": {
        "add_logo": False,
        "position": 0,
        "language": 0,
        "opacity": 0.3,
        "logo_text_content": "这里是明水印内容"
    }
}

输出示例

{
    "code": 10000,
    "data": {
        "algorithm_base_resp": {
            "status_code": 0,
            "status_message": "Success"
        },
        "binary_data_base64": ["xxx"],
        "predict_tags_result": "",
        "rephraser_result": "",
        "request_id": ""
    },
    "message": "Success",
    "request_id": "2024061214082851989A35E4283DB7C8AD",
    "status": 10000,
    "time_elapsed": "16.52978614s"
}

错误码

通用错误码