提交 Draft 任务

POST/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积分

注：

由于敏感图等问题提交任务成功但生成失败的，将退还积分

Draft 接口仅支持积分模式按次调用，包月和部署用户调用也需消耗等值积分

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

Authorization

string

必需

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

示例值:

Basic xxxxxxxxxx

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

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

uid

string

任务唯一 ID

必需

用于在 /engine/status/{uid} 接口中查询结果

{
  "uid": "dr_12023448"
}

最后修改时间： 2 年前