发起AI作画
POST/ai/pro/create发起AI作画
请求参数
模型code，可通过获取模型列表(/ai/pro/model_base_infos)接口查询，字段路径：data->model_code
作画描述，1000字符以内
可选获取作画模型的预设资源(ai/default_resource)接口预设的prompt来查看效果。
Validate[max: 1000; ]
图片宽
注意：
支持自定义尺寸，尺寸要求为64的倍数，最小尺寸为64，尺寸不为64的倍数的，会向64对齐，例96对齐64，97对齐到128。
默认尺寸最长边限制在1344以内。
若使用精绘，长边需限制在1024以内，分辨率限制在1024*576以内。
使用cutdiffion单边范围为【1088，3072】,分辨率乘积不超过5017600。
图片高
支持自定义尺寸，同宽度
图片超分倍数，默认不超分，可传小数，取值范围为[1-4]。
宽高超分倍数一致，向下取整。
超分的额外耗时较短，效果仅是单纯提高图片分辨率，不会变更AI出图后的内容。
注意：
ControlNet下该参数不需要指定，其超分由底图宽高决定（长边<=2048时，默认超分到2048，大于时，底图会被缩放到1024，再超分两倍）。
图片精绘倍数，默认不精绘，可传小数，取值范围为[1~2]。
精绘是另一种将图片放大的方式，需要重新绘制一遍图片，会有较长的额外耗时，在细节刻画上表现更出色，也会消耗更多积分。
注：目前也支持精绘+超分组合使用（仅支持先精绘后超分），但仅支持2倍超分。
批量生成的数量。默认1张，上限100张。
选项参数(object)
模型融合，可通过获取作画模型的预设资源(ai/default_resource)接口查询，字段路径：data->create_option_menu->model_fusion->key。
角色同人，可通过获取作画模型的预设资源(ai/default_resource)接口查询，字段路径：data->create_option_menu->character-key。
高级参数(object)
作画负面描述，1000字符以内，可以补充不需要在图片里看到的内容
注：
- 无界AI的模型，基本都会预设一些默认的负面描述。
- 直接填内容即可，不需要再次否定
Validate[max: 1000; ]
是否开启面部修复，可选值：true、false，默认false
true：开启
false：不开启
是否开启无缝贴图，可选值：true、false，默认false
true：开启
false：不开启
生成图片的seed，默认-1随机生成
通过随机种子确定扩散的初始状态，进而控制生成的样本的多样性
相同的种子值可以保持图像的一致性，若设置相同的种子编号、模型，可以重新生成类似的图像。
注：目前不支持字母，传字母会导致作画超时或失败
VAE文件
可选值[7]：auto, Anything-V3.0.vae.pt, animevae.pt,kl-f8-anime2.vae.pt, orangemix.vae.pt, pastel-waifu-diffusion.vae.pt, vae-ft-mse-840000-ema-pruned.ckpt
默认值：auto
Validate[regexp: auto|Anything-V3\.0\.vae\.pt|animevae\.pt|kl-f8-anime2\.vae\.pt|orangemix\.vae\.pt|pastel-waifu-diffusion\.vae\.pt|vae-ft-mse-840000-ema-pruned\.ckpt; ]
CFG scale, 提示词相关性，表示AI对描述参数的倾向程度，数值越大会越专注于提示词的内容，生成更加符合描述的图像。
默认7，取值范围为[1-30]
采样步数，默认20步
随着步数的增大，可得到更精确的图像，但步数对出图耗时影响较大，过高会影响图片生成速度并产生扭曲。
支持输入自定义步长，根据超出预设步长倍数额外收取积分，详见收费规则介绍
采样模式
是指扩散去噪算法的采样模式，如果设置正确，它们会发散并最终收敛
不同model支持的采样模式不同，可通过获取作画模型的预设资源(/ai/default_resource)接口查询，字段路径：data->create_option_menu->sampler_models->sampler_index
画面描述匹配度，取值范围 [1～12] (DD不支持)
描述画面的准确程度与数值大小成反比，数值越小表示对图像的控制度越高，最佳使用区间为1-2。
Eta noise seed delta，eta噪声种子增量
精绘参数(object)
图生图参数(object)
底图URL
- 图片大小要限制在2M以内，强烈建议提前压缩，图片大小不影响出图效果
- 若使用七牛云地址，支持psd、jpeg、png、gif、webp、tiff、bmp、avif、heif格式的图片
- 若为其他地址，仅支持jpg、png、webp、jpeg格式。外部链接的可用性和延迟需要客户自己保障，否则失败率会上升。如果是临时链接，建议有效期大于1个小时，以避免极端情况
注：使用ControlNet时必填，为保证作图质量，ControlNet所做图片会保证最长边分辨率最低为2048，短边等比调整
创意度/二次元强度，默认50，取值范围为[0-100]
创意度越低，生成的图片越接近参考图
注：
- 对应模型中的参数为去噪强度（denoising strength）
缩放模式，取值：0、1、2，默认值：0
0 - 仅调整大小
1 - 剪裁后缩放
2 - 缩放后填充空白
ControlNet参数
type code，controlnet条件
可通过Get获取条件生图模式列表(/ai/pro/controlNetOption)接口查询，字段路径：data->code
preprocessor code，预处理器
可通过Get获取条件生图模式列表(/ai/pro/controlNetOption)接口查询，字段路径：data->preprocessor->code
model code，controlnet模型选择
可通过Get获取条件生图模式列表(/ai/pro/controlNetOption)接口查询，字段路径：data->model->code
模型控制模式，可选值：0、1、2
0-平衡
1-prompt作画描述优先
2-control_net优先
预处理输入尺寸，选择特定预处理器下使用
取值范围可通过Get获取条件生图模式列表(/ai/pro/controlNetOption)接口查询，字段路径：data->preprocessor->resolution
预处理阈值a，选择特定预处理器下使用
取值范围可通过Get获取条件生图模式列表(/ai/pro/controlNetOption)接口查询，字段路径：data->preprocessor->threshold_a
预处理阈值b，选择特定预处理器下使用
取值范围可通过Get获取条件生图模式列表(/ai/pro/controlNetOption)接口查询，字段路径：data->preprocessor->threshold_b
参考图缩放模式，取值：0、1、2
0 - 仅调整大小
1 - 剪裁后缩放
2 - 缩放后填充空白
像素对齐，可选值：true、false
true：是
false：否
修复蒙版插件参数(object)
是否开启 可选值：true、false，默认true
true：开启
false：不开启
蒙版图（黑白图（白色区域为涂抹的位置））
给遮罩添加高斯模糊效果，使得遮罩的边缘更加光滑
默认值4，取值范围[0,64]
修复算法，填充空白区域，以进行去除物体、修复划痕等操作
取值范围[0,3]，默认值为1
0 - fill：使用周边的像素信息来生成填充内容
1 - original：保留原始内容，不进行任何填充或修改
2 - latent noise：用于向图像或视觉效果添加一种随机性或变异性，增加图像的真实感、细节或多样性
3 - latent nothing：清空选定区域
修复遮罩反转，取值范围[0,1]，默认值为0
0 - 对遮罩的区域进行修复或填充
1 - 对未被遮罩的区域进行修复或遮罩
这个选项根据需要在处理图片时会为其添加一定数量的填充，以便在进行图像修复等操作时不会影响原始图像
取值范围[0,256]，默认值为32
修复区域，可选值：true、false，默认false
true：仅修复遮罩区域
false：修复整个画面
多区域控制(object)
是否开启，可选值：true、false，默认true
true：开启
false：不开启
是否绘制完整画布背景，可选值：true、false，默认false
true：是
false：否
脸部修复(object)
是否开启，可选值：true、false，默认true
true：开启
false：不开启
使用最小面积（对于近距离的脸部），可选值：true、false
true：开启
false：关闭
修复范围，可选值：Face、Hair、Hat、Neck，默认Face
Face：脸部
Hair：头发
Hat：帽子
Neck：脖子
蒙版尺寸，默认值为0，取值范围：[0,64]
蒙版高斯模糊，默认值为0，取值范围：[0,64]
最大脸数，默认值20，取值范围：[0,20]
脸部置信度，默认值0.97，取值范围：[0.7,1]
脸部边距，默认值1.6，取值范围：[1,2]
修复后的脸部大小，默认值512，取值范围：[64,2048]
忽略大于该尺寸的脸，可选值：true、false，默认值true
true：忽略
false：不忽略
脸部去噪强度，默认值0.4，取值范围：[0.1,0.8]
只使用内部蒙版，可选值：true、false，默认值ture
true：是
flase：否
混合整个图像，默认值0，取值范围：[0,1]
高清修复(object)
是否开启，可选值：true、false，默认true
true：开启
false：不开启
尺寸升级类型，可选值：0、1、2，默认值0
0 - From img2img2 settings 遵循图生图设定
1 - Custom size 自适应尺寸
2 - Scale from image size 按图片比例
放大算法，可选值：0、1、2、3、4、5、6、7、8、9，默认值0
0 - None
1 - Lanczos
2 - Nearest
3 - ESRGAN_4x
4 - LDSR
5 - R-ESRGAN 4x+
6 - R-ESRGAN 4x+ Anime6B
7 - ScuNET GAN
8 - ScuNET PSNR
9 - SwinIR 4x
类型，可选值：0、1、2，默认值0
0 - Linear 线性
1 - Chess 棋盘
2 - None 无
平铺宽度，默认值512，取值范围：[0,2048]
平铺高度，默认值512，取值范围：[0,2048]
蒙版模糊，默认值8，取值范围：[0,64]
接缝修复类型，可选值：0、1、2、3，默认值0
0 - None 无
1 - Band pass 带通滤波器
2 - Half tile offset pass 半平铺偏移通道
3 - Half tile offset pass + intersections 半平铺偏移通道+交点
接缝修复宽度，默认值64，取值范围[0,128]
接缝修复降噪，默认值0.35，取值范围：[0,1]
接缝填充，默认值32，取值范围：[0,128]
是否开启，可选值：true、false，默认true
true：开启
false：不开启
修复模型，默认None
可选值：None、face_yolov8n.pt、face_yolov8s.pt、hand_yolov8n.pt、person_yolov8n-seg.pt、person_yolov8s-seg.pt、mediapipe_face_full、mediapipe_face_short、mediapipe_face_mesh、mediapipe_face_mesh_eyes_only
回调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" }, "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_code": 116,
"prompt": "一个美丽的女孩",
"width": 512,
"height": 512,
"supersize_multiple": 1,
"prefine_multiple": 1,
"batch_count": 1,
"option_param": {
"model_fusion": [
{
"key": "mf-可爱的线条平涂风",
"weight": 0.6
}
],
"character": [
"c-机械朋克"
]
},
"advanced_param": {
"uc_prompt": "低分辨率，不良解剖结构，文本，低质量，（突变，绘制不良：1.2），肥胖，不良比例",
"restore_faces": false,
"tilling": false,
"seed": "-1",
"vae_file": "'Anything-V3.0.vae.pt'",
"cfg": 7,
"sampler_steps": 20,
"sampler_index": 17,
"clip_skip": 5,
"ensd": 0,
"hires_fix_param": {
"denoising_strength": 0.7
}
},
"img_to_img_param": {
"init_image_url": "https://cdn.wujiebantu.com/ai/C837D53F842A48AEDFA7DA2976D834FE-01.png",
"creativity_degree": 50,
"resize_mode": 0
},
"control_net_params": [
{
"type": 0,
"preprocessor": 0,
"model": 0,
"control_weight": 1,
"starting_control_step": 0,
"ending_control_step": 1,
"control_mode": 0,
"image_url": "https://cdn.wujiebantu.com/B2381E03D5701D2EEEDCD19DDD624D74/1695093967/FsEkOaB1rQhSBP1qNWg-iVVA-z3m.jpg",
"image_width": 512,
"image_height": 512,
"mask_url": "https://cdn.wujiebantu.com/F4DA2BBBB4CCAD30ADE5274F8F9E7F08/controlnet/1692757097/FlSmnxPMRok9tkYAu0--CMkOlfo8.png",
"processor_res": 512,
"threshold_a": 8,
"threshold_b": 8,
"resize_mode": 1,
"pixel_perfect": true
}
],
"inpainting_plugin_d_t_o": {
"enabled": true,
"mask_zone_image_url": "www.isidro-stehr.com",
"mask_blur": 4,
"inpainting_fill": 1,
"inpainting_mask_invert": 0,
"inpaint_full_res_padding": 32,
"inpaint_full_res": true
},
"tiled_diffusion_d_t_o": {
"enabled": true,
"draw_background": false,
"bbox_control_states": [
{
"enabled": true,
"x": 0.5,
"y": 0.5,
"w": 0.5,
"h": 0.5,
"prompt": "hrrl3t",
"neg_prompt": "abjs38",
"blend_mode": "Background",
"seed": -1,
"option_param": {
"model_fusion": [
{
"key": "mf-可爱的线条平涂风",
"weight": 0.6
}
],
"character": [
"c-机械朋克"
]
}
}
]
},
"face_editor_d_t_o": {
"enabled": true,
"use_minimal_area": true,
"affected_areas": [
"Face"
],
"mask_size": 0,
"mask_blur": 0,
"max_face_count": 20,
"confidence": 0.97,
"face_margin": 1.6,
"face_size": 512,
"ignore_larger_faces": true,
"strength1": 0.4,
"apply_inside_mask_only": true,
"strength2": 0,
"prompt_for_face": "jgzp7s"
},
"ultimate_upscale_d_t_o": {
"enabled": true,
"target_size_type": 0,
"upscaler_index": 0,
"redraw_mode": 0,
"tile_width": 512,
"tile_height": 512,
"mask_blur": 8,
"seams_fix_type": 0,
"seams_fix_width": 64,
"seams_fix_denoise": 0.35,
"seams_fix_padding": 32
},
"adetailer_d_t_o_s": [
{
"enabled": true,
"ad_model": "None",
"ad_negative_prompt": "trvvih",
"ad_prompt": "mfolow"
}
],
"callback_url": "www.isidro-stehr.com"
}示例代码
返回响应
OK
返回数据(object)
{
"code": "200",
"message": "success",
"data": {
"results": [
{
"key": "C5B5FE8DBF3679D9049342C130341BD9",
"expected_second": 12,
"batch_task_key": "14DBBD0743C8715D92183756E3FB398C"
}
]
}
}