controlnet-openpose-sdxl-1.0

controlnet-openpose-sdxl-1.0

用人体姿势骨架图来控制 Stable Diffusion XL 图像中人物的姿势。适合想让人物按自己的设想站立或动作的画师和开发者。

由 xinsir 在 Hugging Face 上制作。这些说明是 Mindket 根据它的模型页面和模型卡写的，模型自己的文件和许可证在 Hugging Face 上。

简介

它是什么：这是 Stable Diffusion XL 的一个 ControlNet 附加模型，由 SDXL 基础模型微调而来。它读取一张人体姿势骨架图，引导生成的图片，让画面中的人物与这个姿势一致。作者称它是业界领先水平，并展示了 Midjourney 和动漫风格的示例图。

适合谁：它适合用 SDXL 生成图片、想固定人物姿势而不是交给运气的画师和开发者。

行业 | 谁在用 | 怎么用 | 例子
插画 | 数字画师 | 画一个姿势骨架，生成处于该姿势的角色 | 双臂举起站立的角色
游戏与动画 | 概念美术师 | 在多张图里保持角色姿势稳定 | 同一个战斗姿势的多个变体
时尚与电商 | 视觉团队 | 让模特形象用同一姿势展示不同服装 | 在固定姿势上展示一件衣服
软件开发 | 开发者 | 给图像生成工具加上姿势控制 | 基于 diffusers 的应用里的姿势输入

如果你不用 SDXL 生成图片，或者不需要控制人体姿势，可以跳过它。

用在哪里：

• 使用 diffusers 库和 SDXL ControlNet 管线的 Python 代码
• Windows、macOS 或 Linux，下载需要 Python
• 通过模型卡提到的 controlnet_aux 包做姿势预处理

用途 | 适合谁 | 得到什么
生成指定姿势的人物 | 画师 | 一张人物与骨架一致的 SDXL 图片
在多个场景里复用同一姿势 | 设计师 | 多张身体位置相同的图片
把姿势控制做进应用 | 开发者 | 一个接收姿势图和提示词的管线

如何设置：

• 你电脑上的 Python
• diffusers 库和一个 SDXL 基础模型
• 用于生成姿势图的 controlnet_aux 包
• 磁盘空间，半精度权重约 2.5 GB

1. 用 pip 安装 Hugging Face hub 软件包。
2. 下载 ControlNet 文件。
3. 把它们和 SDXL 基础模型一起加载到 diffusers 的 SDXL ControlNet 管线里。

pip install -U huggingface_hub
hf download xinsir/controlnet-openpose-sdxl-1.0

如何使用：你先从一张参考图片得到姿势图，再把这张姿势图和文字提示词交给管线。这里看到的那部分模型卡，起始代码是以这行导入开头的。

from diffusers import ControlNetModel, StableDiffusionXLControlNetPipeline, AutoencoderKL

模型卡还给了一个小提示。controlnet_aux 默认的姿势绘制用的线条比训练数据里的更细，这可能让结果不稳定。它提供了一个替换品，用来替换该包 open pose 工具文件里绘制身体的函数。

示例：有人画出或提取一个双臂举起的人的姿势骨架，并写一个花园里的角色的提示词。管线返回一张角色手臂位置与之相同的图片。模型卡的替换绘制函数就是为了让这个效果更稳定。

新手与专家：如果你是新手，先用一张清晰的姿势图和简短的提示词，检查输出的人物是否复制了骨架。参考照片尽量简单，画面里只有一个人。

如果你熟悉这个领域：模型卡说模型训练时用的姿势线条比默认绘制出来的更粗。它建议修补 controlnet_aux 里的绘制函数，让条件图像和训练时一致。这个替换函数会随图像大小来缩放线条宽度。

下载 ControlNet 文件
从参考图得到姿势图
加载带 ControlNet 的 SDXL
加上文字提示词
生成带姿势的图片

注意事项：

• Limits: 模型卡没有给出基准测试表，并且它的起始代码在这里看到的部分被截断了。
• Claims: 业界领先的说法来自作者。
• Pose drawing: 在换上模型卡里的函数之前，controlnet_aux 默认的绘制可能给出不稳定的结果。
• License: Apache 2.0。
• Cost to run: 未提及。
• Data it reaches: 它把文件复制到你的电脑，并读取你给它的图片。

Hugging Face 上的数据（2026年11月14日）

• 任务：text to image
• 框架：diffusers
• 参数量：1.3B
• Weights: about 2.5 GB in F16; about 626 MB at 4-bit (estimate)
• Formats: Safetensors
• 最近 30 天下载：294,030
• 点赞：334
• 许可证：apache-2.0
• 标签：diffusers, safetensors, openpose, controlnet, controlnet-openpose-sdxl-1.0, text_to_image, text-to-image

链接

• 模型：https://huggingface.co/xinsir/controlnet-openpose-sdxl-1.0
• 文件：https://huggingface.co/xinsir/controlnet-openpose-sdxl-1.0/tree/main

获取模型

用 Hugging Face 的命令行下载它的文件：

pip install -U huggingface_hub
hf download xinsir/controlnet-openpose-sdxl-1.0

然后按它的模型卡使用它。这个工具包里没有会自己运行的东西。