接口能力

本接口支持多种任务类型，参数上的区别请在请求参数-示例中查看：

本接口为异步接口，需要把返回结果中的 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 及以下分辨率）

注：
1.
由于敏感图等问题提交任务成功但生成失败的，将退还积分
2.
标准分辨率下图片尺寸是 512×704，面积低于该尺寸维持原价，面积大于该尺寸按比例增加消耗的积分
如，(1024×1024)/(512×704)=2.9，则生成 1024×1024 的图片会需要 2×2.9=5.8 积分
3.
一般来说，图片生成效果在标准分辨率下效果最佳（生成 512×512 的图，不要轻易直接使用生成1024×1024的图，一般情况下效果不好）；如需更高清的图片，建议先生成 512×512 标准分辨率图片，再使用图像超分辨率功能进行高清化
4.
调用画宇宙引擎前，如果涉及中文文本输入，需要先调用提示词（prompt）预处理接口（因为提交任务接口中的text参数仅支持英文输入），以进行文本翻译并预先屏蔽掉敏感的提示词
5.
推理一张512 × 512的图，约耗时6~8s（不算排队和网络传输）

请求参数

Header 参数

Body 参数application/json

示例

// 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"
	}
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://open.nolibox.com/prod-open-aigc/engine/push' \
--header 'Authorization: Basic xxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data-raw '// 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"
	}
}'

提交任务接口（画宇宙系列模型）

接口能力#

积分扣除规则#

请求参数

请求示例代码

返回响应

接口能力

积分扣除规则