sytiris / bling-tryon

**简体中文** | English
# 试衣镜bling
**试衣镜bling是可以直接接自己API的开源虚拟视频试穿工具，让用户可以从源头掌握模型账户和API费用。**
1）使用自己的Decart API Key，在Chrome购物网页里实时试衣。
2）Decart目前向新注册账户提供免费API试用积分1000点，无需充值**即可享受试穿体验**；模型用尽后，费用是否充值用户自行决定，后续API使用按平台规则。额外的充值费用参考Decart官方说明。
3）用户可以本项目上，围绕虚拟试穿继续开发个性化的选衣、穿搭或购物功能。
实际使用参考：左侧为服装页面，右侧为插件试穿效果，试穿者面部已遮挡。
永久密钥保存在用户自己电脑的本地助手中；插件只接收短期令牌。没有作者托管的密钥服务，试衣镜不另设账号或订阅，两家平台之间不会自动切换。试穿费用由用户所选平台的账户承担。
> 当前为可试用版本，提供 macOS/ARM64（Apple Silicon）、macOS/X64（Intel）、Windows/X64、Linux/X64 自动构建包；本机实测平台为 macOS Apple Silicon。Intel Mac、Windows/Linux 的摄像头与购物网站兼容性仍需对应设备验证，其他架构可从源码构建。系统签名/公证安装器尚未提供。
## 语言
插件和本地助手默认跟随浏览器语言：中文浏览器显示中文，其他语言显示英文。浮窗标题栏的 EN / 中、插件设置页和助手页的语言按钮可随时切换，并各自记住选择。切换只更新文字，不会重开相机或试穿。Chrome 扩展列表名称跟随 Chrome 自身语言：中文为「试衣镜bling」，英文为「Bling Try-On」。
## 安装
优先使用本仓库 **Releases** 中与你系统和芯片匹配的完整安装包，内含本地助手、Node运行时及Chrome扩展。
Mac 安装包按芯片选择，两种都要求 **macOS 13.5 或以上**（对应内置 Node 24 运行时要求）：
| 电脑 | Release 文件 |
| --- | --- |
| M 系列芯片 / `arm64` | `bling-tryon-macOS-ARM64.tar.gz` |
| Intel 芯片 / `x86_64` | `bling-tryon-macOS-X64.tar.gz` |
Intel Mac 不要安装 ARM64 包。安装时读取 GitHub 实际最新 Release，不要只按旧版本缓存判断；没有匹配包时，已授权的本机安装可以使用下方源码构建流程，并先确认运行时兼容。项目规则不要求仅因改用源码而重复征求同意。
1. 解压整个安装包到固定位置，运行 start-macos.command（macOS）、start-windows.cmd（Windows）或 start-linux.sh（Linux），也可使用保留的中文名称启动器，保持终端开启。
2. 启动器会打开 `http://127.0.0.1:3000/setup`；尚未配置 Key 时，还会自动打开 Decart API Keys 页面。先按下方说明注册/登录、创建 Key，再回到本机页面点击「验证并保存」。验证只申请短期令牌，不启动摄像头或生成视频。
3. Chrome 打开 `chrome://extensions`，开启「开发者模式」，点击「加载未打包的扩展程序」，选择包内 `chrome-tryon` 文件夹。
4. 打开 HTTPS 购物页，点击插件图标。移到衣服图片上点「试试这件」，允许摄像头后主动点 **10 秒 / 20 秒**。
浮窗标题栏可拖动；放大按钮可全屏查看（不支持全屏时在网页内放大），可还原或按 Esc 退出；「−」收起成可拖动小标签；「⚙」打开助手设置。插件不会因网页获得焦点而自动关闭。
详细说明：安装、费用与已知限制 · 隐私与数据流
## 注册 Decart、获取试用积分和设置 API Key
1. 打开 Decart API 控制台，自行完成注册/登录和页面要求的验证。
2. 在控制台查看账户余额或试用额度。官方价格说明目前写明新账户有免费试用额度；具体金额、有效期和使用条件以你的控制台为准。本项目不发放积分，也不会自动充值。Decart API 按使用量计费，无需购买订阅会员。
3. 进入 API Keys，使用页面的创建按钮生成一个 Key，并复制。可参考 官方 API Key 指南。
4. 回到本机助手 `http://127.0.0.1:3000/setup`，将 Key 粘贴到密码输入框，点击「验证并保存」。看到验证通过后，再加载 Chrome 扩展。
5. 打开购物网页，自己允许摄像头并点击 10 秒或 20 秒开始试穿。Key 验证通过不代表余额一定充足；额度不足时回 Decart 控制台查看或自行决定是否充值。
## 可选接入 Vidu S2-Editing（实验性）
**v1.3.0 新增 Vidu S2-Editing**，使用用户自己的 API 账户，默认仍为 Decart。请下载 v1.3.0 或以上完整包，同时升级助手和扩展；旧包没有 Vidu 选项。目前已通过模拟 HTTP/WebSocket 和浏览器生命周期测试；**由于没有已充值的测试账户，尚未验证真实 Vidu 生成效果**。
1. 打开本机助手 `http://127.0.0.1:3000/setup`，选择「Vidu S2-Editing（实验性）」，再选择与密钥所属账户一致的「中国站」（`api.vidu.cn`）或「全球站」（`api.vidu.com`）。
2. 在对应的中国站控制台或全球站控制台创建 API Key，粘贴到本机助手密码框，点击「验证并保存」。不要在 Decart 模式下填写 Vidu Key。
3. 验证仅查询账户额度 `GET /ent/v2/credits`，有效的零余额账户也能保存。此操作不创建生成会话，也不保证额度足够试穿。
4. 回到试衣镜选衣，主动点击「10 秒 / 20 秒」。Vidu 使用 `virtual_tryon` 换装模式，沿用中心裁剪、放大和本地回放/下载。切换平台或地区会停止当前试穿；出错后不自动重试，也不自动换用另一家付费平台。
初次体验仍优先推荐官方提供新账户试用额度的 Decart。截至 2026-10-16，尚未从 Vidu 公开文档确认注册即赠且适用于 S2-Editing API 的默认免费额度；已有 Vidu API 积分的用户可自行使用，其他用户请在对应地区控制台核对余额、API 价格、活动和购买方式，按需自行充值。网页端赠额不一定适用于 API。
Vidu 永久密钥单独存入本机 `vidu.env`，平台/地区偏好保存在 `providers.json`。插件仅接收短期 RTC 凭证和本地会话控制凭证；永久密钥及上游控制密钥留在助手。停止时助手主动发送挂断，并设置 5 秒客户端心跳保护、30 秒首帧限制和 45/55 秒总时限。界面从首帧开始计时，等待期间的生成也可能计费；冷启动较慢时可能触发保护超时。这些是本地保护，助手崩