Controlnet

开发环境

https://stablediffusionapi.com/v1

POST

https://stablediffusionapi.com/api/v1/enterprise/controlnet

该端点用于生成 ControlNet 图像。

提示
您还可以使用此端点通过 ControlNet 修复图像。只需确保将链接传递到mask_image请求正文中即可。并使用 controlnet_model 作为“修复”

POST向 https://stablediffusionapi.com/api/v1/enterprise/controlnet 接口发送请求。

信息
要使用负载平衡器，您需要拥有1 台以上的服务器。传递第一台服务器的 API 密钥，它将处理与其他服务器的负载平衡。

提示
您也可以使用多 ControlNet 模型。只需确保在 controlnet_model参数中以逗号分隔传入多个模型,例如 "canny,depth",并在请求体中传入 init_image即可。

模型

默认使用 Controlnet 1.1 的 ControlNet API：支持的 controlnet_model：

canny - Canny边缘检测

depth - 深度估计

hed - 图像边缘检测

mlsd - 多尺度线段检测

normal - 法线估计

openpose - 开源人体姿态估计

scribble - 图像涂鸦

segmentation - 图像分割

aesthetic-controlnet - 美学评价

inpaint - 图像修复

softedge - 图片边缘平滑

lineart - 线条绘制

shuffle - 风格迁移

tile - 平铺纹理合成

face_detector - 人脸检测

调度程序

该端点还支持调度程序。使用请求正文中的“scheduler”参数传递以下列表中的特定调度程序：

该接口还支持调度程序。使用请求正文中的“scheduler”参数来设置要从以下列表中使用的特定调度程序：

DDPMScheduler

DDIMScheduler

PNDMScheduler

LMSDiscreteScheduler

EulerDiscreteScheduler

EulerAncestralDiscreteScheduler

DPMSolverMultistepScheduler

HeunDiscreteScheduler

KDPM2DiscreteScheduler

DPMSolverSinglestepScheduler

KDPM2AncestralDiscreteScheduler

UniPCMultistepScheduler

DDIMInverseScheduler

DEISMultistepScheduler

IPNDMScheduler

KarrasVeScheduler

ScoreSdeVeScheduler

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://stablediffusionapi.com/api/v1/enterprise/controlnet' \
--header 'Content-Type: application/json' \
--data-raw '{
  "key": "enterprise_api_key",
  "controlnet_model": "canny",
  "controlnet_type" :"canny",
  "model_id": "midjourney",
  "auto_hint": "yes",
  "guess_mode" : "no",
  "prompt": "a model doing photoshoot, ultra high resolution, 4K image",
  "negative_prompt": null,
  "init_image": "https://huggingface.co/datasets/diffusers/test-arrays/resolve/main/stable_diffusion_imgvar/input_image_vermeer.png",
  "mask_image": null,
  "width": "512",
  "height": "512",
  "samples": "1",
  "scheduler": "UniPCMultistepScheduler",
  "num_inference_steps": "30",
  "safety_checker": "no",
  "enhance_prompt": "yes",
  "guidance_scale": 7.5,
  "strength": 0.55,
  "seed": null,
  "webhook": null,
  "track_id": null
}'

响应示例

{
    "status": "string",
    "generationTime": 0,
    "id": 0,
    "output": [
        "string"
    ],
    "meta": {
        "prompt": "string",
        "model_id": "string",
        "controlnet_model": "string",
        "controlnet_type": "string",
        "negative_prompt": "string",
        "scheduler": "string",
        "safetychecker": "string",
        "auto_hint": "string",
        "guess_mode": "string",
        "strength": 0,
        "W": 0,
        "H": 0,
        "guidance_scale": 0,
        "seed": 0,
        "multi_lingual": "string",
        "init_image": "string",
        "mask_image": null,
        "steps": 0,
        "full_url": "string",
        "upscale": "string",
        "n_samples": 0,
        "embeddings": null,
        "lora": null,
        "outdir": "string",
        "file_prefix": "string"
    }
}

请求参数

Body 参数application/json

key

string

必需

您用于请求授权的企业API Key

model_id

string

必需

要使用的模型的 ID。它可以是公共的，也可以是您训练有素的模型。

controlnet_model

string

必需

ControlNet 型号 ID。它可以来自模型列表或用户训练的。

controlnet_type

string

必需

ControlNet 模型类型。它可以来自型号列表。

auto_hint

string

必需

自动提示图像；选项：是/否

guess_mode

string

必需

如果您没有通过任何提示，请将其设置为yes 。该模型将尝试猜测init_image中的内容并自行创建最佳变体。选项：是/否

prompt

string

必需

文本提示，包含所需图像修改的描述。尽可能详细以获得最佳结果。

negative_prompt

null

必需

图像中您不想要的项目

init_image

string

链接到初始图像

必需

control_image

string

必需

链接到 Controlnet 图像

mask_image

null

必需

链接到用于修复的蒙版图像

width

string

必需

最大高度：宽度： 1024x1024

height

string

必需

最大高度：宽度： 1024x1024

samples

string

必需

作为响应返回的图像数量。最大值为 4。

scheduler

string

必需

用它来设置调度程序。

tomesd

string

必需

启用 tomesd 生成图像：给出非常快的结果，默认值：是，选项：是/否

use_karras_sigmas

string

必需

使用 keras sigmas 生成图像。给出了很好的结果，默认值：是，选项：是/否

num_inference_steps

string

必需

去噪步骤数（最小：1；最大：50）

safety_checker

string

必需

NSFW 图像检查器。如果检测到此类图像，它将被空白图像替换。

enhance_prompt

string

必需

用它来传递嵌入模型。

guidance_scale

number

必需

无分类器指导的量表（最小值：1；最大值：20）

strength

number

必需

使用init_image时提示强度。1.0 对应于初始化映像中信息的完全破坏。

seed

null

必需

种子用于重现结果，相同的种子将再次为您提供相同的图像。为随机数传递null 。

webhook

null

必需

设置 URL 以在图像生成完成后获取 POST API 调用。

track_id

null

必需

此 ID 在 Webhook API 调用的响应中返回。这将用于识别 Webhook 请求。

示例

返回响应

🟢200成功

application/json

Body

status

string

必需

generationTime

number

必需

integer

必需

output

array[string]

必需

Controlnet

模型#

调度程序#

请求参数

返回响应

模型

调度程序