发起透明图作画
POST
/ai/create/layerDiffusion根据输入的描述词直接生成透明图
请求参数
透明图。
注:
1.需使用透明图所支持的模型。[700-通用XL,701-MJXL,702-产品美学,703-人像XL]。
可通过/ai/default_resource
接口查询具体如何设值。(object)
模式
可通过`获取作画模型的预设资源(/ai/default_resource)`接口查询,字段路径:`data`->`support_patterns`->`layer_diffusion_pattern_methods`->`method_code` *
权重,取值范围[0,2],小数点后三位有效
stop at,取值范围[0,1],小数点后三位有效
透明图模型code,可使用code值:700、701、702、703
作画描述,1000字符以内。
可选平台资源接口预设的prompt来查看效果。
注:
1.若未传底图(即init_image_url
为空)时,作画描述不能为空。
2.若传了底图,且作画描述为空,会自动获取图片的tag填充为prompt来进行图生图。
Validate[max: 1500; ]
作画负面描述,1000字符以内,可以补充不需要在图片里看到的内容。
注:
- 无界AI的模型,基本都会预设一些默认的负面描述。
- 直接填内容即可,不需要再次否定。
Validate[max: 1000; ]
是否完全控制负向描述词,可选值:true、false,默认:false。
true:仅客户上定义的负面描述词会生效。
false:使用官方模型定义的负向描述。
批量生成的数量,默认1张,上限100张。
图片宽度。
注:
支持自定义尺寸,尺寸要求为64的倍数,最小尺寸为64,尺寸不为64的倍数的,会向64对齐, 例96对齐64, 97对齐到128。
默认尺寸最长边限制在1344以内。
若使用精绘,长边需限制在1024以内,分辨率限制在1024*576以内。
使用controlnet或者createSource=1时可不传,其余情况下必填。
图片高度。限制参考width。
图生图底图URL。
注:
- 图片大小要限制在2M以内,强烈建议提前压缩,图片大小不影响出图效果。
- 若使用七牛云地址,支持psd、jpeg、png、gif、webp、tiff、bmp、avif、heif格式的图片。
- 若为其他地址,仅支持jpg、png、webp、jpeg格式。外部链接的可用性和延迟需要客户自己保障,否则失败率会上升。如果是临时链接,建议有效期大于1个小时,以避免极端情况。
- 如果传了底图,但是prompt没传,会自动获取图片的tag填充为prompt来进行图生图。
- 使用ControlNet时必填,为保证作图质量,ControlNet所做图片会保证最长边分辨率最低为2048,短边等比调整。
底图宽度。
建议和输入底图的宽度保持一致,不一致时平台按此值计算。
注:使用ControlNet或createSource=1时必填。
底图高度。
建议和输入底图的高度保持一致,不一致时平台按此值计算。
注:使用ControlNet时或createSource=1时必填。
创意度/二次元强度,默认50,取值范围为[0-100]。
创意度越低,生成的图片越接近参考图。
注:
- 使用底图(即
init_image_url
有值)时才会生效。 - 对应模型中的参数为去噪强度(denoising strength)。
画面类型,限制数量不超过10个。
可通过获取作画模型的预设资源(ai/default_resource)
接口查询,获取返回列表中的画面类型(image_type
-name
)字段。
风格,限制数量不超过10个。
可通过获取作画模型的预设资源(ai/default_resource)
接口查询,获取返回列表中的风格(style
-name
)字段。
艺术家,支持传入多个,优先于artist,限制数量不超过10个。
可通过获取作画模型的预设资源(ai/default_resource)
接口查询,获取返回列表中的艺术家(artist
-name
)字段。
元素魔法,限制数量不超过10个。
可通过获取作画模型的预设资源(ai/default_resource)
接口查询,获取返回列表中的元素魔法(element_magic
-key
)字段。
风格选择参数,限制数量不超过10个。
可通过获取作画模型的预设资源(ai/default_resource)
接口查询,获取返回列表中的元素魔法(style_decoration
-key
)字段。
imageType,style,artist,elementMagic本质上也都属于styleDecoration。
加速前进的步数。
默认0,每加1就是往队列前面多插1位,一次对应2积分(批量作画的积分消耗则还要算上对应作画数量)。
模型融合,限制数量不超过5个。
可通过获取作画模型的预设资源(ai/default_resource)
接口查询,获取返回列表中的的融合模型(model_fusion
-key
)字段。
采样步数(sampling steps),默认20。
注:
- 随着步数的增大,可得到更精确的图像,但步数对出图耗时影响较大,过高会影响图片生成速度并产生扭曲。
- 支持输入自定义步长,根据超出预设步长倍数额外收取积分,详见收费规则介绍。
提示词相关性(CFG scale),取值范围[1-30],默认值7。
表示AI对描述参数的倾向程度,数值越大会越专注于提示词的内容,生成更加符合描述的图像。
采样模式(Sampler)是指扩散去噪算法的采样模式,如果设置正确,它们会发散并最终收敛。
不同model支持的采样模式不同,可通过获取作画模型的预设资源(/ai/default_resource)
接口查询,获取返回信息列表中的采样模型(sampler_models
-sampler_index
)字段。
随机种子,生成图片的seed,默认-1随机生成。
通过随机种子确定扩散的初始状态,进而控制生成的样本的多样性。
相同的种子值可以保持图像的一致性,若设置相同的种子编号、模型,可以重新生成类似的图像。
注:目前不支持字母,传字母会导致作画超时或失败。
图生图模式,默认0。
0 - 自定义尺寸,需要自定义出图宽高、超分、精绘(width height superSizeMultiple prefineMultiple)。
1 - 自动尺寸,需要指定底图宽高(initWidth initHeight),系统会忽略上述自定义参数,根据底图自动计算出图宽高(如果底图长边小于2048,会保证出图长边为2048,短边则按底图比例求得;反之,则出图尺寸与底图相同)。
两种模式下均可以不传prompt,此时会自动获取图片的tag作为prompt。
画面描述匹配度,取值范围 [1~12] (DD不支持)。
描述画面的准确程度与数值大小成反比,数值越小表示对图像的控制度越高,最佳使用区间为1-2。
回调url
回调重试规则:
- 支持5级重试时间: 5, 10, 30, 60, 120 (单位:秒),也就是分别会在5s、10s、30s...时进行回调重试
- 当回调通知方返回"success"时,我们会认为您已经成功处理回调,并终止重试
回调报文:
包含字段注释:{ "artwork_url": "https://cdn.wujiebantu.com/ai/530FFE6722D2A2B4A9504166221AAB40-01.jpg", "audit_info": { "check_fail": false, "hit": false, "data_id": "245959", "total_suggestion": "PASS", "scan_scene_d_t_o_s": [{ "rate": 0.9944, "suggestion": "pass", "label": "politics", "label_desc": "涉政", "scene": "TERRORISM" }, { "rate": 1, "suggestion": "pass", "label": "terrorism", "label_desc": "暴恐", "scene": "TERRORISM" }, { "rate": 0.9993, "suggestion": "pass", "label": "porn", "label_desc": "色情", "scene": "PORN" }, { "rate": 1, "suggestion": "pass", "label": "prohibition", "label_desc": "违禁", "scene": "TERRORISM" }, { "rate": 0.9986, "suggestion": "pass", "label": "sexy", "label_desc": "性感", "scene": "PORN" } ], "url": "https://cdn.wujiebantu.com/ai/810F1750EFF2EC416ED6682DFFCFBF2C-01.jpg-v800" }, "batch_task_key": "14DBBD0743C8715D92183756E3FB398C", "code": 0, "complete_time": 1681109462, "integral_cost": 2, "integral_cost_message": "积分已扣除", "involve_yellow": 0, "key": "EF8DF2DCF18D0D69F7F836A100C857AF", "success": true }
success - 作画是否成功
code - 作画是否成功code,0=成功 1=失败
key - 对应作画任务的key
artwork_url - 作画生成结果图url
complete_time - 作画完成时间
integral_cost - 积分花费
integral_cost_message - 积分花费说明
{
"layer_diffusion": {
"method": 2,
"weight": 1,
"ending_step": 1
},
"model": 700,
"prompt": "夜幕下的赛博朋克城市",
"uc_prompt": "低分辨率,不良解剖结构,文本,低质量,(突变,绘制不良:1.2),肥胖,不良比例",
"fully_custom_uc_prompt": true,
"num": 1,
"width": 512,
"height": 512,
"init_image_url": "https://cdn.wujiebantu.com/ai/C837D53F842A48AEDFA7DA2976D834FE-01.png",
"init_width": 512,
"init_height": 512,
"creativity_degree": 50,
"image_type": [
"超现实照片"
],
"style": [
"赛博朋克"
],
"artists": [
"鸟山明"
],
"element_magic": [
"星空法"
],
"style_decoration": [
"星空法"
],
"accelerate_times": 2,
"model_fusion": [
{
"key": "mf-可爱的线条平涂风",
"weight": 0.6
}
],
"steps": 20,
"cfg": 7,
"sampler_index": 16,
"seed": "-1",
"create_source": 0,
"clip_skip": 5,
"notify_url": "www.isidro-stehr.com"
}
示例代码
返回响应
OK
返回数据(object)
作画结果result列表
{
"code": "200",
"message": "success",
"data": {
"keys": "C5B5FE8DBF3679D9049342C130341BD9",
"results": [
{
"key": "C5B5FE8DBF3679D9049342C130341BD9",
"expected_second": 12,
"batch_task_key": "14DBBD0743C8715D92183756E3FB398C"
}
],
"expected_integral_cost": 2
}
}