发起4K图作画
POST
/ai/create/cutDiffusion发起4K图作画
请求参数
4k参数
目前约束:
1.只能用于文生图,对尺寸有相关约束查看width、height描述。
2.只有部分模型支持,查看模型列表支持的 supportCutdiffusion 字段返回true。(object)
采样两阶段占比 最小精度0.1
第一阶段的cfg 最小精度1.0
第二阶段的cfg 最小精度1.0
模型code,只有部分模型支持。
可通过获取作画模型列表(/ai/model_base_infos)
接口查询,获取对应列表接口返回的model_code
字段,仅supportCutdiffusion
字段返回true的模型支持。
作画描述,1000字符以内。
可选平台资源接口预设的prompt来查看效果。
Validate[max: 1500; ]
作画负面描述,1000字符以内,可以补充不需要在图片里看到的内容。
注:
- 无界AI的模型,基本都会预设一些默认的负面描述。
- 直接填内容即可,不需要再次否定。
Validate[max: 1000; ]
是否完全控制负向描述词,可选值:true、false,默认:false。
true:仅客户上定义的负面描述词会生效。
false:使用官方模型定义的负向描述。
批量生成的数量,默认1张,上限100张。
图片宽度。
注:
支持自定义尺寸,尺寸要求为64的倍数,最小尺寸为64,尺寸不为64的倍数的,会向64对齐, 例96对齐64, 97对齐到128。
使用cutdiffion单边范围为【1088,3072】,分辨率乘积不超过5017600。
图片高度。限制参考width。
画面类型,限制数量不超过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。
加速前进的步数。
默认0,每加1就是往队列前面多插1位,一次对应2积分(批量作画的积分消耗则还要算上对应作画数量)。
角色同人,限制数量不超过10个。
可通过获取作画模型的预设资源(ai/default_resource)
接口查询,获取返回列表中的角色(character
-key
)字段。
模型融合,限制数量不超过5个。
可通过获取作画模型的预设资源(ai/default_resource)
接口查询,获取返回列表中的的融合模型(model_fusion
-key
)字段。
风格模型,可通过获取作画风格模型的预设资源(/ai/default_resource_style_model)
接口查询,获取对应列表返回的key
字段。
注:需使用底模(即model_code)支持4k的风格模型。
采样步数(sampling steps),默认20。
注:
- 随着步数的增大,可得到更精确的图像,但步数对出图耗时影响较大,过高会影响图片生成速度并产生扭曲。
- 支持输入自定义步长,根据超出预设步长倍数额外收取积分,详见收费规则介绍。
提示词相关性(CFG scale),取值范围[1-30],默认值7。
表示AI对描述参数的倾向程度,数值越大会越专注于提示词的内容,生成更加符合描述的图像。
采样模式(Sampler)是指扩散去噪算法的采样模式,如果设置正确,它们会发散并最终收敛。
不同model支持的采样模式不同,可通过获取作画模型的预设资源(/ai/default_resource)
接口查询,获取返回信息列表中的采样模型(sampler_models
-sampler_index
)字段。
随机种子,生成图片的seed,默认-1随机生成。
通过随机种子确定扩散的初始状态,进而控制生成的样本的多样性。
相同的种子值可以保持图像的一致性,若设置相同的种子编号、模型,可以重新生成类似的图像。
注:目前不支持字母,传字母会导致作画超时或失败。
画面描述匹配度,取值范围 [1~12] (DD不支持)。
描述画面的准确程度与数值大小成反比,数值越小表示对图像的控制度越高,最佳使用区间为1-2。
回调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 - 积分花费说明
{
"cutdiffusion": {
"cutdiff_proportion": 0.5,
"cfg_scale1": 7,
"cfg_scale2": 7
},
"model": 127,
"prompt": "夜幕下的赛博朋克城市",
"uc_prompt": "低分辨率,不良解剖结构,文本,低质量,(突变,绘制不良:1.2),肥胖,不良比例",
"fully_custom_uc_prompt": true,
"num": 1,
"width": 1088,
"height": 1088,
"image_type": [
"超现实照片"
],
"style": [
"赛博朋克"
],
"artists": [
"鸟山明"
],
"element_magic": [
"星空法"
],
"style_decoration": [
"星空法"
],
"accelerate_times": 2,
"character": [
""
],
"model_fusion": [
{
"key": "mf-可爱的线条平涂风",
"weight": 0.6
}
],
"style_model": "stm-8649ZV9C",
"steps": 20,
"cfg": 7,
"sampler_index": 16,
"seed": "-1",
"clip_skip": 5,
"notify_url": "www.isidro-stehr.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
}
}