| --- |
| title: Z-Image + Watermark Remover V5 |
| emoji: 🎨 |
| colorFrom: yellow |
| colorTo: purple |
| sdk: gradio |
| sdk_version: 5.23.1 |
| python_version: "3.10" |
| app_file: app.py |
| startup_duration_timeout: 30m |
| --- |
| |
| # Z-Image + Watermark Remover V5.1 |
|
|
| ZeroGPU Gradio Space combining Z-Image-Turbo, Florence-2 watermark detection and LaMa image/video watermark removal. |
|
|
| ## V5 fixes |
|
|
| - Removes the invalid `@spaces.GPU(duration=300/450)` video request. |
| - Uses a maximum 120-second ZeroGPU request for video, matching the documented custom-duration example/cap used by ZeroGPU tiers. |
| - Adds a preflight video duration check and rejects videos that are too long for a single ZeroGPU request instead of submitting a request that will certainly fail. |
| - Default maximum input video length: 45 seconds. Set `WATERMARK_MAX_VIDEO_SECONDS` in Space Variables if you want a different limit; keep it realistic for the 120-second GPU request. |
| - Optimizes LaMa video processing by inpainting only the watermark bounding regions instead of the entire frame. |
| - Keeps the original audio stream with FFmpeg. |
| - Keeps V3/V4 Florence-2 compatibility patch and writable-cache fallback. |
| - Keeps Gradio API endpoints: `generate_image`, `watermark_preview`, `remove_image`, `remove_video`. |
|
|
| ## Important ZeroGPU behavior |
|
|
| A single `@spaces.GPU` invocation is one GPU reservation. Splitting a video into files inside that same function does **not** release the GPU between chunks. Therefore V5 does not falsely claim to provide multiple independent GPU reservations for one click. Instead it uses a bounded single-request video mode and fails early with a clear message when the input is too long. |
|
|
| For longer videos, use the API/UI to process shorter clips separately and concatenate them locally, or move the workload to a dedicated GPU Space. |
|
|
| ## Deployment |
|
|
| Upload the files to the root of a Gradio ZeroGPU Space. Gradio is managed by the Space `sdk_version`; do not pin Gradio in `requirements.txt`. |
|
|
| Set `HF_TOKEN` as a Space Secret for authenticated Hub downloads if desired. |
|
|
| ## V5.1 dependency fix |
|
|
| Florence-2 dynamically imports `einops` and `timm`. V5.1 adds both packages to `requirements.txt`. |
|
|
