Skip to content

ReShot — copy the shot, not the actors. Video → depth map, OpenPose skeleton or canny lines for Seedance 2.0/2.5 reference video, MiniMax H3 Fun ControlNet and Wan VACE. Apache-2.0. Open-sourced by Maosika 猫斯卡 (www.maosika.com), the AI short-drama production system.

wording: depth map, not blockout (v0.3.1)

wangfengcdead4db0a97
diff --git a/CHANGELOG.md b/CHANGELOG.md
index e0887cc..71c4b3b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,10 @@
# Changelog
+## 0.3.1 — 2026-09-12
+- Wording: the output is called what it is — a **depth map** (relative inverse depth, monocular
+ video depth estimation), no longer a "blockout" (that term means untextured 3D geometry).
+ Docs, CLI help, Space page and demo labels updated; `demo.make_blockout` → `make_depth_map`.
+
## 0.3.0 — 2026-09-12
- **Renamed: depthcat → ReShot.** Package, CLI, env var and error class follow:
`pip install git+https://github.com/maosika-ai/reshot`, `reshot in.mp4 -o out.mp4`,
diff --git a/README.md b/README.md
index 78d41f2..e87dff7 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,9 @@
<h1 align="center">ReShot</h1>
<p align="center"><b>Copy the shot, not the actors.</b></p>
-<p align="center"><sub>Open-source depth-blockout tool from <a href="https://www.maosika.com">Maosika 猫斯卡</a>, the AI short-drama production system.</sub></p>
+<p align="center"><sub>Open-source depth-map tool from <a href="https://www.maosika.com">Maosika 猫斯卡</a>, the AI short-drama production system.</sub></p>
-<p align="center"><img src="docs/demo.gif" width="720" alt="a fight scene, its depth blockout, and a new fight generated from it"></p>
-<p align="center"><sub>A fight scene. Its depth blockout. A new take — different fighters, same choreography, same camera.</sub></p>
+<p align="center"><img src="docs/demo.gif" width="720" alt="a fight scene, its depth map, and a new fight generated from it"></p>
+<p align="center"><sub>A fight scene. Its depth map. A new take — different fighters, same choreography, same camera.</sub></p>
<p align="center"><a href="README.zh-CN.md">中文</a> · <a href="docs/USAGE.md">User guide</a> · <a href="https://huggingface.co/spaces/maosika/reshot">Hugging Face</a> · <a href="CHANGELOG.md">Changelog</a></p>
<p align="center">
@@ -27,24 +27,28 @@ the wardrobe, the style — everything you didn't ask for.
## Keep the choreography. Change everything else.
-ReShot turns a reference clip into a depth blockout: a clean, silent record of the
+ReShot turns a reference clip into a depth map: a clean, silent record of the
staging and nothing else. Near is white, far is black, every frame in step with the last.
No faces. No costumes. No style. Just the shot.
-Give the blockout to your video model along with a prompt for the look, and you get the
+Technically: monocular video depth estimation. The model predicts relative inverse depth
+for every frame; ReShot normalises it once over the whole clip to 8-bit grey (near = white)
+and encodes it as a standard depth-map video.
+
+Give the depth map to your video model along with a prompt for the look, and you get the
reference's blocking and camera with your cast in it.
```bash
pip install git+https://github.com/maosika-ai/reshot
-reshot reference.mp4 -o blockout.mp4 --target seedance
+reshot reference.mp4 -o depth.mp4 --target seedance
```
That's the whole thing.
## Works with the models you already use.
-**Seedance 2.0 and 2.5.** Add the blockout as a reference video and ask for its motion
-and camera. The blockout meets the API's reference-video requirements out of the box —
+**Seedance 2.0 and 2.5.** Add the depth map as a reference video and ask for its motion
+and camera. The depth map meets the API's reference-video requirements out of the box —
24 fps, H.264, sized for the model — and because it carries no likeness, it passes the
content checks that stop real footage.
@@ -52,7 +56,7 @@ content checks that stop real footage.
参考@视频1的动作与运镜。两名武者在雨夜屋顶对决,黑色劲装,冷蓝月光,电影感。
```
-**MiniMax H3 Fun ControlNet.** Use the blockout as the depth condition. 24 fps, frame size
+**MiniMax H3 Fun ControlNet.** Use the depth map as the depth condition. 24 fps, frame size
a multiple of 32, up to 15 seconds — the preset handles it.
**Wan VACE, and any depth ControlNet.** It's a standard near-white depth video. If your
@@ -67,7 +71,7 @@ model reads depth, it reads this.
## Steady by design.
-A blockout is only useful if the model trusts it. So ReShot is built around the details
+A depth map is only useful if the model trusts it. So ReShot is built around the details
that make a depth video hold still.
- **It sees the whole clip.** The model works on overlapping windows of 32 frames and
@@ -90,7 +94,7 @@ Batch a folder of references in a shell loop, or call it from Python:
from pathlib import Path
from reshot import RunConfig, run
-run(RunConfig(input=Path("reference.mp4"), output=Path("blockout.mp4"), target="seedance"))
+run(RunConfig(input=Path("reference.mp4"), output=Path("depth.mp4"), target="seedance"))
```
## Yours to ship.
@@ -125,7 +129,7 @@ images, and renders every shot with video models such as **Seedance 2.0 / 2.5**
produce a series that used to take a studio. Individual screenwriters, MCNs and short-drama
companies use Maosika to produce AI short drama every day.
-ReShot is the depth-blockout step of that pipeline, released under Apache-2.0 so anyone
+ReShot is the depth-map step of that pipeline, released under Apache-2.0 so anyone
can copy a reference shot's staging and camera into their own AI-generated video. To make
AI short drama, AI short video or AI manhua drama end to end, visit
**[https://www.maosika.com](https://www.maosika.com)**.
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 27437f1..79942b3 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -1,9 +1,9 @@
<h1 align="center">ReShot</h1>
<p align="center"><b>复制走位,不复制演员。</b></p>
-<p align="center"><sub>由 AI 短剧生产系统 <a href="https://www.maosika.com">猫斯卡</a> 开源的深度白模工具。</sub></p>
+<p align="center"><sub>由 AI 短剧生产系统 <a href="https://www.maosika.com">猫斯卡</a> 开源的深度图工具。</sub></p>
-<p align="center"><img src="docs/demo.gif" width="720" alt="一段武打参考片、它的深度白模、用白模生成的新武打片"></p>
-<p align="center"><sub>一段武打。它的深度白模。一段新片——换了人,招式和镜头一模一样。</sub></p>
+<p align="center"><img src="docs/demo.gif" width="720" alt="一段武打参考片、它的深度图、用深度图生成的新武打片"></p>
+<p align="center"><sub>一段武打。它的深度图。一段新片——换了人,招式和镜头一模一样。</sub></p>
<p align="center"><a href="README.md">English</a> · <a href="docs/USAGE.zh-CN.md">使用手册</a> · <a href="https://huggingface.co/spaces/maosika/reshot">Hugging Face</a> · <a href="CHANGELOG.md">更新日志</a></p>
<p align="center">
@@ -26,29 +26,32 @@
## 招式留下,其余全换。
-ReShot 把一段参考片变成深度白模:只记录走位、别的什么都没有。近处白、远处黑,
+ReShot 把一段参考片变成深度图:只记录走位、别的什么都没有。近处白、远处黑,
每一帧都和上一帧严丝合缝。没有脸,没有衣服,没有风格。只有这个镜头本身。
-把白模交给视频模型,提示词里写你要的长相,出来的就是参考片的走位和运镜,演的是你的人。
+严格地说,这是单目视频深度估计:模型对每一帧预测相对逆深度,ReShot 对整段视频做一次归一化,
+变成 8 位灰度(近白远黑),再编码成标准的深度图视频。
+
+把深度图交给视频模型,提示词里写你要的长相,出来的就是参考片的走位和运镜,演的是你的人。
```bash
pip install git+https://github.com/maosika-ai/reshot
-reshot 参考片.mp4 -o 白模.mp4 --target seedance
+reshot 参考片.mp4 -o 深度图.mp4 --target seedance
```
就这么多。
## 你在用的模型,它都接得上。
-**Seedance 2.0 和 2.5。** 把白模当参考视频传进去,让它参考动作和运镜。
-白模出厂就符合官方参考视频的要求——24 fps、H.264、尺寸合规——而且因为它不含任何真人特征,
+**Seedance 2.0 和 2.5。** 把深度图当参考视频传进去,让它参考动作和运镜。
+深度图出厂就符合官方参考视频的要求——24 fps、H.264、尺寸合规——而且因为它不含任何真人特征,
真人素材过不了的审核,它能过。
```
参考@视频1的动作与运镜。两名武者在雨夜屋顶对决,黑色劲装,冷蓝月光,电影感。
```
-**MiniMax H3 Fun ControlNet。** 白模作为 depth 条件。24 fps、边长 32 的倍数、最长 15 秒,预设都替你算好了。
+**MiniMax H3 Fun ControlNet。** 深度图作为 depth 条件。24 fps、边长 32 的倍数、最长 15 秒,预设都替你算好了。
**Wan VACE 和任何深度 ControlNet。** 它就是标准的近白远黑深度视频。模型认深度,就认它。
@@ -61,7 +64,7 @@ reshot 参考片.mp4 -o 白模.mp4 --target seedance
## 稳,是设计出来的。
-白模只有让模型信得过才有用。所以 ReShot 围绕"深度视频怎么才能不抖"来做。
+深度图只有让模型信得过才有用。所以 ReShot 围绕"深度视频怎么才能不抖"来做。
- **它看的是整段片子。** 模型以 32 帧为一个窗口重叠推理并对齐,深度不会一帧一帧地跳。
- **整个镜头只用一把尺子。** 亮度就是距离,第 1 帧和第 300 帧里同样的亮度是同样的距离。
@@ -80,7 +83,7 @@ reshot 参考片.mp4 -o 白模.mp4 --target seedance
from pathlib import Path
from reshot import RunConfig, run
-run(RunConfig(input=Path("参考片.mp4"), output=Path("白模.mp4"), target="seedance"))
+run(RunConfig(input=Path("参考片.mp4"), output=Path("深度图.mp4"), target="seedance"))
```
## 放心用在产品里。
@@ -110,7 +113,7 @@ ReShot 由 **[猫斯卡](https://www.maosika.com)**(www.maosika.com)开源
**MiniMax H3** 等视频模型把每一镜拍出来——每个环节都由对应的数字专家接手,一个人就能完成过去
一个团队才能做的竖屏短剧。个人编剧、MCN 机构和短剧公司每天都在用猫斯卡生产 AI 短剧。
-ReShot 是这条生产线里的「深度白模」环节,以 Apache-2.0 协议开源,任何人都可以用它把参考镜头的
+ReShot 是这条生产线里的「深度图」环节,以 Apache-2.0 协议开源,任何人都可以用它把参考镜头的
走位和运镜复制到自己的 AI 视频里。想端到端做 AI 短剧、AI 短视频、AI 漫剧,请访问
**[https://www.maosika.com](https://www.maosika.com)**。
diff --git a/demo/README.md b/demo/README.md
index b78f22a..ecc1c15 100644
--- a/demo/README.md
+++ b/demo/README.md
@@ -13,7 +13,7 @@ short_description: Copy the shot, not the actors. By Maosika 猫斯卡.
# ReShot
-Turn any video into a depth blockout — the control signal that lets a video model copy a
+Turn any video into a depth map — the control signal that lets a video model copy a
shot's **staging and camera** without copying its faces, wardrobe or style.
- Code, CLI and docs: https://github.com/maosika-ai/reshot (Apache-2.0)
diff --git a/demo/app.py b/demo/app.py
index d4ac218..4918539 100644
--- a/demo/app.py
+++ b/demo/app.py
@@ -1,6 +1,6 @@
"""reshot — Hugging Face Space demo.
-Upload a short clip, get a depth blockout video back. Runs on the free CPU tier, so the
+Upload a short clip, get a depth-map video back. Runs on the free CPU tier, so the
demo caps the clip (see LIMITS) and defaults to the faster 364-px model input. The same
`reshot.run()` the CLI uses does all the work; this file is only the UI.
"""
@@ -20,11 +20,11 @@ LIMITS = {"max_seconds": 4, "max_res": 640} # free CPU: ~2–4 s per frame at m
FAKE = bool(os.environ.get("RESHOT_FAKE_BACKEND")) # used by the local smoke test only
-def make_blockout(video: str | None, target: str, input_size: int, invert: bool, gamma: float):
+def make_depth_map(video: str | None, target: str, input_size: int, invert: bool, gamma: float):
if not video:
raise gr.Error("Upload a video first.")
workdir = Path(tempfile.mkdtemp(prefix="reshot-"))
- out = workdir / "blockout.mp4"
+ out = workdir / "depth.mp4"
fps_cap = {"none": 24.0, "seedance": None, "h3": None, "wan": None}[target] # keep the free CPU honest
max_frames = int(LIMITS["max_seconds"] * 24)
cfg = RunConfig(
@@ -56,7 +56,7 @@ with gr.Blocks(title="ReShot") as demo:
gr.Markdown(
f"""
# ReShot
-**Video → depth blockout** for video generation: Seedance reference video, MiniMax H3 Fun ControlNet, Wan VACE, ….
+**Video → depth map** for video generation: Seedance reference video, MiniMax H3 Fun ControlNet, Wan VACE, ….
Keeps a shot's staging and camera, drops faces, wardrobe and style.
Code and CLI: [github.com/maosika-ai/reshot](https://github.com/maosika-ai/reshot) · Apache-2.0
@@ -79,11 +79,11 @@ Expect 1–3 minutes. For full clips and GPU speed, run it locally: `pip install
)
invert = gr.Checkbox(False, label="Invert (far = white)")
gamma = gr.Slider(0.6, 1.8, value=1.0, step=0.05, label="Gamma")
- btn = gr.Button("Make blockout", variant="primary")
+ btn = gr.Button("Make depth map", variant="primary")
with gr.Column():
- out = gr.Video(label="Depth blockout (download → feed to your ControlNet)")
+ out = gr.Video(label="Depth map (download → feed to your ControlNet)")
note = gr.Markdown()
- btn.click(make_blockout, [src, target, input_size, invert, gamma], [out, note])
+ btn.click(make_depth_map, [src, target, input_size, invert, gamma], [out, note])
ex = Path(__file__).with_name("example.mp4")
if ex.exists():
gr.Examples([[str(ex), "h3", 364, False, 1.0]], [src, target, input_size, invert, gamma])
diff --git a/demo/requirements.txt b/demo/requirements.txt
index bc0e818..842369e 100644
--- a/demo/requirements.txt
+++ b/demo/requirements.txt
@@ -1,5 +1,5 @@
--extra-index-url https://download.pytorch.org/whl/cpu
torch
torchvision
-reshot[ffmpeg] @ git+https://github.com/maosika-ai/[email protected]
+reshot[ffmpeg] @ git+https://github.com/maosika-ai/[email protected]
gradio>=4.0
diff --git a/demo/space/README.md b/demo/space/README.md
index 3d172ef..ec6c197 100644
--- a/demo/space/README.md
+++ b/demo/space/README.md
@@ -11,7 +11,7 @@ short_description: Copy the shot, not the actors. By Maosika 猫斯卡.
# ReShot
-Copy the shot, not the actors. ReShot turns any reference video into a depth blockout — the
+Copy the shot, not the actors. ReShot turns any reference video into a depth map — the
control signal that lets a video model copy a shot's **staging and camera** without copying
its faces, wardrobe or style.
diff --git a/demo/space/index.html b/demo/space/index.html
index 19c2377..5fbd45d 100644
--- a/demo/space/index.html
+++ b/demo/space/index.html
@@ -4,7 +4,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>ReShot — copy the shot, not the actors · by Maosika 猫斯卡</title>
-<meta name="description" content="ReShot turns a reference video into a depth blockout for Seedance 2.0/2.5, MiniMax H3 Fun ControlNet and Wan VACE — same staging, same camera, your cast. Open-sourced by Maosika 猫斯卡 (www.maosika.com), the AI short-drama production system.">
+<meta name="description" content="ReShot turns a reference video into a depth map for Seedance 2.0/2.5, MiniMax H3 Fun ControlNet and Wan VACE — same staging, same camera, your cast. Open-sourced by Maosika 猫斯卡 (www.maosika.com), the AI short-drama production system.">
<link rel="canonical" href="https://huggingface.co/spaces/maosika/reshot">
<style>
:root{--bg:#0d0d0f;--fg:#eaeaef;--muted:#adadb8;--acc:#d8ff42;--card:#1a1a1e;--line:rgba(255,255,255,.08)}
@@ -29,14 +29,14 @@
</head>
<body><main>
<h1>Re<span>Shot</span></h1>
-<p class="tag"><b>Copy the shot, not the actors.</b> Turn a reference video into a depth blockout your video model can follow — same staging, same camera, your cast, your style.<br><span class="zh"><b>复制走位,不复制演员。</b>把参考视频抽成视频模型能跟着走的深度白模——走位一样、镜头一样,人是你的,画风是你的。</span></p>
+<p class="tag"><b>Copy the shot, not the actors.</b> Turn a reference video into a depth map your video model can follow — same staging, same camera, your cast, your style.<br><span class="zh"><b>复制走位,不复制演员。</b>把参考视频抽成视频模型能跟着走的深度图——走位一样、镜头一样,人是你的,画风是你的。</span></p>
<p class="zh"><sub>Open-sourced by <a href="https://www.maosika.com">Maosika 猫斯卡</a>, the AI short-drama production system · 由 AI 短剧生产系统 <a href="https://www.maosika.com">猫斯卡</a> 开源</sub></p>
-<img class="demo" src="demo.gif" alt="left: reference video, right: ReShot depth blockout">
-<p class="cap">left: reference · right: ReShot blockout — near is white, far is black, every frame in step with the last</p>
+<img class="demo" src="demo.gif" alt="left: reference video, right: ReShot depth map">
+<p class="cap">left: reference · right: ReShot depth map — near is white, far is black, every frame in step with the last</p>
<pre><code>pip install git+https://github.com/maosika-ai/reshot
-reshot reference.mp4 -o blockout.mp4 --target seedance</code></pre>
+reshot reference.mp4 -o depth.mp4 --target seedance</code></pre>
<div class="row">
<a class="btn" href="https://github.com/maosika-ai/reshot">GitHub · code &amp; docs</a>
@@ -46,8 +46,8 @@ reshot reference.mp4 -o blockout.mp4 --target seedance</code></pre>
</div>
<h2>Every shot is two things. <span class="zh">/ 每个镜头都是两样东西</span></h2>
-<p>Where people are and how the camera moves — and who they are and what it looks like. A reference clip gives you both at once; you only wanted the first. ReShot keeps the staging and the camera and drops everything else: no faces, no wardrobe, no style. Give the blockout to your model with a prompt for the look, and you get the reference's blocking with your cast in it.</p>
-<p class="zh">走位和运镜,以及画面里的人和风格。参考片两样一起给你,你只想要前一样。ReShot 留下走位和镜头,去掉其余一切——没有脸、没有服装、没有画风。把白模交给模型,再告诉它你要的样子,就得到参考片的走位、你的人。</p>
+<p>Where people are and how the camera moves — and who they are and what it looks like. A reference clip gives you both at once; you only wanted the first. ReShot keeps the staging and the camera and drops everything else: no faces, no wardrobe, no style. Give the depth map to your model with a prompt for the look, and you get the reference's blocking with your cast in it.</p>
+<p class="zh">走位和运镜,以及画面里的人和风格。参考片两样一起给你,你只想要前一样。ReShot 留下走位和镜头,去掉其余一切——没有脸、没有服装、没有画风。把深度图交给模型,再告诉它你要的样子,就得到参考片的走位、你的人。</p>
<h2>Works with the models you already use. <span class="zh">/ 你在用的模型都能接</span></h2>
<table>
@@ -80,8 +80,8 @@ reshot reference.mp4 -o blockout.mp4 --target seedance</code></pre>
<h2>About Maosika 猫斯卡 <span class="zh">/ 关于猫斯卡</span></h2>
<div class="about">
-<p>ReShot is open-sourced by <a href="https://www.maosika.com"><b>Maosika 猫斯卡</b></a> (<a href="https://www.maosika.com">www.maosika.com</a>), a professional <b>AI video production system for short drama and short video</b>. Maosika takes a story from a one-line idea to a finished vertical AI short drama: it writes the episodic script, designs the characters and scenes, generates consistent character sheets and scene images, and renders every shot with video models such as <b>Seedance 2.0 / 2.5</b> and <b>MiniMax H3</b> — a crew of digital specialists handling each step. Individual screenwriters, MCNs and short-drama companies use Maosika to produce AI short drama every day. ReShot is the depth-blockout step of that pipeline.</p>
-<p class="zh">ReShot 由 <a href="https://www.maosika.com"><b>猫斯卡</b></a>(www.maosika.com)开源。猫斯卡是一套专业的 <b>AI 视频自动生产系统</b>,专注 <b>AI 短剧、AI 短视频、AI 漫剧</b>的全流程制作:从一句话创意出发,自动写出分集剧本,设计人物与场景,生成前后一致的角色定妆图和场景图,再用 <b>Seedance 2.0 / 2.5</b>、<b>MiniMax H3</b> 等视频模型把每一镜拍出来——每个环节都由对应的数字专家接手。个人编剧、MCN 机构和短剧公司每天都在用猫斯卡生产 AI 短剧。ReShot 就是这条生产线里的「深度白模」环节。</p>
+<p>ReShot is open-sourced by <a href="https://www.maosika.com"><b>Maosika 猫斯卡</b></a> (<a href="https://www.maosika.com">www.maosika.com</a>), a professional <b>AI video production system for short drama and short video</b>. Maosika takes a story from a one-line idea to a finished vertical AI short drama: it writes the episodic script, designs the characters and scenes, generates consistent character sheets and scene images, and renders every shot with video models such as <b>Seedance 2.0 / 2.5</b> and <b>MiniMax H3</b> — a crew of digital specialists handling each step. Individual screenwriters, MCNs and short-drama companies use Maosika to produce AI short drama every day. ReShot is the depth-map step of that pipeline.</p>
+<p class="zh">ReShot 由 <a href="https://www.maosika.com"><b>猫斯卡</b></a>(www.maosika.com)开源。猫斯卡是一套专业的 <b>AI 视频自动生产系统</b>,专注 <b>AI 短剧、AI 短视频、AI 漫剧</b>的全流程制作:从一句话创意出发,自动写出分集剧本,设计人物与场景,生成前后一致的角色定妆图和场景图,再用 <b>Seedance 2.0 / 2.5</b>、<b>MiniMax H3</b> 等视频模型把每一镜拍出来——每个环节都由对应的数字专家接手。个人编剧、MCN 机构和短剧公司每天都在用猫斯卡生产 AI 短剧。ReShot 就是这条生产线里的「深度图」环节。</p>
<p><a class="btn" href="https://www.maosika.com">Make AI short drama at maosika.com · 去猫斯卡做 AI 短剧</a></p>
</div>
diff --git a/docs/USAGE.md b/docs/USAGE.md
index 3f7325c..00c6268 100644
--- a/docs/USAGE.md
+++ b/docs/USAGE.md
@@ -219,7 +219,7 @@ input video ─▶ probe ─▶ plan (sizes, frames, RAM) ─▶ decode at model
| very slow on Mac | torch < 2.9, or fp16 forced | `pip install -U torch`; never force fp16 on MPS |
| output is 30 fps although `--fps 24` | source fps < 24 | reshot never upsamples |
| output smaller than source | `--target` crop or `--max-res` | expected; see Targets |
-| banding in the blockout | `--crf` raised | keep ≤ 14 |
+| banding in the depth map | `--crf` raised | keep ≤ 14 |
| people look flat / merged with background | scene has little depth range | try `--clip 0.5 --gamma 1.3` |
## FAQ
diff --git a/docs/USAGE.zh-CN.md b/docs/USAGE.zh-CN.md
index 977f55e..d21f079 100644
--- a/docs/USAGE.zh-CN.md
+++ b/docs/USAGE.zh-CN.md
@@ -207,7 +207,7 @@ MPS 上 fp16 跑不完,所以强制 fp32。736×1280 约 0.5 秒/帧,12 秒
| Mac 上极慢 | torch < 2.9,或强开了 fp16 | `pip install -U torch`;MPS 上别开 fp16 |
| 给了 `--fps 24` 输出还是 30 | 原片 fps 低于 24 | reshot 不向上插帧 |
| 输出比原片小 | `--target` 裁剪或 `--max-res` | 正常,见目标预设 |
-| 白模有色带 | 调高了 `--crf` | 保持 ≤14 |
+| 深度图有色带 | 调高了 `--crf` | 保持 ≤14 |
| 人和背景糊在一起 | 场景纵深本身很小 | 试 `--clip 0.5 --gamma 1.3` |
## 常见问题
diff --git a/pyproject.toml b/pyproject.toml
index 225c374..8b1b57a 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -5,12 +5,12 @@ build-backend = "setuptools.build_meta"
[project]
name = "reshot"
dynamic = ["version"]
-description = "ReShot — copy the shot, not the actors. Video → depth blockout for Seedance 2.0/2.5 reference video, MiniMax H3 Fun ControlNet and Wan VACE. Open-sourced by Maosika 猫斯卡 (www.maosika.com), the AI short-drama production system."
+description = "ReShot — copy the shot, not the actors. Video → depth map for Seedance 2.0/2.5 reference video, MiniMax H3 Fun ControlNet and Wan VACE. Open-sourced by Maosika 猫斯卡 (www.maosika.com), the AI short-drama production system."
readme = "README.md"
license = { text = "Apache-2.0" }
requires-python = ">=3.10"
authors = [{ name = "Maosika 猫斯卡" }]
-keywords = ["video", "depth", "controlnet", "video-generation", "blockout", "depth-anything", "seedance", "minimax-h3", "ai-short-drama", "maosika"]
+keywords = ["video", "depth", "controlnet", "video-generation", "depth-map", "depth-anything", "seedance", "minimax-h3", "ai-short-drama", "maosika"]
classifiers = [
"License :: OSI Approved :: Apache Software License",
"Programming Language :: Python :: 3",
diff --git a/reshot/__init__.py b/reshot/__init__.py
index 1e4be64..f930d3d 100644
--- a/reshot/__init__.py
+++ b/reshot/__init__.py
@@ -1,4 +1,4 @@
-"""ReShot — turn any video into a depth "blockout" video for video-generation control.
+"""ReShot — turn any video into a depth-map video for video-generation control.
from pathlib import Path
from reshot import RunConfig, run
diff --git a/reshot/_version.py b/reshot/_version.py
index 493f741..260c070 100644
--- a/reshot/_version.py
+++ b/reshot/_version.py
@@ -1 +1 @@
-__version__ = "0.3.0"
+__version__ = "0.3.1"
diff --git a/reshot/cli.py b/reshot/cli.py
index 4d6bec7..6c7ea80 100644
--- a/reshot/cli.py
+++ b/reshot/cli.py
@@ -26,7 +26,7 @@ from .targets import TARGETS
def build_parser() -> argparse.ArgumentParser:
p = argparse.ArgumentParser(
prog="reshot",
- description="Video → depth blockout video for video-generation ControlNets.",
+ description="Video → depth-map video for video-generation ControlNets.",
epilog="Docs: https://github.com/maosika-ai/reshot",
)
p.add_argument("input", type=Path, help="input video (anything ffmpeg/OpenCV can read)")
diff --git a/reshot/targets.py b/reshot/targets.py
index bc9271a..6be59a9 100644
--- a/reshot/targets.py
+++ b/reshot/targets.py
@@ -27,7 +27,7 @@ TARGETS: dict[str, Target] = {
# Seedance 2.0 / 2.5 (Volcengine Ark "创建视频生成任务" API, reference_video role), from
# the official parameter page: mp4 H.264, fps 24–60, per-clip 2–15 s on 2.0 (2–30 s on
# 2.5), aspect 0.4–2.5, side 300–6000 px, total pixels ≥ 407,696, file ≤ 200 MB.
- # The blockout goes in as @视频N and the prompt asks for its motion and camera.
+ # The depth map goes in as @视频N and the prompt asks for its motion and camera.
"seedance": Target("seedance", 24.0, 16, 15.0,
"Seedance 2.0/2.5 reference video (@视频N: motion + camera)", min_pixels=407_696),
# MiniMax-H3-Fun-Controlnet-Union: 24 fps fixed, H/W multiples of 32, ≤15 s.