发起AI作画

POST

https://gate.wujieai.net/wj-open/v1/ai/create

AI普通版作画作画流程

发起AI作画

请求参数

Body 参数application/json

model

integer <int32>

必需

模型code。
可通过获取作画模型列表(/ai/model_base_infos)接口查询，获取对应列表接口返回的model_code字段。

示例值:

116

prompt

string <string>

可选

作画描述，1000字符以内，可选获取作画模型的预设资源(ai/default_resource)接口预设的prompt来查看效果。
注意：
1.若未传底图（即init_image_url为空）时，作画描述不能为空，该字段必填。
2.若传了底图，且作画描述为空，会自动获取图片的tag填充为prompt来进行图生图。
Validate[max: 1500; ]

示例值:

夜幕下的赛博朋克城市

uc_prompt

string <string>

可选

作画负面描述，1000字符以内，可以补充不需要在图片里看到的内容。
注意：

无界AI的模型，基本都会预设一些默认的负面描述。

直接填内容即可，不需要再次否定。
Validate[max: 1000; ]

示例值:

低分辨率，不良解剖结构，文本，低质量，（突变，绘制不良：1.2），肥胖，不良比例

fully_custom_uc_prompt

boolean

可选

是否完全控制负向描述词，可选值：true、false，默认：false。
true：仅客户上定义的负面描述词会生效。
false：使用官方模型定义的负向描述。

示例值:

true

num

integer <int32>

必需

批量生成的数量，默认1张，上限100张。
注：使用Midjourney模型创建的数量必须为4的倍数。

示例值:

width

integer <int32>

可选

图片宽度。
注意：
使用controlnet（即使用pattern字段）或者createSource=1时可不传，其余情况下必填。
支持自定义尺寸，尺寸要求为64的倍数，最小尺寸为64，尺寸不为64的倍数的，会向64对齐，例96对齐64， 97对齐到128。
默认尺寸最长边限制在1344以内。
若使用精绘，长边需限制在1024以内，分辨率限制在1024*576以内。

示例值:

512

height

integer <int32>

可选

图片高度。限制参考width。

示例值:

512

init_image_url

string <string>

可选

图生图底图URL。
注意：

图片大小要限制在2M以内，强烈建议提前压缩，图片大小不影响出图效果。

若使用七牛云地址，支持psd、jpeg、png、gif、webp、tiff、bmp、avif、heif格式的图片。

若为其他地址，仅支持jpg、png、webp、jpeg格式。外部链接的可用性和延迟需要客户自己保障，否则失败率会上升。如果是临时链接，建议有效期大于1个小时，以避免极端情况。

如果传了底图，但是prompt没传，会自动获取图片的tag填充为prompt来进行图生图。

使用ControlNet时必填，为保证作图质量，ControlNet所做图片会保证最长边分辨率最低为2048，短边等比调整。

示例值:

https://cdn.wujiebantu.com/ai/C837D53F842A48AEDFA7DA2976D834FE-01.png

init_width

integer <int32>

可选

底图宽度。
建议和输入底图的宽度保持一致，不一致时平台按此值计算。
注意：使用ControlNet或createSource=1时必填。

示例值:

512

init_height

integer <int32>

可选

底图高度。
建议和输入底图的高度保持一致，不一致时平台按此值计算。
注意：使用ControlNet时或createSource=1时必填。

示例值:

512

creativity_degree

integer <int32>

可选

创意度/二次元强度，默认50，取值范围为[0-100]。
创意度越低，生成的图片越接近参考图。
注意：

使用底图（即init_image_url有值）时才会生效。

对应模型中的参数为去噪强度（denoising strength）。

示例值:

super_size_multiple

number <float>

可选

图片超分倍数，默认不超分，可传小数，取值范围为[1-4]。
注意：

宽高超分倍数一致，向下取整。例如宽高为512，超分1.9倍，出图宽高为972。
超分的额外耗时较短，效果仅是单纯提高图片分辨率，不会变更AI出图后的内容。
ControlNet下该参数不需要指定，其超分由底图宽高决定（长边<=2048时，默认超分到2048，大于时，底图会被缩放到1024，再超分两倍）。

示例值:

1.0

