发起透明图作画

POST

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

AI普通版作画作画流程

根据输入的描述词直接生成透明图

请求参数

Body 参数application/json

layer_diffusion

object (LayerDiffusionParam_request)

必需

透明图。
注：
1.需使用透明图所支持的模型。[700-通用XL,701-MJXL,702-产品美学,703-人像XL]。
可通过/ai/default_resource接口查询具体如何设值。(object)

method

integer <int32>

可选

模式

可通过`获取作画模型的预设资源(/ai/default_resource)`接口查询，字段路径：`data`->`support_patterns`->`layer_diffusion_pattern_methods`->`method_code` *

示例值:

weight

number <float>

可选

权重，取值范围[0,2]，小数点后三位有效

示例值:

1.0

ending_step

number <float>

可选

stop at，取值范围[0,1]，小数点后三位有效

示例值:

1.0

model

integer <int32>

必需

透明图模型code，可使用code值：700、701、702、703

示例值:

700

prompt

string <string>

可选

作画描述，1000字符以内。
可选平台资源接口预设的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张。

示例值:

width

integer <int32>

可选

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

示例值:

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）。

示例值:

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。

示例值:

[星空法]

accelerate_times

integer <int32>

必需

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

示例值:

model_fusion

array[object (AiArtworkModelFusionVO_request) {2}]

可选

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

key

string <string>

融合模型key

可选

示例值:

mf-可爱的线条平涂风

weight

number <float>

权重

可选

示例值:

0.6

steps

integer <int32>

可选

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

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

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

示例值:

cfg

number <float>

可选

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

示例值:

sampler_index

integer <int32>

可选

采样模式（Sampler）是指扩散去噪算法的采样模式，如果设置正确，它们会发散并最终收敛。
不同model支持的采样模式不同，可通过获取作画模型的预设资源(/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。

示例值:

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

示例

{
  "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.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/layerDiffusion' \
--header 'Content-Type: application/json' \
--data-raw '{
  "layer_diffusion": {
    "method": 2,
    "weight": 1.0,
    "ending_step": 1.0
  },
  "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.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
  }
}

发起4K图作画

获取作画模型列表