Controlnet

POSThttps://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

请求参数

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 请求。

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

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

status

string

必需

generationTime

number

必需

integer

必需

output

array[string]

必需

meta

object

必需

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

number

必需

integer

必需

integer

必需

guidance_scale

integer

必需

seed

integer

必需

multi_lingual

string

必需

init_image

string

必需

mask_image

null

必需

steps

integer

必需

full_url

string

必需

upscale

string

必需

n_samples

integer

必需

embeddings

null

必需

lora

null

必需

outdir

string

必需

file_prefix

string

必需

{
  "status": "success",
  "generationTime": 3.6150574684143066,
  "id": 14905468,
  "output": [
    "https://pub-8b49af329fae499aa563997f5d4068a4.r2.dev/generations/b989586c-0a5f-41fa-91de-1c5ed5498349-0.png"
  ],
  "meta": {
    "prompt": "mdjrny-v4 style a model doing photoshoot, ultra high resolution, 4K image",
    "model_id": "midjourney",
    "controlnet_model": "canny",
    "controlnet_type": "canny",
    "negative_prompt": "",
    "scheduler": "UniPCMultistepScheduler",
    "safetychecker": "no",
    "auto_hint": "yes",
    "guess_mode": "no",
    "strength": 0.55,
    "W": 512,
    "H": 512,
    "guidance_scale": 3,
    "seed": 254638058,
    "multi_lingual": "no",
    "init_image": "https://huggingface.co/datasets/diffusers/test-arrays/resolve/main/stable_diffusion_imgvar/input_image_vermeer.png",
    "mask_image": null,
    "steps": 20,
    "full_url": "no",
    "upscale": "no",
    "n_samples": 1,
    "embeddings": null,
    "lora": null,
    "outdir": "out",
    "file_prefix": "b989586c-0a5f-41fa-91de-1c5ed5498349"
  }
}

最后修改时间： 1 年前