- 无界AI企业服务
- 无界AI企业智能客服
- 更新日志
- 公告
- API接入指南
- 作画指南
- AI专业版作画
- AI普通版作画
- AI视频生视频
- AI咒语解析
- 付费开通API
- AI化身&个性相机
- 提升作画效率
- 自定义镜像
- 用户账户
- LLM对话聊天
- 实验室
发起AI作画
POST
https://gate.wujieai.net/wj-open/v1/ai/pro/create
AI专业版作画作画流程
请求参数
Body 参数application/json
model_code
integer <int32>
可选
获取模型列表(/ai/pro/model_base_infos)
接口查询,字段路径:data
->model_code
示例值:
116
prompt
string <string>
可选
可选
获取作画模型的预设资源(ai/default_resource)
接口预设的prompt来查看效果。Validate[max: 1000; ]
示例值:
一个美丽的女孩
width
integer <int32>
必需
注意:
支持自定义尺寸,尺寸要求为64的倍数,最小尺寸为64,尺寸不为64的倍数的,会向64对齐,例96对齐64,97对齐到128。
默认尺寸最长边限制在1344以内。
若使用精绘,长边需限制在1024以内,分辨率限制在1024*576以内。
使用cutdiffion单边范围为【1088,3072】,分辨率乘积不超过5017600。
示例值:
512
height
integer <int32>
必需
支持自定义尺寸,同宽度
示例值:
512
supersize_multiple
number <float>
可选
图片超分倍数,默认不超分,可传小数,取值范围为[1-4]。
宽高超分倍数一致,向下取整。
超分的额外耗时较短,效果仅是单纯提高图片分辨率,不会变更AI出图后的内容。
注意:
ControlNet下该参数不需要指定,其超分由底图宽高决定(长边<=2048时,默认超分到2048,大于时,底图会被缩放到1024,再超分两倍)。
示例值:
1.0
prefine_multiple
number <float>
可选
精绘是另一种将图片放大的方式,需要重新绘制一遍图片,会有较长的额外耗时,在细节刻画上表现更出色,也会消耗更多积分。
注:目前也支持精绘+超分组合使用(仅支持先精绘后超分),但仅支持2倍超分。
示例值:
1.0
batch_count
integer <int32>
必需
示例值:
1
option_param
object (AiArtworkProOptionParamVO_request)
可选
model_fusion
array[object (AiArtworkModelFusionVO_request) {2}]
可选
获取作画模型的预设资源(ai/default_resource)
接口查询,字段路径:data
->create_option_menu
->model_fusion
->key
。character
array[string]
可选
获取作画模型的预设资源(ai/default_resource)
接口查询,字段路径:data
->create_option_menu
->character
-key
。示例值:
[c-机械朋克]
advanced_param
object (AiArtworkProAdvancedParamVO_request)
可选
uc_prompt
string <string>
可选
注:
1.
2.
Validate[max: 1000; ]
示例值:
低分辨率,不良解剖结构,文本,低质量,(突变,绘制不良:1.2),肥胖,不良比例
restore_faces
boolean
可选
true:开启
false:不开启
示例值:
false
tilling
boolean
可选
true:开启
false:不开启
示例值:
false
seed
string <string>
可选
通过随机种子确定扩散的初始状态,进而控制生成的样本的多样性
相同的种子值可以保持图像的一致性,若设置相同的种子编号、模型,可以重新生成类似的图像。
注:目前不支持字母,传字母会导致作画超时或失败
示例值:
-1
vae_file
string <string>
可选
可选值[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; ]
示例值:
'Anything-V3.0.vae.pt'
cfg
number <float>
可选
默认7,取值范围为[1-30]
示例值:
7
sampler_steps
integer <int32>
可选
随着步数的增大,可得到更精确的图像,但步数对出图耗时影响较大,过高会影响图片生成速度并产生扭曲。
支持输入自定义步长,根据超出预设步长倍数额外收取积分,详见收费规则介绍
示例值:
20
sampler_index
integer <int32>
可选
是指扩散去噪算法的采样模式,如果设置正确,它们会发散并最终收敛
不同model支持的采样模式不同,可通过
获取作画模型的预设资源(/ai/default_resource)
接口查询,字段路径:data
->create_option_menu
->sampler_models
->sampler_index
示例值:
17
clip_skip
integer <int32>
可选
描述画面的准确程度与数值大小成反比,数值越小表示对图像的控制度越高,最佳使用区间为1-2。
示例值:
5
ensd
number <float>
可选
示例值:
0
hires_fix_param
object (AiArtworkHiresFixParamVO_request)
可选
img_to_img_param
object (AiArtworkProImgToImgParamVO_request)
可选
init_image_url
string <string>
可选
1.
2.
3.
注:使用ControlNet时必填,为保证作图质量,ControlNet所做图片会保证最长边分辨率最低为2048,短边等比调整
示例值:
https://cdn.wujiebantu.com/ai/C837D53F842A48AEDFA7DA2976D834FE-01.png
creativity_degree
integer <int32>
可选
创意度越低,生成的图片越接近参考图
注:
1.
示例值:
50
resize_mode
integer <int32>
可选
0 - 仅调整大小
1 - 剪裁后缩放
2 - 缩放后填充空白
示例值:
0
control_net_params
array[object (AiArtworkProControlNetParamVo_request) {16}]
可选
type
integer <int32>
必需
可通过Get
获取条件生图模式列表(/ai/pro/controlNetOption)
接口查询,字段路径:data
->code
示例值:
0
preprocessor
integer <int32>
可选
可通过Get
获取条件生图模式列表(/ai/pro/controlNetOption)
接口查询,字段路径:data
->preprocessor
->code
示例值:
0
model
integer <int32>
可选
可通过Get
获取条件生图模式列表(/ai/pro/controlNetOption)
接口查询,字段路径:data
->model
->code
示例值:
0
control_weight
number <float>
权重
示例值:
1
starting_control_step
number <float>
开始步数
示例值:
0
ending_control_step
number <float>
结束步数
示例值:
1
control_mode
integer <int32>
可选
0-平衡
1-prompt作画描述优先
2-control_net优先
示例值:
0
image_url
string <string>
图片url
示例值:
https://cdn.wujiebantu.com/B2381E03D5701D2EEEDCD19DDD624D74/1695093967/FsEkOaB1rQhSBP1qNWg-iVVA-z3m.jpg
image_width
integer <int32>
图片宽度
示例值:
512
image_height
integer <int32>
图片高度
示例值:
512
mask_url
string <string>
蒙版图片Url
示例值:
https://cdn.wujiebantu.com/F4DA2BBBB4CCAD30ADE5274F8F9E7F08/controlnet/1692757097/FlSmnxPMRok9tkYAu0--CMkOlfo8.png
processor_res
integer <int32>
可选
取值范围可通过Get
获取条件生图模式列表(/ai/pro/controlNetOption)
接口查询,字段路径:data
->preprocessor
->resolution
示例值:
512
threshold_a
number <float>
可选
取值范围可通过Get
获取条件生图模式列表(/ai/pro/controlNetOption)
接口查询,字段路径:data
->preprocessor
->threshold_a
示例值:
8
threshold_b
number <float>
可选
取值范围可通过Get
获取条件生图模式列表(/ai/pro/controlNetOption)
接口查询,字段路径:data
->preprocessor
->threshold_b
示例值:
8
resize_mode
integer <int32>
可选
0 - 仅调整大小
1 - 剪裁后缩放
2 - 缩放后填充空白
示例值:
1
pixel_perfect
boolean
可选
true:是
false:否
示例值:
true
inpainting_plugin_d_t_o
object (InpaintingPluginDTO_request)
可选
enabled
boolean
可选
true:开启
false:不开启
示例值:
true
mask_zone_image_url
string <string>
必需
示例值:
www.lynnette-reichert.info
mask_blur
integer <int32>
可选
默认值4,取值范围[0,64]
示例值:
4
inpainting_fill
integer <int32>
可选
取值范围[0,3],默认值为1
0 - fill:使用周边的像素信息来生成填充内容
1 - original:保留原始内容,不进行任何填充或修改
2 - latent noise:用于向图像或视觉效果添加一种随机性或变异性,增加图像的真实感、细节或多样性
3 - latent nothing:清空选定区域
示例值:
1
inpainting_mask_invert
boolean
可选
0 - 对遮罩的区域进行修复或填充
1 - 对未被遮罩的区域进行修复或遮罩
示例值:
0
inpaint_full_res_padding
integer <int32>
可选
取值范围[0,256],默认值为32
示例值:
32
inpaint_full_res
boolean
可选
true:仅修复遮罩区域
false:修复整个画面
示例值:
true
tiled_diffusion_d_t_o
object (TiledDiffusionDTO_request)
可选
enabled
boolean
可选
true:开启
false:不开启
示例值:
true
draw_background
boolean
可选
true:是
false:否
示例值:
false
bbox_control_states
array[object (TiledDiffusionDTOTiledDiffusionBboxControlStatesParam_request) {10}]
区域参数
face_editor_d_t_o
object (FaceEditorDTO_request)
可选
enabled
boolean
可选
true:开启
false:不开启
示例值:
true
use_minimal_area
boolean
可选
true:开启
false:关闭
示例值:
true
affected_areas
array[string]
可选
Face:脸部
Hair:头发
Hat:帽子
Neck:脖子
示例值:
[Face]
mask_size
integer <int32>
可选
示例值:
0
mask_blur
integer <int32>
可选
示例值:
0
max_face_count
integer <int32>
可选
示例值:
20
confidence
number <float>
可选
示例值:
0.97
face_margin
number <float>
可选
示例值:
1.6
face_size
integer <int32>
可选
示例值:
512
ignore_larger_faces
boolean
可选
true:忽略
false:不忽略
示例值:
true
strength1
number <float>
可选
示例值:
0.4
apply_inside_mask_only
boolean
可选
true:是
flase:否
示例值:
true
strength2
number <float>
可选
示例值:
0
prompt_for_face
string <string>
面部描述词
示例值:
753x2t
ultimate_upscale_d_t_o
object (UltimateUpscaleDTO_request)
可选
enabled
boolean
可选
true:开启
false:不开启
示例值:
true
target_size_type
integer <int32>
可选
0 - From img2img2 settings 遵循图生图设定
1 - Custom size 自适应尺寸
2 - Scale from image size 按图片比例
示例值:
0
upscaler_index
integer <int32>
可选
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
redraw_mode
integer <int32>
可选
0 - Linear 线性
1 - Chess 棋盘
2 - None 无
示例值:
0
tile_width
integer <int32>
可选
示例值:
512
tile_height
integer <int32>
可选
示例值:
512
mask_blur
integer <int32>
可选
示例值:
8
seams_fix_type
integer <int32>
可选
0 - None 无
1 - Band pass 带通滤波器
2 - Half tile offset pass 半平铺偏移通道
3 - Half tile offset pass + intersections 半平铺偏移通道+交点
示例值:
0
seams_fix_width
integer <int32>
可选
示例值:
64
seams_fix_denoise
number <float>
可选
示例值:
0.35
seams_fix_padding
integer <int32>
可选
示例值:
32
adetailer_d_t_o_s
array[object (AdetailerDTO_request) {4}]
表情修复
enabled
boolean
可选
true:开启
false:不开启
示例值:
true
ad_model
string <string>
可选
可选值:
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
示例值:
None
ad_negative_prompt
string <string>
负面内容
示例值:
qqzaen
ad_prompt
string <string>
待修复的内容
示例值:
g8avwl
callback_url
string <string>
可选
回调重试规则:
1.
2.
回调报文:
{
"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 - 积分花费说明
示例值:
www.lynnette-reichert.info
示例
{
"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.lynnette-reichert.info",
"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": "z6hne8",
"neg_prompt": "16ciqr",
"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": "h7np93"
},
"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": "8xm0ht",
"ad_prompt": "qimn65"
}
],
"callback_url": "www.lynnette-reichert.info"
}
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://gate.wujieai.net/wj-open/v1/ai/pro/create' \
--header 'Content-Type: application/json' \
--data-raw '{
"model_code": 116,
"prompt": "一个美丽的女孩",
"width": 512,
"height": 512,
"supersize_multiple": 1.0,
"prefine_multiple": 1.0,
"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.lynnette-reichert.info",
"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": "z6hne8",
"neg_prompt": "16ciqr",
"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": "h7np93"
},
"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": "8xm0ht",
"ad_prompt": "qimn65"
}
],
"callback_url": "www.lynnette-reichert.info"
}'
返回响应
🟢200成功
*/*
Body
code
string <string>
响应code
示例值:
200
message
string <string>
失败信息
示例值:
success
data
object (AiArtworkProCreateResultVO_response)
可选
results
array[object (CrAiArtworkCreateResult_response) {3}]
-
示例
{
"code": "200",
"message": "success",
"data": {
"results": [
{
"key": "C5B5FE8DBF3679D9049342C130341BD9",
"expected_second": 12,
"batch_task_key": "14DBBD0743C8715D92183756E3FB398C"
}
]
}
}
修改于 2025-04-15 03:20:46