Stable Diffusion

ControlNet 多功能终端

POSThttps://stablediffusionapi.com/api/v5/controlnet

您现在可以指定多个 ControlNet模型。只需确保将逗号分隔的ControlNet 模型传递给请求正文中的controlnet_model参数“canny,深度”即可。init_image

提示

您还可以使用此端点通过 ControlNet 修复图像。只需确保将链接传递到mask_image请求正文中，并使用“inpaint”值传递 controlnet_model 参数。

信息

请阅读我们有关 ControlNet 的详细**博客文章**。

POST向https://stablediffusionapi.com/api/v5/controlnet端点发送请求。

您现在可以指定多个 ControlNet模型。只需确保将逗号分隔的ControlNet 模型传递给请求正文中的controlnet_model参数“canny,深度”即可。init_image

提示

您还可以使用此端点通过 ControlNet 修复图像。只需确保将链接传递到mask_image请求正文中，并使用“inpaint”值传递 controlnet_model 参数。

信息

请阅读我们有关 ControlNet 的详细**博客文章**。

POST向https://stablediffusionapi.com/api/v5/controlnet端点发送请求。

提示
您也可以使用多个 ControlNet 模型。只需在请求体中,将逗号分隔的控制网模型作为"canny,depth" 传递给 controlnet_model,并将 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 - 人脸检测
qrcode - QR码检测

调度程序

该端点还支持调度程序。使用请求正文中的“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 生成图像。给出了很好的结果，默认值：是，选项：是/否

algorithm_type

string

必需

用于 DPMSolverMultistepScheduler 调度程序，默认值：none，选项：dpmsolver+++

vae

null

必需

使用自定义 vae 生成图像默认值：null

lora_strength

null

必需

使用不同的 lora 强度默认值：null

lora_model

string

必需

支持多 lora，传递逗号分隔值。对比修复示例，yae-miko-genshin

num_inference_steps

string

必需

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

safety_checker

string

必需

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

embeddings_model

null

必需

用它来传递嵌入模型。

enhance_prompt

string

必需

增强提示以获得更好的结果；默认：是，选项：是/否

multi_lingual

string

必需

使用与英语不同的语言；默认：是，选项：是/否

controlnet_conditioning_scale

number

必需

“guidance_scale”用于 controlnet，用于 controlnet 指导的比例。接受 0.1 到 5 之间的浮点值（例如 0.5）

strength

number

必需

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

seed

null

必需

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

webhook

null

必需

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

track_id

null

必需

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

upscale

string

必需

如果您想要将给定图像分辨率放大两倍 (2x)，请将此参数设置为“yes”。如果请求的分辨率为 512 x 512 像素，则生成的图像将为 1024 x 1024 像素。

clip_skip

string

必需

剪辑跳过（最小值：1；最大值：8）

guidance_scale

number

必需

{
  "key": "",
  "controlnet_model": "openpose,canny,face_detector",
  "controlnet_type": "openpose",
  "model_id": "midjourney",
  "auto_hint": "yes",
  "guess_mode": "yes",
  "prompt": "human model doing photoshoot, ultra realistic face, ultra high resolution, 4K image",
  "negative_prompt": null,
  "control_image": "https://huggingface.co/takuma104/controlnet_dev/resolve/main/gen_compare/control_images/converted/control_human_openpose.png",
  "init_image": "https://cdn.stablediffusionapi.com/generations/0-4957a91a-a45e-459e-b4cd-b3ca4013b847.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,
  "controlnet_conditioning_scale": 0.7,
  "strength": 0.55,
  "lora_model": "yae-miko-genshin,more_details",
  "clip_skip": "2",
  "tomesd": "yes",
  "use_karras_sigmas": "yes",
  "vae": null,
  "lora_strength": null,
  "embeddings_model": null,
  "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

必需

safety_checker

string

必需

auto_hint

string

必需

guess_mode

string

必需

strength

string

必需

integer

必需

integer

必需

guidance_scale

number

必需

controlnet_conditioning_scale

string

必需

seed

integer

必需

multi_lingual

string

必需

use_karras_sigmas

string

必需

tomesd

string

必需

init_image

string

必需

mask_image

null

必需

control_image

string

必需

vae

null

必需

steps

integer

必需

full_url

string

必需

upscale

string

必需

n_samples

integer

必需

embeddings

null

必需

lora

string

必需

lora_strength

integer

必需

temp

string

必需

base64

string

必需

clip_skip

integer

必需

file_prefix

string

必需

{
  "status": "success",
  "generationTime": 14.463637351989746,
  "id": 32303444,
  "output": [
    "https://cdn.stablediffusionapi.com/generations/0-0dcf98b7-c397-4536-bd56-f0bf69c6ec1a.png"
  ],
  "meta": {
    "prompt": "mdjrny-v4 style human model doing photoshoot, ultra realistic face, ultra high resolution, 4K image",
    "model_id": "midjourney",
    "controlnet_model": "openpose,canny,face_detector",
    "controlnet_type": "openpose",
    "negative_prompt": "",
    "scheduler": "UniPCMultistepScheduler",
    "safety_checker": "no",
    "auto_hint": "yes",
    "guess_mode": "yes",
    "strength": "1",
    "W": 512,
    "H": 512,
    "guidance_scale": 7.5,
    "controlnet_conditioning_scale": "0.7",
    "seed": 465647573,
    "multi_lingual": "no",
    "use_karras_sigmas": "yes",
    "tomesd": "yes",
    "init_image": "https://cdn.stablediffusionapi.com/generations/0-4957a91a-a45e-459e-b4cd-b3ca4013b847.png",
    "mask_image": null,
    "control_image": "https://huggingface.co/takuma104/controlnet_dev/resolve/main/gen_compare/control_images/converted/control_human_openpose.png",
    "vae": null,
    "steps": 20,
    "full_url": "no",
    "upscale": "no",
    "n_samples": 1,
    "embeddings": null,
    "lora": "yae-miko-genshin,more_details",
    "lora_strength": 1,
    "temp": "no",
    "base64": "no",
    "clip_skip": 2,
    "file_prefix": "0dcf98b7-c397-4536-bd56-f0bf69c6ec1a.png"
  }
}

最后修改时间： 1 年前