Velox TriFit: Virtual Try-On API

Velox 开发者中心 — DressMe 与 TriFit

将虚拟试穿功能集成到你的网站、应用或零售平台中。DressMe 可将购物者的照片和服装图片转换为 AI 穿搭预览。TriFit 是 Velox 面向消费者的体验。

此仓库是 Velox SDK 源码、可运行集成、教程和 AI Agent 集成技能的公开入口。先体验演示，再查看其背后的确切 SDK 实现。

从这里开始

想要……	前往
无需账号即可体验	托管演示 — 免费共享，队列有限
使用自己保存的照片、商品和历史记录进行体验	TriFit 应用 — 登录或创建账号，并使用可用的每日／每周／每月免费额度
查看演示请求并下载 SDK ZIP	演示控制面板与 SDK
无需凭据，立即在电脑上探索	下载此仓库；使用 Node.js 22+ 运行 npm run preview
构建实际集成	入门指南 · 申请访问权限
使用现有 TriFit 账号通过代码运行真实的 DressMe，无需合作伙伴密钥	示例 2：账号登录
了解应使用哪种访问方式	DressMe 全部选项
阅读 API 流程	技术说明
选择 SDK	SDK 目录
使用 Codex 或 GitHub Copilot 构建 Web／移动端集成	MCP 设置与移动端入门提示词 · 可移植集成技能
安装已发布的 OpenAI 开发者插件	Velox TriFit Developer — 只读 API 指南
连接当前 MCP 服务	Velox TriFit MCP — 协议端点；客户端设置与工具限制
在官方注册表中查找当前 MCP 服务	Velox TriFit 注册表条目 · 发布记录
查找公开 API 概览	Velox TriFit 合作伙伴 API

这是两个公开页面，并非 Velox 运营者管理后台。 控制面板仅显示访客本人浏览器会话中的请求和公开 SDK 下载内容。它不会公开密钥、路由、配额编辑功能、其他访客的照片或流量测试控制项。托管界面的更新遵循 Studio 从开发到生产的发布门槛；公开主机运行的版本可能早于你查看的源代码所对应的已接受版本。

查看真实的公开试穿示例

现有的官方 TriFit 示例：AI 个人肖像、服装参考图及其实际 TriFit 输出。这些是历史示例，不是模拟图、最新运行的测试或性能／质量对比。来源信息和媒体说明。

示例	个人照片	服装参考图	TriFit 结果
Amara · 运动服
Mateo · 衬衫式外套

你可以使用可用的账户额度，在 TriFit 应用中试用自己的照片；也可以使用共享演示，无需账户。线上主机通过独立发布版本接收 UI 更新。

拼搭服装的入门产品

演示源代码包含提供商对比测试中使用的同样五张服装拼图，未经图像编辑直接复制。选择整张拼图作为产品参考图，并另选一张个人照片。拼图中的参考模特不是目标人物。配饰迁移和服装还原度可能有所不同。

绿色风衣 · 细节	绿色风衣 · 全身造型	酒红色风衣和半身裙

海军蓝西装外套和菱格纹半身裙	皮夹克和牛仔服

这些是产品输入，不是生成的结果图片，也不能证明提供商排名。它们与上方 Amara/Mateo 的配对示例相互独立。拼图中的品牌名称不代表认可。

安装 Codex 插件

Velox TriFit Developer OpenAI 列表已发布（2026 年 10 月 24 日核验，版本 1.1.2）。你也可以在 Codex 或 Copilot中直接连接公开文档 MCP，无需安装完整插件。这两种方式都不会授予实时 Partner API 访问权限。官方 MCP Registry 列表 io.github.Velox-XR/velox-trifit-developer，版本 2.0.0，已于2026 年 10 月 24 日独立核实为活跃且为最新版本。它指向当前连接地址：https://studio.v3lox.com/partner/trifit/mcp。这取代了同一标识符下最初发布的 1.1.0 旧端点，并非第二个列表。GitHub 精选注册表的入驻申请尚待处理；列表申请已提交，但尚未获批。请参阅发布记录和更新清单。在注册表中发布并不保证搜索排名或 Agent 自动推荐。

参阅安装说明和测试提示词。GitHub Marketplace 软件包与通用目录审核和批准相互独立。

