开源项目解析
InstantID
一张脸照做身份保持生成,零样本、免调优。
一张脸就能锁角色权重仅研究用途
许可证附加条件:权重仅研究用途
读懂层
2 张 · 架构图 / 流程图
DeepWiki 架构页;antelopev2 权重为非商用 · 核验 2026-08-16
DeepWiki 架构页 · 抓取 2026-08-16 · 核验 2026-08-16
它管哪几个决定
角色跨镜头一致角色参考 · 多参考 · LoRA
7/10 家有官方说法自持能力
权重在不在本地可下载到本地
种子能不能填不涉及
换掉它要动几处几处
权重可下载但仅限研究用途;人脸模型另有非商用限制
动手层
文档代码结构踩过的坑实测 未做
装它要过哪几关
- 1下三个文件到 ./checkpoints/`ControlNetModel/config.json`、`ControlNetModel/diffusion_pytorch_model.safetensors`、`ip-adapter.bin`
- 2手动下 antelopev2 到 models/antelopev2官方默认链接失效,要从 insightface 的 issue #1896 里拿 —— 这一步卡住的人最多
- 3跑 pipeline_stable_diffusion_xl_instantid.py显存紧张就开 `pipe.enable_model_cpu_offload()` 与 `pipe.enable_vae_tiling()`
改哪个文件能改什么
controlnet_conditioning_scale管 IdentityNet,即长得像不像。**官方建议起手 0.8**ip_adapter_scale管身份保持。**过饱和先降它**,还不行再降上面那个基础模型官方明说换基础模型差别很大 —— 出不来想要的风格先换底模,别硬调 scale坑在哪一处
带 issue 编号的来自:github issues 按回复数排序 · 核验 2026-08-16
显存仓库不说要多少,issue #104 标题直接写着「Uses 24 GB VRAM」,#61 也在问最低要求、#72 报 CUDA OOM。这是本专项里唯一靠 issue 才问得出显存的项目 —— 官方没给,用户实测 24GB
antelopev2 下载官方默认链接失效,要从 insightface 的 issue #1896 里拿。这一步卡住的人最多
权重许可证代码是 Apache,权重仅限研究用途;antelopev2 另有非商用限制。仓库首页那个徽章只覆盖代码
多人画面只取最大的那张脸;#81「How to Use Multi-ID」开着,说明多人这条路官方也还没铺好
文字控制变弱身份锁得越死提示词越不起作用,官方解法是降 ip_adapter_scale
教程
没找到官方口径的教程 —— 官方只给了 README。
项目自述
以下是仓库 README 的开头部分(原文引用,抓取 2026-08-17)。读全文 ↗
InstantID: Zero-shot Identity-Preserving Generation in Seconds Qixun Wang12 · Xu Bai12 · Haofan Wang12* · Zekui Qin12 · Anthony Chen123 Huaxia Li2 · Xu Tang2 · Yao Hu2 1InstantX Team · 2Xiaohongshu Inc · 3Peking University *corresponding authors InstantID is a new state-of-the-art tuning-free method to achieve ID-Preserving generation with only single image, supporting various downstream tasks. Release - [2024/07/18] 🔥 We are training InstantID for Kolors. The weight requires significant computational power, which is currently in the process of iteration. After the model training is completed, it will be open-sourced. The latest checkpoint results are referenced in Kolors Version. - [2024/04/03] 🔥 We release our recent work InstantStyle for style transfer, compatible with InstantID! - [2024/02/01] 🔥 We have supported LCM acceleration and Multi-ControlNets on our Huggingface Spaces Demo! Our depth estimator is supported by Depth-Anything. - [2024/01/31] 🔥 OneDiff now supports accelerated inference for InstantID, check this for details! - [2024/01/23] 🔥 Our pipeline has been merged into diffusers! - [2024/01/22] 🔥 We release the pre-trained checkpoints, inference code and gradio demo! - [2024/01/15] 🔥 We release the technical report. - [2023/12/11] 🔥 We launch the project page. Demos Stylized Synthesis Comparison with Previous Works Comparison with existing tuning-free state-of-the-art techniques. InstantID achieves better fidelity and retain good text editability (faces and styles blend better). Comparison with pre-trained character LoRAs. We don't need multiple images and still can achieve competitive results as LoRAs without any training. Comparison with InsightFace Swapper (also known as ROOP or Refactor). However, in non-realistic style, our work is more flexible on the integration of face and background. Kolors Version We have adapted InstantID for Kolors. Leveraging Kolors' robust text generation capabilities 👍👍👍, InstantID can be integrated with Kolors to simultaneously generate ID and text. | demo | demo | demo | Download You can directly download the model from Huggingface. You also can download the model in python script: python from huggingface_hub import hf_hub_download hf_hub_download(repo_id="InstantX/InstantID", filename="ControlNetModel/config.json", local_dir="./checkpoints") hf_hub_download(repo_id="InstantX/InstantID", filename="ControlNetModel/diffusion_pytorch_model.safetensors", local_dir="./checkpoints") hf_hub_download(repo_id="InstantX/InstantID", filename="ip-adapter.bin", local_dir="./checkpoints") Or run the following command to download all models: python pip install -r gradio_demo/requirements.txt python gradio_demo/download_models.py If you cannot access to Huggingface, you can use hf-mirror to download models. python export HF_ENDPOINT=https://hf-mirror.com huggingface-cli download --resume-download InstantX/InstantID --local-dir checkpoints --local-dir-use-symlinks False For face encoder, you need to manually download via this URL to models/antelopev2 as the default link is invalid. Once you have prepared all models, the folder tree should be like: . ├── models ├── check ……(后略,见原文)
判断
优势
- 一张照片即可,不需要训练
- 身份保持效果在同类里成熟
- 接入方式与 ControlNet 类似,链路熟悉
局限
- 权重仅限研究用途,insightface 人脸模型非商用 —— 仓库首页的 Apache 徽章只覆盖代码
- 停更 25 个月(最后提交 2024-07-18),多人支持那条路就此停在原地
- 不支持多人,只取画面里最大的那张脸
不适用
任何商用交付 —— 许可证不允许。
同管这些决定的其它项目
ComfyUI节点式工作流底座。图像 / 视频 / 音频 / 3D / 文本共用一个底座。…MiniMax H3全模态生成:文字、图片、视频、音频进同一个 Transformer,出带 32kHz…IP-Adapter用图片当提示词,锁住风格或人物。仅 22M 参数。…kohya sd-scripts训练脚本集:覆盖 SD1.x/2.x、SDXL、SD3/3.5、FLUX.1;202…musubi-tuner视频模型的 LoRA 训练器。同一套代码训 Wan 2.1/2.2、HunyuanV…火宝短剧基于 AI 的一站式短剧生成平台,从剧本到成片全自动化。…ToonflowAI 创作平台:无限画布、AI Agent、可视化工作流,支持图像、视频、分镜和短剧…infinite-canvas面向 AI 创作的无限画布工作台:生图、参考图编辑、视频生成、Agent 助手、画布…open-ai-canvas面向 AI 影视创作的无限画布:多模态生成、分镜编排、素材管理、Agent 工作流。…VOZEB PRO把统一创作 Agent、画布、短剧生产线、素材库和商业运营后台放进同一套 Next.…Generative Media Skills给 Agent(Claude Code / Cursor / Gemini CLI)…ComfyUI-WanVideoWrapper把 Wan 系列模型接进 ComfyUI 的节点包。社区里跑 Wan 的事实标准封装…waoowaoo把一部小说灌进去,自动拆角色、拆场景、出分镜,再合成整集短剧。中英双界面。…JellyfishAI 短剧的端到端工作台:从剧本进,到分镜、角色一致性管理、出片、导出。…魔因漫创桌面端 AI 影视工具(Electron):剧本 → 角色 → 场景 → 导演 → …BigBanana AI Director一站式 AI 短剧 / 漫剧工作台,四阶段:剧本 → 视觉资产 → 分镜制作 → 导…ClipForge带货短视频专用的一站式工具:上传商品图,自动提炼卖点、写种草脚本、配音配字幕加背景乐…Open AI UGC生成 UGC 风格的口播广告:用多个视频模型出真人感的 AI 演员念你的脚本。定位是…LiveTalking实时交互流式数字人引擎,音视频同步对话。支持 ernerf、musetalk、wav…Drama Skills面向编剧与漫剧工作室的短剧创作流水线:十个技能把一个点子或一部长篇材料,一路做成分集…
github README + DeepWiki 架构页 · 核验 2026-10-19 | 判断栏可报错。