画宇宙
提交任务接口（画宇宙系列模型）
POST/engine/push接口能力
本接口支持多种任务类型，参数上的区别请在请求参数-示例中查看：
本接口为异步接口，需要把返回结果中的 uid 做为参数，通过 「查询接口-查询任务结果」（/engine/status）接口轮询获取结果
| 功能 | 任务类型 | 说明 | 示意图 |
|---|---|---|---|
| 文生图 | txt2img.sd | 调用接口一次生成 1 张图片，接口中包含违规图片检测（涉⻩、涉政、涉暴、敏感信息） | |
| 图生图 | img2img.sd | 由图片和文本生成图片，接口中包含违规图片检测（涉⻩、涉政、涉暴、敏感信息） | |
| 高清化 | img2img.sr | 对目标图填充细节并输出高清图（宽、高各提升 4 倍，总计提升 16 倍分辨率），例如 512 × 512 的图片高清后输出 2048 × 2048 的图 | |
| 图像外延 | txt2img.sd.outpainting | 填补图像之外的画面，可用于图片智能编辑等场景 | |
| 图像局部消除 | img2img.inpainting | 将图片中指定区域内容去除，并智能补全背景 | |
| 图像局部替换 | txt2img.sd.inpainting | 将图片中指定区域的画面内容替换为输入的文本所描述的画面内容 | |
| 图像生成文本 | img2txt.caption | 输入图片，生成图片的内容文本描述 |
提交任务接口（画宇宙系列模型）支持积分模式按次调用；
包月用户和部署用户不限次调用
积分扣除规则
一次调用消耗 2 积分（对于 512×704 及以下分辨率）
注：
- 由于敏感图等问题提交任务成功但生成失败的，将退还积分
- 标准分辨率下图片尺寸是 512×704，面积低于该尺寸维持原价，面积大于该尺寸按比例增加消耗的积分
如，(1024×1024)/(512×704)=2.9，则生成 1024×1024 的图片会需要 2×2.9=5.8 积分- 一般来说，图片生成效果在标准分辨率下效果最佳（生成 512×512 的图，不要轻易直接使用生成1024×1024的图，一般情况下效果不好）；如需更高清的图片，建议先生成 512×512 标准分辨率图片，再使用
图像超分辨率功能进行高清化- 调用画宇宙引擎前，如果涉及中文文本输入，需要先调用
提示词（prompt）预处理接口（因为提交任务接口中的text参数仅支持英文输入），以进行文本翻译并预先屏蔽掉敏感的提示词- 推理一张512 × 512的图，约耗时6~8s（不算排队和网络传输）
请求参数
此值可以在 开放平台(https://open.creator.nolibox.com) - 应用列表 - 操作中的"TOKEN"中获取。计算方式："Basic " + Base64.encode(App Key:App Secret)
不同类型的 task 对应的参数不同，具体可以参考右侧 示例
- 当任务为 img2img.sd 或 txt2img.sd 时，此字段必填。
- 内容必须为英文，中文内容需要先调用
提示词预处理接口翻译为英文
当任务为 img2img.sd 时，此参数必填。宽高不能超过 1024
最大 1024
最大 1024
当任务类型为 img2img时，此字段有意义
取值范围：-1~2^32-1。-1 代指由接口内部随机生成一个 seed，注意：如调用接口时传的是-1，则接口内部随机生成的seed无法返回给调用方，即这个效果无法再被还原，因此建议调用方自己生成随机数并记录，并将一个具体的seed传给API，这样使用相同的参数和相同的seed，作图记录效果就可被二次还原
默认 k_euler
目前支持的采样器有：ddim, plms, klms, solver, k_euler, k_euler_a
默认值是 20 取值范围：5~100
默认值是 7.5
默认值是空字符串
空字符串意味着不使用负面词
默认为空数组 []
task 为 img2img.inpainting 时必传，图片中透明度不为 0 的像素，在 url 中会被擦除
当 task 为 img2img.harmonization时，此参数生效，值范围为 (0, 1]
是否自动生成prompt,仅在task等于img2img.sd时有效, 万能相似图使用
开启后会降低画质来提升生成速度。建议只在model 为 basic 且 sampler为 k_euler 或 k_euler_a时，可以考虑开启。
默认false，启用用 EasyNegative，当值为true时，不启用 EasyNegative
// img2img.sd 图片生成图片(垫图生成)
{
"task": "img2img.sd",
"params": {
"text": "running dog",
"url": "https://gimg2.nolibox.com/39023-21394.png",
"is_anime": true,
"fidelity": 0.2
},
"notify_url": "https://www.nolibox.com/debug/callback"
}
// txt2img.sd 文字生成图片
{
"task": "txt2img.sd",
"params": {
"text": "running dog",
"is_anime": true,
"w": 512,
"h": 512
},
"notify_url": "https://www.nolibox.com/debug/callback"
}
// img2img.sr 图片高清化(超分辨率)
{
"task": "img2img.sr",
"params": {
"url": "https://gimg2.nolibox.com/39023-21394.png",
"is_anime": false
}
}
// 图像外延 (outpainting)
{
"task": "txt2img.sd.outpainting",
"params": {
"text": "running dog",
"url": "https://gimg2.noljjjibox.com/39023-21394.png"
},
"notify_url": "https://www.nolibox.com/debug/callback"
}
// 图像擦除 (inpainting)
// mask_url 中透明度不为零的像素，将在 url 中对同位置像素执行擦除。
{
"task": "img2img.inpainting",
"params": {
"url": "https://gimg2.noljjjibox.com/39023-21394.png",
"mask_url": "https://gimg2.noljjjibox.com/mask.png",
},
"notify_url": "https://www.nolibox.com/debug/callback"
}
// 图像替换
// negative_prompt 是要去除的内容描述，text 是要新增的内容描述。描述都必须为英文。
// mask_url 中透明度不为零的像素，将在 url 中对同位置像素执行替换操作。
{
"task": "txt2img.sd.inpainting",
"params": {
"url": "https://ailab-huawei-cdn.nolibox.com/upload/images/87c2f0073948487296d8ac5ab5c064e2.png",
"mask_url": "https://ailab-huawei-cdn.nolibox.com/upload/images/760d87c7eae644128e8ca1e4867997af.png",
"text": "A bouquet of roses, wallpaper",
"negative_prompt": "Bottle"
}
}
// 图像生成文本
{
"task": "img2txt.caption",
"params": {
"url": "https://ailab-huawei-cdn.nolibox.com/upload/images/87c2f0073948487296d8ac5ab5c064e2.png"
}
}示例代码
返回响应
{
"uid": "2b0e334e"
}