Velox TriFit——API 指南与试穿功能集于一体的插件

Velox TriFit ChatGPT/Codex 插件将 API 指南与经用户同意的账户或访客试穿功能整合在一个软件包中。面向 Production 的 v1.2.1 源码 和可复现的 ZIP 构建器均可供检查。当前 Production 端点包含 18 个工具，且 4 个匿名文档调用已于 2026 年 10 月 24 日验证；该检查不能证明已通过身份验证的试穿功能／客户端验收，也不能证明已获准加入公共目录。此代码库仅分发 Production 软件包，不包含私有 Development 软件包和连接说明。现有开发者软件包及其 OpenAI 审核保持不变。

候选版本还支持在聊天中通过电子邮件申请：确认已连接的发件人邮箱，可选填写项目详情，然后审核并批准发送给 [email protected] 的邮件。不自动发放密钥。此邮箱工作流仍需通过已获批准的端到端发送／收件验收测试。

一个演示，一种可检查的 SDK 集成

托管应用是此代码库的浏览器 UI、演示后端和共享队列，使用 JavaScript SDK。它不是单独的合作伙伴专用应用，也不是伪装成真实生成的模拟程序。

• 专用托管合作伙伴身份：demo。
• 真实的 DressMe 请求；公共演示未启用 AnimateMe。
• 使用签名、持久化的 Webhook 完成通知；若缺少回调，则延迟进行仅 GET 的恢复。UI 会标明实际的完成来源。
• 总耗时、上传、演示队列，以及从提交到观察到完成的耗时。这些并非仅 GPU 耗时。
• 可将单个造型，或你最近完成的全部 25 个请求下载为资产 ZIP，其中包含上传的输入文件、结果，以及耗时／校验和清单。此 ZIP 与 SDK 源码 ZIP 分开。
• 同一时间仅允许一个生成任务，且两次启动间隔至少 10 秒。
• 个人照片和商品上传会并行进行，并为两项资产提供持久化收据。 这样可以免去顺序上传的等待，同时不改变生成质量，也不绕过队列和使用限制。
• 控制面板 ZIP 包含相同的公共源码、SDK、示例和指南。
• 访问 Velox 托管的演示无需 API 密钥。
• 若要运行自己的商业合作伙伴后端，请申请自己的合作伙伴配置。
• 若要改用自己的 TriFit 账户编写代码，请使用 示例 2，无需合作伙伴密钥。

已纳入代码库的配置模板标明了 demo 集成和 Production API URL，但其中的密钥无效，且已禁用真实生成功能。它不是公共 API 凭据。 托管服务会在 Velox 服务器上私密加载真实密钥。密钥不会出现在 GitHub、发送到浏览器的 JavaScript 或公开的 ZIP 下载文件中。

本地运行

安装 Node.js 22 或更高版本。无需安装依赖项：

npm run preview

打开输出的网址。演示和控制面板可在本地运行；预览版无法上传或生成。控制面板的 ZIP 下载功能在预览版中也可使用。

浏览参考工作区

公共工作区采用更完整的合作伙伴演示布局，侧边栏提供指向公开代码、SDK ZIP、演练指南和访问申请的链接。

• 最多添加 8 张购物者照片和 8 张产品图片到本地托盘。 源代码还包含对比测试中的 5 张入门穿搭拼图。 点击其中一张即可将其添加到产品托盘，无需上传。 选择一对图片并检查后，再发送请求。添加、选择或移除预览都不会上传或生成内容。
• JPEG、PNG 和 WebP 照片会在浏览器本地处理：自动调整大小，使最长边不超过 2048 像素（绝不放大），同时保留宽高比和浏览器解码后的方向。原始文件不会受到影响；提交的只有处理后的副本。选择或处理图片时不会上传。输出大小不超过 API 的 5 MiB 上限。 出于浏览器安全考虑，超过 32 MiB 或 1 亿像素的源文件会被拒绝，并显示醒目的错误提示。不受支持或已损坏的文件也会显示清晰的错误提示。
• 只有在明确同意后提交，才会发送选中的图片对。每个新请求都会上传这对图片；托盘不是持久化的资源 ID 目录，也不是共享的合作伙伴图片库。
• 查看请求阶段、原始输入、已完成的结果，以及购物者与结果的并排对比。本地输入仅保存在已打开页面的内存中；重新加载后，可以读取请求历史和现有结果，但无法读取旧输入。
• 历史记录仅显示此浏览器会话的最新 25 个请求。刷新历史记录或查询状态不确定的请求均为只读操作，不会重放任务。

