发起AI作画
POST
/ai/create发起AI作画
请求参数
模型code。
可通过获取作画模型列表(/ai/model_base_infos)
接口查询,获取对应列表接口返回的model_code
字段。
作画描述,1000字符以内,可选获取作画模型的预设资源(ai/default_resource)
接口预设的prompt来查看效果。
注意:
1.若未传底图(即init_image_url
为空)时,作画描述不能为空,该字段必填。
2.若传了底图,且作画描述为空,会自动获取图片的tag填充为prompt来进行图生图。
Validate[max: 1500; ]
作画负面描述,1000字符以内,可以补充不需要在图片里看到的内容。
注意:
- 无界AI的模型,基本都会预设一些默认的负面描述。
- 直接填内容即可,不需要再次否定。
Validate[max: 1000; ]
是否完全控制负向描述词,可选值:true、false,默认:false。
true:仅客户上定义的负面描述词会生效。
false:使用官方模型定义的负向描述。
批量生成的数量,默认1张,上限100张。
注:使用Midjourney模型创建的数量必须为4的倍数。
图片宽度。
注意:
使用controlnet(即使用pattern
字段)或者createSource=1时可不传,其余情况下必填。
支持自定义尺寸,尺寸要求为64的倍数,最小尺寸为64,尺寸不为64的倍数的,会向64对齐, 例96对齐64, 97对齐到128。
默认尺寸最长边限制在1344以内。
若使用精绘,长边需限制在1024以内,分辨率限制在1024*576以内。
图片高度。限制参考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)。
图片超分倍数,默认不超分,可传小数,取值范围为[1-4]。
注意:
- 宽高超分倍数一致,向下取整。例如宽高为512,超分1.9倍,出图宽高为972。
- 超分的额外耗时较短,效果仅是单纯提高图片分辨率,不会变更AI出图后的内容。
- ControlNet下该参数不需要指定,其超分由底图宽高决定(长边<=2048时,默认超分到2048,大于时,底图会被缩放到1024,再超分两倍)。
图片精绘倍数,默认不精绘,可传小数,取值范围为[1~2]。
精绘是另一种将图片放大的方式,需要重新绘制一遍图片,会有较长的额外耗时,在细节刻画上表现更出色,也会消耗更多积分。
注意:目前也支持精绘+超分组合使用(仅支持先精绘后超分),但仅支持2倍超分。
画面类型,限制数量不超过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。
模型特定参数(model为4),JSON格式,可选值:mask_image_url、mask_zone_image_url。
使用场景:涂抹(model为4):
- mask_image_url:涂抹底图。
- mask_zone_image_url:涂抹区域图。
加速前进的步数。
默认0,每加1就是往队列前面多插1位,一次对应2积分(批量作画的积分消耗则还要算上对应作画数量)。
角色同人,限制数量不超过10个。
可通过获取作画模型的预设资源(ai/default_resource)
接口查询,获取返回列表中的角色(character
-key
)字段。
模型融合,限制数量不超过5个。
可通过获取作画模型的预设资源(ai/default_resource)
接口查询,获取返回列表中的的融合模型(model_fusion
-key
)字段。
风格模型。
可通过获取作画风格模型的预设资源(/ai/default_resource_style_model)
接口查询,获取对应列表返回的key
字段。
ControlNet模式,不同的模型支持的模式列表略有不同。
可通过获取作画模型的预设资源(/ai/default_resource)
接口查询,获取返回列表中的(patterns
-name
)字段。
使用场景:当用户希望对模型出图加入更多的控制能力(如姿势、轮廓、深度)时,可加入ControlNet相关的参数。
可查看‘AI作画案例’页面的‘文生图采用ControlNet’了解相应参数信息。
预处理方式,用来对预处理图片进行处理。
- INVERT_SCRIBBLE:反色。
- FAKE_SCRIBBLE:假涂鸦。
- SCRIBBLE:预处理。
- NONE:无预处理。
采样步数(sampling steps),默认20。
注意:
- 随着步数的增大,可得到更精确的图像,但步数对出图耗时影响较大,过高会影响图片生成速度并产生扭曲。
- 支持输入自定义步长,根据超出预设步长倍数额外收取积分,详见收费规则介绍。
提示词相关性(CFG scale),取值范围[1-30],默认值7。
表示AI对描述参数的倾向程度,数值越大会越专注于提示词的内容,生成更加符合描述的图像。
采样模式(Sampler)是指扩散去噪算法的采样模式,如果设置正确,它们会发散并最终收敛。
不同模型支持的采样模式不同,可通过获取作画模型的预设资源(/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。
control模式权重,取值范围 [0~2]
是否开启controlNet-img2img(图生图)模式, 可选值:true、false。
注意: 该参数只在controlNet模式下生效
Control Mode(previously called Guess Mode),使用该参数可以控制哪方面更加重要,可选值:0、1、2。
0 - 平衡。
1 - prompt作画描述更重要。
2 - ControlNet更重要。
注意: 该参数只在controlNet模式下生效
multiDiffusion插件参数。
该插件的原理简单地说是将原有的图片变成拼图的碎片,每块拼图分别加以高清化的绘制,最后拼成一张大图片。(object)
平铺扩散(object)
平铺VAE(object)
回调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 - 积分花费说明
{"model":116,"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,"super_size_multiple":1.0,"prefine_multiple":1.0,"image_type":["超现实照片"],"style":["赛博朋克"],"artists":["鸟山明"],"element_magic":["星空法"],"style_decoration":["星空法"],"model_param":"{"mask_image_url":"https://cdn.wujiebantu.com/ai_init_image/FrpFxktR1_YBfHX93PVrMxl50atq.png","mask_zone_image_url":"https://cdn.wujiebantu.com/ai_init_image/Fg0EyeRKs3eViRcJyYVH_sIyaRr4.png"}","accelerate_times":2,"character":["c-机械朋克"],"model_fusion":[{"key":"mf-可爱的线条平涂风","weight":0.6}],"style_model":"stm-白瓷水墨","pattern":"CANNY","pretreatment_method":"NONE","steps":20,"cfg":7,"sampler_index":16,"seed":"-1","create_source":0,"clip_skip":5,"control_weight":1,"control_img2_img":true,"control_mode":0,"multi_diffusion":{"tiled_diffusion":{"enabled":true,"method":"MultiDiffusion","overwrite_size":false,"keep_input_size":false,"image_width":1024,"image_height":1024,"tile_width":96,"tile_height":96,"overlap":48,"tile_batch_size":4,"upscaler_name":"None","scale_factor":2.0,"noise_inverse":false,"noise_inverse_steps":10,"noise_inverse_retouch":1.0,"noise_inverse_renoise_strength":1.0,"noise_inverse_renoise_kernel":64,"control_tensor_cpu":true,"enable_bbox_control":false,"draw_background":false,"causal_layers":false,"bbox_control_states":[{"enabled":true,"x":0.4,"y":0.4,"w":0.2,"h":0.2,"prompt":"vcmmh2","neg_prompt":"uy1f5v","blend_mode":"Background","feather_ratio":0.2,"seed":-1}]},"tiled_vae":{"enabled":true,"encoder_tile_size":3072,"decoder_tile_size":192,"vae_to_gpu":true,"fast_decoder":true,"fast_encoder":true,"color_fix":true}},"hr_second_pass_strength":0.7,"notify_url":"www.tena-heathcote.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
}
}