prefine_multiple

number <float>

可选

图片精绘倍数，默认不精绘，可传小数，取值范围为[1~2]。
精绘是另一种将图片放大的方式，需要重新绘制一遍图片，会有较长的额外耗时，在细节刻画上表现更出色，也会消耗更多积分。
注意：目前也支持精绘+超分组合使用（仅支持先精绘后超分），但仅支持2倍超分。

示例值:

1.0

image_type

array[string]

可选

画面类型，限制数量不超过10个。
可通过获取作画模型的预设资源(ai/default_resource)接口查询，获取返回列表中的画面类型（image_type-name）字段。

示例值:

[超现实照片]

style

array[string]

可选

风格，限制数量不超过10个。
可通过获取作画模型的预设资源(ai/default_resource)接口查询，获取返回列表中的风格（style-name）字段。

示例值:

[赛博朋克]

artists

array[string]

可选

艺术家，支持传入多个，优先于artist，限制数量不超过10个。
可通过获取作画模型的预设资源(ai/default_resource)接口查询，获取返回列表中的艺术家（artist-name）字段。

示例值:

[鸟山明]

element_magic

array[string]

可选

元素魔法，限制数量不超过10个。
可通过获取作画模型的预设资源(ai/default_resource)接口查询，获取返回列表中的元素魔法（element_magic-key）字段。

示例值:

[星空法]

style_decoration

array[string]

可选

风格选择参数，限制数量不超过10个。
可通过获取作画模型的预设资源(ai/default_resource)接口查询，获取返回列表中的元素魔法（style_decoration-key）字段。
imageType，style，artist，elementMagic本质上也都属于styleDecoration。

示例值:

[星空法]

model_param

string <string>

可选

模型特定参数（model为4），JSON格式，可选值：mask_image_url、mask_zone_image_url。
使用场景：涂抹（model为4）：

mask_image_url：涂抹底图。

mask_zone_image_url：涂抹区域图。

示例值:

