# 多租户视频生成 API 的隔离设计:密钥、任务与成片归档
把视频生成接入 SaaS 产品时,难点不只是发出请求:不同客户的 API 凭据、异步任务、结果文件和消费记录都必须正确隔离。下面是一份面向应用层的设计清单。示例描述的是你自己的多租户系统架构,不代表上游 API 提供租户隔离功能。
Contents
# 1. 分开管理应用身份与上游凭据
浏览器只携带你自己的登录态。由服务端验证用户、权限和额度,再由服务端使用供应商 API Key 请求上游。不要把 Bearer Key 放进网页代码、浏览器存储或客户端日志。供应商文档也要求仅在服务端保存密钥,并说明密钥可设置额度上限、过期时间和模型权限。
建议每次创建任务时生成一个内部 client_request_id,并在数据库写入:
| 字段 | 用途 |
|---|---|
| tenant_id | 当前客户/工作区 |
| client_request_id | 你自己的请求关联 ID |
| provider_task_id | 上游返回的任务 ID |
| model_id | 提交时使用的完整模型 ID |
| status | 本地与上游状态映射 |
| artifact_key | 结果在你自己存储中的对象键 |
| billing_unit / billed_amount | 型号计价单位与实际账单值 |
查询任务时始终同时校验 tenant_id 与 client_request_id。不要只凭用户传入的上游任务 ID 返回状态或文件,否则容易出现跨客户读取。
# 2. 用明确状态推进异步任务
无限扩散 V1 视频流程以 POST /v1/videos 创建任务,保存返回的任务 ID,再 GET /v1/videos/{id} 查询。文档列出的状态为 queued、in_progress、completed、failed,建议至少间隔 30 秒查询。页面刷新后应从自己的数据库恢复任务,避免重复创建。
本地可增加 submission_pending、download_pending 等应用状态,但不要把它们误写成上游状态。保存状态变化和时间戳,方便支持人员判断问题出在提交、生成还是下载阶段。
# 3. 将短时效结果转存到自己的对象存储
任务 completed 后,通过 GET /v1/videos/{id}/content 下载;该端点支持 Range,文档提示结果有时效。下载成功后再将文件存入你自己的对象存储,保存对象键、媒体类型、大小、校验哈希和关联任务。只在完成租户授权检查后签发短时效读取 URL,不把上游临时链接当成永久地址。
# 4. 记录可审计但不过度的消费信息
费用单位可能按条或按秒,型号能力和价格也会调整。记录提交时的完整 model_id、价格来源核验时间、上游任务 ID 与实际账单值;不要把所有型号都换算成一个假设单价。排错日志避免存储密钥和不必要的完整提示词,确需保留时先制定访问范围与保留周期。
# 上游服务说明
无限扩散是第三方 API 接入服务,不是 Seedance 上游官方服务。统一接口、认证方式、状态、下载方式和各型号能力以实时文档为准;规格、价格、可用性及实际费用以调用时的模型目录和账单为准。
- API 文档:https://api.wxksai.com/docs/
- 实时模型与价格目录:https://api.wxksai.com/pricing