t2i-adapter-depth-zoe-sdxl-1.0

TencentARC/t2i-adapter-depth-zoe-sdxl-1.0

PublisherTencentARC

Download access requirementsMirror available

T2I-Adapter-SDXL - Depth-Zoe T2I Adapter是一个为Stable Diffusion提供额外条件控制的网络。此检查点为StableDiffusionXL模型提供深度估计条件，可根据深度图控制图像生成。根据深度图条件生成图像。深度图由Zoe深度估计方法生成，灰度图像中黑色表示深区域，白色表示浅区域。

Image Editing

View all download instructions Mirror repository documentation and license ↗

Model details

模型介绍

中文整理

T2I-Adapter-SDXL - Depth-Zoe

Model use case

T2I Adapter是一个为Stable Diffusion提供额外条件控制的网络。此检查点为StableDiffusionXL模型提供深度估计条件，可根据深度图控制图像生成。

主要能力

根据深度图条件生成图像。深度图由Zoe深度估计方法生成，灰度图像中黑色表示深区域，白色表示浅区域。

输入输出

输入：深度图（控制图像）和文本提示词

输出：生成的图像

运行要求

需要配合StableDiffusionXL基础模型使用。需要安装相关依赖包。

基本用法

将图像转换为深度图格式（控制图像）
将控制图像和文本提示词传入StableDiffusionXLAdapterPipeline

训练信息

训练数据：来自LAION-Aesthetics V2的300万对高分辨率图像-文本对

训练步数：25000步

批量大小：单GPU批量16，总批量256

学习率：固定学习率1e-5

混合精度：fp16

模型参数

Stable Diffusion XL：2.6B

T2I-Adapter-SDXL：77M/79M

License

Apache 2.0

开发者

T2I-Adapter: Learning Adapters to Dig out More Controllable Ability for Text-to-Image Diffusion Models

由Tencent ARC与Hugging Face合作开发

优先采用原作者提供的中文模型卡片；仅有英文说明时由闲社AI翻译整理。重要参数、许可证和商用范围请以原文为准。

你将获得什么

完整仓库方式包含该固定版本中的权重、配置、分词器及说明文件；指定版本方式只下载所选文件或整组分片。多模态模型的投影文件、配置等依赖，请按作者说明配齐。

完整仓库可能包含多个权重格式，因此需要的磁盘空间可能大于单一格式的模型大小。下载文件不等于完成模型部署。

使用前须知

运行环境

运行模型需要的设备、工具与依赖，以原作者说明为准。

授权范围

是否允许商用、修改和分发，请查看模型许可证。

闲社提供资料与镜像下载方法，不代表已运行模型或完成安全审计。下载的代码应先检查，再执行。

Problem with the information or download?

Pinned version · Multiple download options

t2i-adapter-depth-zoe-sdxl-1.0 model download

Download the full repository or choose a version or file.

Download tools · More than GGUF

Use the Hugging Face download tool to obtain TencentARC/t2i-adapter-depth-zoe-sdxl-1.0. Download Safetensors, GGUF, ONNX, configuration and other repository files. Downloading does not mean the tool can run this model.

Pinned-version file information is being completed. Existing downloads remain available, or load the file manifest below.

Choose a mirror or official source, your operating system and download scope below, then copy the command. Install the download tool first if needed.

Pinned version: b1e696d5a87bf32f7cd6e8f4e85372f833769720. Downloads files only; does not start the model.

Choose a download source

已根据访问地区推荐 Hugging Face 官方线路，你可以手动切换。

Choose what to download

Need just one GGUF precision? Load the file manifest and choose a version. Direct file links do not require Python; the command below can download multiple shards together.

Quantization / file

This reads the pinned version's file manifest; no model weights are downloaded.

Choose your operating system

For command-line downloads, follow these steps to get the full repository or selected files. Direct file links do not need these steps.

Open a terminal window

Create and open a folder for the model. In the folder's address bar, enter powershell and press Enter.

If Python is not installed, get it from the official Python website. In the terminal, enter python --version; continue when a version number appears.

First time? Install the download tool

Copy this command, paste it into the terminal, press Enter and wait for installation to finish.

python -m pip install --upgrade huggingface_hub

Already installed? Continue to step 3.

Run the download command

Select the button below, paste into the same terminal and press Enter. The tool downloads all files included in the current command.

Copying does not start a download. Paste and run the command on your device.

Where are the downloaded files?

Open the folder you chose. Look for the models folder. When progress stops and the terminal returns to its prompt without errors, check that all files are present. 'Copied' does not mean 'downloaded'.

No response or an error?

python not found: Install Python and reopen the terminal. On Windows, follow the installer's instructions to enable command-line access.

hf not found: Confirm that step 2 succeeded, then reopen the terminal. If needed, add Python's Scripts folder to your user PATH. Do not repeatedly download scripts.

Network interrupted: Stay in the same folder and run the same command again. The tool checks existing files.

Permission or disk error: Choose a writable folder with enough free space. Do not disable system security protection.

View the full download command

$env:HF_ENDPOINT = "https://huggingface.co"
$env:HF_HUB_DISABLE_IMPLICIT_TOKEN = "1"
$env:HF_HUB_DISABLE_XET = "1"
hf download "TencentARC/t2i-adapter-depth-zoe-sdxl-1.0" --revision "b1e696d5a87bf32f7cd6e8f4e85372f833769720" --local-dir "./models/TencentARC--t2i-adapter-depth-zoe-sdxl-1.0"

Files transfer directly from the source you choose, not through Xianshe servers.

The version is pinned. Repeating the same command checks existing files. Change the source manually if it is slow or unavailable.

Public models do not require submitting keys to Xianshe. Restricted models still require the author's authorization. On Linux / macOS, use python3 instead of python when appropriate.