调用流程

调用 /push 类接口提交任务
调用 /status 接口查询任务状态（排队情况，是否完成，返回的结果等）

接口分为域名，环境标识和路径三部分，其中：

域名：https://open.nolibox.com
正式环境标识：prod-open-aigc
路径：如 /engine/push或 /engine/status 等

最终请求地址为域名/环境标识/路径

如 https://open.nolibox.com/prod-open-aigc/engine/push

画宇宙

提交 Draft 任务

POST

https://open.nolibox.com/prod-open-aigc/engine/push/draft

接口能力

提交 Draft 模型生成任务

Draft 模型官网：https://draft.art/

本接口为异步接口，需要把返回结果中的 uid 做为参数，通过 「查询接口-查询任务结果」（/engine/status）接口轮询获取结果

积分扣除规则

生成不同清晰度的图片消耗积分不同，具体扣除规则如下：

512×512：2积分

768×512 / 512×768：2.5积分

768×768：3积分

768×1024 / 1024×768：3.5积分

1024×1024：4积分

注：
1.
由于敏感图等问题提交任务成功但生成失败的，将退还积分
2.
Draft 接口仅支持积分模式按次调用，包月和部署用户调用也需消耗等值积分

请求参数

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>

任务类型

必需

枚举值:

txt2img.sd txt2img.pixiv txt2img.pixiv_hand txt2img.indoor_design txt2img.sd_20 txt2img.architecture txt2img.comic txt2img.arcane txt2img.food txt2img.pixel txt2img.retro txt2img.photo txt2img.dream_art txt2img.oil_paint txt2img.acg txt2img.soft txt2img.3D txt2img.sam txt2img.inkpunk txt2img.3D_icon txt2img.cartoon_wallpaper txt2img.character_simulation txt2img.antique_photo txt2img.crayon txt2img.colorful_art txt2img.2_5D_antique img2img.sd img2img.pixiv img2img.pixiv_hand img2img.indoor_design img2img.sd_20 img2img.architecture img2img.comic img2img.arcane img2img.food img2img.pixel img2img.retro img2img.photo img2img.dream_art img2img.oil_paint img2img.acg img2img.soft img2img.3D img2img.sam img2img.inkpunk img2img.3D_icon img2img.cartoon_wallpaper img2img.character_simulation img2img.antique_photo img2img.crayon img2img.colorful_art img2img.2_5D_antique

params

object

执行参数

必需

text

string

提示词

必需

url

string

参考图 URL

可选

当是任务类型是 img2img 时，此参数必填

fidelity

number

相似度

可选

当任务是 img2img 类型时，此值才有意义。默认值是 0.2，取值范围：0~1

>= 0<= 1

默认值:

0.2

enum<integer>

宽

可选

默认值 512，可选值：512, 768, 1024

枚举值:

5127681024

默认值:

512

enum<integer>

高

可选

默认值 512

枚举值:

5127681024

默认值:

512

notify_url

string

回调通知地址

可选

示例

{
  "task": "img2img.sd",
  "params": {
    "text": "running dog",
    "url": "https://localimage.nolibox.com/pix/20221008-145928.png",
    "w": 512,
    "h": 512,
    "fidelity": 0.4
  }
}

示例代码

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/draft' \
--header 'Authorization: Basic xxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "task": "img2img.sd",
    "params": {
        "text": "running dog",
        "url": "https://localimage.nolibox.com/pix/20221008-145928.png",
        "w": 512,
        "h": 512,
        "fidelity": 0.4
    }
}'