此公共 UI 不提供生产/开发环境选择器、共享图片库、路由、Webhook 注册或负载测试控件。私有合作伙伴工作台保持不变。

如需使用真实的Partner API：

1. 在更新后的插件中通过已连接的邮箱申请， 或使用网站表单。 在聊天中提供项目、预期用量和上线时间等详细信息均为可选项。
2. Velox 会审核申请、创建唯一的合作伙伴集成，并通过邮件发送私有的、特定于环境的配置。
3. 将提供的 partner.config.json 保存到 package.json 所在目录。
4. 运行 npm start。启动时会验证分配的 API 身份和环境。

如需优先通过 Webhook 完成流程，请联系 Velox，申请在您自己的后端密钥上授予 webhooks:write 权限，然后注册您的公开 HTTPS 接收端：

node setup-webhook.mjs https://YOUR_HTTPS_HOST/webhooks/dressme
npm start

设置命令会将端点 ID 和签名密钥私密地保存到 partner.config.json 中。托管环境的挂载前缀必须包含在回调 URL 中。有关确切的源站/代理约定，请参阅托管指南。未配置 Webhook 时，本地示例会明确采用轮询模式，不会声称提供 Webhook 投递。独立模拟服务仍是一个不收费的 API 流程测试夹具。

免费 TriFit 账户不是合作伙伴凭证，但可以使用其自身可用额度，为独立的个人账户示例授权。使用真实的 Partner API 可能产生费用，包括在 Development 环境中。切勿提交私有配置，也不要在其他部署中重复使用 Velox 托管的演示密钥。

可用的 SDK

JavaScript（Node.js）+ TypeScript 声明现已提供，采用 MIT 许可证： SDK 源码 · SDK 参考文档。

可运行的演示是此 SDK 的完整集成示例。此目录中可继续添加其他语言的程序包、框架示例和 Agent 指南；目录仅列出现有的实现。其他语言可以使用文档中介绍的 HTTP API，但在相应 SDK 发布并经过测试之前，不会将其宣传为可下载的 SDK。

队列、隐私与安全恢复

10 秒的间隔是最短启动间隔，不是预计时间或性能保证。 作业耗时越长，占用活动槽位的时间就越久，直到作业完成。每位访客最多有一个待处理请求，且待处理队列最多容纳 25 个请求，以此限制临时准入；示例中没有终身请求上限。**Velox API 配额和商业许可仍然适用。**新创建的托管合作伙伴目前使用默认的每月 100 次额度；此代码库不会暗中提高该额度。

浏览器会话是私有的，经过签名并使用 HttpOnly；通过 HTTPS 连接时，Cookie 会设置 Secure 属性。 仪表板仅限当前会话访问；清除 Cookie 会失去对该会话历史记录的访问权限。Cookie 过期时间为 48 小时，并不意味着媒体会自动删除。图像同意、隐私政策和约定的保留期限仍然适用。

本地评估器会将回执存储在被忽略的 .demo-state/ 中，并且仅允许一个独占所有者。它会保存输入 ID、幂等键和作业 ID，而不会保存图像字节、API 密钥或签名 URL。提交状态不确定时，队列会暂停，绝不会自动重放。发生崩溃后，保留日志和锁，以便操作人员进行协调。请勿使用共享演示凭据运行多个副本。

参阅托管与发布要求和安全。 仅靠队列速率限制既不能控制财务预算，也不能全面防御机器人。

不调用付费 API 进行测试

npm test
npm run demo:mock
npm run demo:failure

测试和显式模拟模式仅使用本地 fixture。它们不会读取私有配置，也不会调用 Velox。模拟结果并非真实 AI 结果，也不能证明延迟表现。

许可证

此代码库中的公开 SDK、示例、文档和 Agent 技能采用 MIT 许可证。这并不授予使用 Velox 托管 API 服务、私有产品代码、商标或客户资料的许可。API 访问和使用仍须遵守另行约定的条款。AI 预览不能保证合身度、尺码、颜色或服装细节。