lucid.page 多租户视频生成 API 的隔离设计:密钥、任务与成片归档
Text size
Read time1 min

# 多租户视频生成 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 上游官方服务。统一接口、认证方式、状态、下载方式和各型号能力以实时文档为准;规格、价格、可用性及实际费用以调用时的模型目录和账单为准。

End