登录与实时体验
请求摄像头权限、选择服装、建立会话并展示结果。
AI TRY-ON API
AI 换装 API，
安全接入你的产品。
把实时虚拟试衣接入网站、App、直播工具或线下终端。用服务端保护长期密钥，用短期令牌控制会话，并把用户、额度、日志和隐私流程留在自己的业务系统中。
实时换装 API 应用示意
01 / 直接答案
AI 换装 API 怎么接？
推荐使用“用户前端 + 自有业务后端 + 模型服务”的三层结构。前端负责登录、摄像头和交互；自有后端负责权限、额度和短期令牌；模型服务负责实时生成。长期 API 密钥只保存在服务端。
权限与额度
验证用户、控制频率与用量、签发短期令牌并记录消费。
实时生成
接收授权会话中的视频与素材，连续返回换装画面。
02 / 接入架构
从登录到开始试穿。
一次完整会话应有清晰的权限边界和失败处理。前端不负责保存密钥，模型服务也不负责你的用户套餐和订单逻辑。
用户登录
通过邮箱、手机号或合规的第三方登录建立用户身份。
检查额度
后端确认套餐、剩余时长、并发限制和风控状态。
签发短期令牌
服务端向模型服务申请受限令牌，绝不返回长期密钥。
建立实时会话
前端在用户授权后打开摄像头，连接模型并记录实际用量。
03 / 安全与隐私
四个不能省的控制点。
实时视频会带来账号滥用、费用失控和摄像头隐私风险。安全设计必须和体验一起完成，而不是上线前再补。
密钥只在服务端
长期密钥放入环境变量或密钥管理系统，不进入网页源码、日志和客户端包。
额度与并发限制
按用户、设备和 IP 控制每日体验时长、同时会话数和异常重试。
明确摄像头授权
只在用户主动点击后请求权限，说明用途、处理方、保存方式和停止路径。
可追踪但少留数据
记录令牌、时长、状态和错误即可；非必要不保存原始人物视频。
04 / 上线验收
先跑通小范围，再开放流量。
上线前同时验证体验和成本。建议设置单用户、单日和全站三层预算阈值，并对失败和超时建立自动恢复路径。
验收清单
上线前至少验证
- 长期 API 密钥没有出现在前端、日志或代码仓库
- 短期令牌限制模型、来源、有效期和会话时长
- 未登录、额度耗尽和异常请求会被服务端拒绝
- 摄像头权限、隐私说明和停止会话入口清晰
- 弱网、断线、超时和模型错误后可以恢复
- 后台能查看用户用量、失败率和每日成本
参考资料
模型服务接入文档
- Decart Client Tokens：浏览器端实时应用使用短期、受限令牌的官方说明。
- Decart Create Client Token API：服务端创建会话令牌的接口参考。
- Decart E-commerce Try-on Example：电商实时换装的官方接入示例。
05 / 常见问题
关于 AI 换装 API
AI 换装 API 可以直接放在网页前端吗？
长期 API 密钥不应写入网页、App 安装包或公开代码。推荐由自有服务端保存长期密钥，并为通过登录和额度检查的用户签发短期、受限的会话令牌。
用户登录后能自动获得 AI 换装体验吗？
可以。用户登录后，业务服务端检查套餐、剩余额度和风控状态，再向模型服务申请短期令牌并返回前端。令牌过期后重新申请，消费记录由业务服务端保存。
实时换装接入需要哪些模块？
通常包括用户登录、服务端令牌接口、额度与并发控制、前端摄像头和实时会话、服装素材管理、使用记录、错误恢复和隐私提示。
如何保护摄像头和用户隐私？
只在用户主动操作后申请摄像头权限，明确说明用途和第三方处理情况，采用 HTTPS，尽量缩短数据保留时间，并提供权限拒绝、停止会话和删除相关数据的路径。
是否需要为每个用户创建永久 API 密钥？
通常不需要。更安全的方式是用一个受保护的服务端账户管理模型服务，再为每次用户会话签发短期、范围受限的令牌。