通用2.0S模型,是原生中英文双语模型,模型在图文匹配度、美感上均有大幅提升。
推荐在通用类别(不局限于人像人体)、效果要求极高、延迟要求较高的场景进行使用。
强烈建议开启超分参数,开启后原输出宽高均会*2。
名称 | 内容 |
---|---|
接口地址 | |
请求方式 | POST |
Content-Type | application/json |
请求参数
(1)header请求参数
公共请求参数
以下请求参数列表仅列出了接口请求参数和必要公共参数,完整公共参数列表见 公共参数
名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
X-Date | String | 是 | 使用UTC时间,精确到秒。请使用格式: |
Authorization | String | 是 | HMAC-SHA256:签名方法 |
X-Security-Token | String | 否 | 指安全令牌服务(Security Token Service,STS) 颁发的临时安全凭证中的SessionToken,使用长期密钥时无需填写该参数。 |
(2)Query参数
业务请求参数
参数 | 可选/必选 | 类型 | 说明 |
---|---|---|---|
Action | 必选 | String | 接口名,取值:HighAesSmartDrawing |
Version | 必选 | String | 版本号,取值:2022-08-31 |
(3)Body参数
业务请求参数
参数 | 可选/必选 | 类型 | 说明 | 备注 |
---|---|---|---|---|
req_key | 必选 | String | 算法名称,取固定值为high_aes_general_v20 | |
prompt | 必选 | String | 用于生成图像的提示词 ,中英文均可输入 | |
model_version | 必选 | String | 模型版本名称,固定值:general_v2.0 | |
seed | 可选 | int | 随机种子,-1为不随机种子;其他为指定随机种子 | |
scale | 可选 | float | 影响文本描述的程度 | |
ddim_steps | 可选 | int | 生成图像的步数 | |
width | 可选 | int | 生成图像的宽,取值范围[256-680] | 宽、高与512差距过大,则出图效果不佳、延迟过长概率显著增加。
|
height | 可选 | int | 生成图像的高,取值范围[256-680] | |
use_sr | 可选 | Bool | True:文生图+AIGC超分 | 建议开启超分参数 |
return_url | 可选 | bool | 输出是否返回图片链接 | |
logo_info | 可选 | LogoInfo | 水印信息 |
LogoInfo
水印相关信息。
名称 | 类型 | 必选 | 描述 | 备注 |
---|---|---|---|---|
add_logo | Boolean | 否 | 是否添加水印。True为添加,False不添加。默认不添加 | |
position | Int | 否 | 水印的位置,取值如下: | |
language | Int | 否 | 水印的语言,取值如下: | |
opacity | Float | 否 | 水印的不透明度,取值范围0-1,1表示完全不透明,默认0.3 |
(4)请求示例
{ "req_key":"high_aes_general_v20", "prompt":"千军万马", "model_version":"general_v2.0", "seed":-1, "scale":3.5, "ddim_steps":16, "width":512, "height":512, "use_sr":True, "return_url":True, "logo_info": { "add_logo": False, "position": 0, "language": 0, "opacity": 0.3 } }
(1)通用输出参数
请参考通用返回字段及错误码
(2)业务输出参数
data 字段说明
字段 | 类型 | 说明 |
---|---|---|
binary_data_base64 | array of string | 返回图片的base64数组。 |
image_urls | array of string | 输出处理过的图片url |
(3)输出示例
{ "code": 10000, "data": { "algorithm_base_resp": { "status_code": 0, "status_message": "Success" }, "binary_data_base64": [], "image_urls": [ "https://xxx" ], "predict_tags_result": "", "rephraser_result": "壮观的场景,展现了千军万马。画面中,穿着衣服的士兵们身着铠甲,手持长矛,整齐划一地行进在大地上。他们的身后是蓝天白云,而前方则是无尽的草原。", "request_id": "0567fc0c9455fa1698df7c48687cb0cc45f7b73a9d87a3f2ae16d06212183aa5" }, "message": "Success", "request_id": "2024081617272268D32DE194F8F79A9B58", "status": 10000, "time_elapsed": "9.7982114s" }
(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等拦截 |