{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

integer <int32>

必需

加速前进的步数。
默认0，每加1就是往队列前面多插1位，一次对应2积分（批量作画的积分消耗则还要算上对应作画数量）。

示例值:

character

array[string]

可选

角色同人，限制数量不超过10个。
可通过获取作画模型的预设资源(ai/default_resource)接口查询，获取返回列表中的角色（character-key）字段。

示例值:

[c-机械朋克]

model_fusion

array[object (AiArtworkModelFusionVO_request) {2}]

可选

模型融合，限制数量不超过5个。
可通过获取作画模型的预设资源(ai/default_resource)接口查询，获取返回列表中的的融合模型（model_fusion-key）字段。

key

string <string>

融合模型key

可选

示例值:

mf-可爱的线条平涂风

weight

number <float>

权重

可选

示例值:

0.6

style_model

string <string>

可选

风格模型。
可通过获取作画风格模型的预设资源(/ai/default_resource_style_model)接口查询，获取对应列表返回的key字段。

示例值:

stm-白瓷水墨

pattern

string <string>

可选

ControlNet模式，不同的模型支持的模式列表略有不同。
可通过获取作画模型的预设资源(/ai/default_resource)接口查询，获取返回列表中的（patterns-name）字段。
使用场景：当用户希望对模型出图加入更多的控制能力（如姿势、轮廓、深度）时，可加入ControlNet相关的参数。
可查看‘AI作画案例’页面的‘文生图采用ControlNet’了解相应参数信息。

示例值:

CANNY

pretreatment_method

string <string>

可选

预处理方式，用来对预处理图片进行处理。

INVERT_SCRIBBLE：反色。

FAKE_SCRIBBLE：假涂鸦。

SCRIBBLE：预处理。

NONE：无预处理。

示例值:

NONE

steps

integer <int32>

可选

采样步数（sampling steps），默认20。
注意：

随着步数的增大，可得到更精确的图像，但步数对出图耗时影响较大，过高会影响图片生成速度并产生扭曲。

支持输入自定义步长，根据超出预设步长倍数额外收取积分,详见收费规则介绍。

示例值:

cfg

number <float>

可选

提示词相关性（CFG scale），取值范围[1-30]，默认值7。
表示AI对描述参数的倾向程度，数值越大会越专注于提示词的内容，生成更加符合描述的图像。

示例值:

sampler_index

integer <int32>

可选

采样模式（Sampler）是指扩散去噪算法的采样模式，如果设置正确，它们会发散并最终收敛。
不同模型支持的采样模式不同，可通过获取作画模型的预设资源(/ai/default_resource)接口查询，获取返回信息列表中的采样模型（sampler_models-sampler_index）字段。

示例值:

seed

string <string>

可选

随机种子，生成图片的seed，默认-1随机生成。
通过随机种子确定扩散的初始状态，进而控制生成的样本的多样性。
相同的种子值可以保持图像的一致性，若设置相同的种子编号、模型，可以重新生成类似的图像。
注意：目前不支持字母，传字母会导致作画超时或失败。

示例值:

-1

create_source

integer <int32>

可选

图生图模式，默认0。
0 - 自定义尺寸，需要自定义出图宽高、超分、精绘（width height superSizeMultiple prefineMultiple）。
1 - 自动尺寸，需要指定底图宽高（initWidth initHeight），系统会忽略上述自定义参数，根据底图自动计算出图宽高（如果底图长边小于2048,会保证出图长边为2048，短边则按底图比例求得；反之,则出图尺寸与底图相同）。
两种模式下均可以不传prompt,此时会自动获取图片的tag作为prompt。

示例值:

clip_skip

integer <int32>

可选

画面描述匹配度，取值范围 [1～12] (DD不支持)。
描述画面的准确程度与数值大小成反比，数值越小表示对图像的控制度越高，最佳使用区间为1-2。

示例值:

control_weight

number <float>

可选

control模式权重，取值范围 [0~2]

示例值:

control_img2_img

boolean

可选

是否开启controlNet-img2img（图生图）模式, 可选值：true、false。
注意: 该参数只在controlNet模式下生效

示例值:

true

control_mode

integer <int32>

可选

Control Mode(previously called Guess Mode)，使用该参数可以控制哪方面更加重要，可选值：0、1、2。
0 - 平衡。
1 - prompt作画描述更重要。
2 - ControlNet更重要。
注意: 该参数只在controlNet模式下生效

示例值:

multi_diffusion

object (MultiDiffusionVO_request)

可选

multiDiffusion插件参数。
该插件的原理简单地说是将原有的图片变成拼图的碎片，每块拼图分别加以高清化的绘制，最后拼成一张大图片。(object)

tiled_diffusion

object (TiledDiffusionVO_request)

可选

平铺扩散(object)

tiled_vae

object (TiledVaeVO_request)

可选

平铺VAE(object)

hr_second_pass_strength

number <float>

精绘时的噪声强度。

可选

示例值:

0.7

notify_url

string <string>

可选

回调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 - 积分花费说明

示例值:

www.tobias-wiegand.biz

示例

{"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":"4fg3o5","neg_prompt":"nqimz8","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.tobias-wiegand.biz"}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://gate.wujieai.net/wj-open/v1/ai/create' \
--header 'Content-Type: application/json' \
--data-raw '{"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":"4fg3o5","neg_prompt":"nqimz8","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.tobias-wiegand.biz"}'

返回响应

🟢200成功

*/*

Body

code

string <string>

响应code

可选

示例值:

200

message

string <string>

失败信息

可选

示例值:

success

data

object (AiArtworkKeysVo_response)

可选

返回数据(object)

keys

array[string]

作画结果Key列表

可选

示例值:

C5B5FE8DBF3679D9049342C130341BD9

results

array[object (CrAiArtworkCreateResult_response) {3}]

可选

作画结果result列表

expected_integral_cost

integer <int32>

预计总消耗积分数

可选

示例值:

示例

{
  "code": "200",
  "message": "success",
  "data": {
    "keys": "C5B5FE8DBF3679D9049342C130341BD9",
    "results": [
      {
        "key": "C5B5FE8DBF3679D9049342C130341BD9",
        "expected_second": 12,
        "batch_task_key": "14DBBD0743C8715D92183756E3FB398C"
      }
    ],
    "expected_integral_cost": 2
  }
}

积分收费规则

发起Midjourney作画