# AI 换装 API 接入指南

> 推荐使用“用户前端 + 自有业务后端 + 模型服务”的三层结构。长期 API 密钥只保存在服务端；用户登录并通过额度检查后，由服务端签发短期、受限的会话令牌。

## 推荐架构

1. 用户登录：通过邮箱、手机号或合规的第三方登录建立身份。
2. 检查额度：业务后端确认套餐、剩余时长、并发限制和风控状态。
3. 签发短期令牌：服务端向模型服务申请受限令牌，不向前端返回长期密钥。
4. 建立会话：前端在用户主动授权后打开摄像头，使用短期令牌连接模型服务。
5. 记录用量：后端保存会话时长、状态、错误和费用，用于额度与成本控制。

## 为什么不能把长期密钥放在前端

网页源码、浏览器网络请求和 App 安装包都可能被查看。长期密钥一旦泄露，第三方可能消耗额度或产生费用。短期令牌应限制允许的模型、来源域名、有效期和最长会话时长。

## 安全与隐私

- 长期密钥放在服务端环境变量或密钥管理系统。
- 按用户、设备和 IP 控制请求频率与并发。
- 只在用户主动操作后申请摄像头权限。
- 明确说明视频用途、第三方处理和数据保留规则。
- 非必要不保存原始人物视频。
- 为断线、超时、权限拒绝和额度耗尽提供明确提示。

## 上线验收

检查密钥是否泄露、短期令牌范围、未登录访问、额度控制、摄像头权限、弱网恢复、错误重试、日志与每日成本上限。

## 参考资料

- [Decart Client Tokens](https://docs.platform.decart.ai/getting-started/client-tokens)
- [Decart Create Client Token API](https://docs.platform.decart.ai/api-reference/create-client-token)
- [Decart E-commerce Try-on Example](https://docs.platform.decart.ai/examples/ecommerce-try-on)

## 相关内容

- [AI 实时换装解决方案](https://sbkjkj.com/ai-real-time-try-on/)
- [AI 虚拟试衣项目指南](https://sbkjkj.com/ai-virtual-try-on/)
- [实时 AI 世界模型](https://sbkjkj.com/world-model/)

## 联系方式

访问 [灰伞 AI 官网](https://sbkjkj.com/#contact) 提交你的产品类型、用户规模、目标终端和服装素材情况。