接口能力

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

本接口为异步接口，需要把返回结果中的 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 参数

Content-Type

string

必需

示例值:

application/json

Authorization

string

必需

此值可以在开放平台(https://open.creator.nolibox.com) - 应用列表 - 操作中的"TOKEN"中获取。计算方式："Basic " + Base64.encode(App Key:App Secret)

示例值:

Basic xxxxxxxxxx

Body 参数application/json

task

enum<string>

任务类型

必需

不同类型的 task 对应的参数不同，具体可以参考右侧 示例

枚举值:

txt2img.sdimg2img.sdimg2img.srtxt2img.sd.outpaintingimg2img.inpaintingtxt2img.sd.inpaintingimg2txt.caption

params

object

具体参数

必需

model

enum<string>

生成模型

可选

枚举值:

generalanimeartreal3danimebasic

示例值:

general

text

string

提示词

可选

当任务为 img2img.sd 或 txt2img.sd 时，此字段必填。

内容必须为英文，中文内容需要先调用 提示词预处理接口翻译为英文

url

string

源图地址

可选

当任务为 img2img.sd 时，此参数必填。宽高不能超过 1024

is_anime

boolean

是否使用动漫模型

已废弃

integer

宽

可选

最大 1024

integer

高

可选

最大 1024

fidelity

number

相似度

可选

当任务类型为 img2img时，此字段有意义

>= 0<= 1

默认值:

0.2

seed

integer

随机种子

可选

取值范围：-1~2^32-1。-1 代指由接口内部随机生成一个 seed，注意：如调用接口时传的是-1，则接口内部随机生成的seed无法返回给调用方，即这个效果无法再被还原，因此建议调用方自己生成随机数并记录，并将一个具体的seed传给API，这样使用相同的参数和相同的seed，作图记录效果就可被二次还原

>= -1<= 4294967295

默认值:

-1

sampler

enum<string>

采样器

可选

默认 k_euler
目前支持的采样器有：ddim, plms, klms, solver, k_euler, k_euler_a

枚举值:

k_eulerddimplmsklmssolverk_euler_a

默认值:

k_euler

num_steps

integer

采样步数

可选

默认值是 20 取值范围：5~100

>= 5<= 100

默认值:

guidance_scale

number

扣题程度

必需

默认值是 7.5

默认值:

7.5

negative_prompt

string

负面词

可选

默认值是空字符串
空字符串意味着不使用负面词

variations

array [object {2}]

「生成同款」时会用到的参数

可选

默认为空数组 []

mask_url

string

mask 图片地址

可选

task 为 img2img.inpainting 时必传，图片中透明度不为 0 的像素，在 url 中会被擦除

strength

number

图像融合强度

可选

当 task 为 img2img.harmonization时，此参数生效，值范围为 (0, 1]

<= 1> 0

默认值:

0.5

auto_prompt

boolean

可选

是否自动生成prompt,仅在task等于img2img.sd时有效, 万能相似图使用

默认值:

false

tome_info

object

优化参数

可选

开启后会降低画质来提升生成速度。建议只在model 为 basic 且 sampler为 k_euler 或 k_euler_a时，可以考虑开启。

disable_easy_negative

boolean

是否禁用 EasyNegative 效果

可选

默认false，启用用 EasyNegative，当值为true时，不启用 EasyNegative

默认值:

false

notify_url

string

回调通知地址

可选

示例

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

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

接口能力#

积分扣除规则#

请求参数

示例代码

返回响应

接口能力

积分扣除规则