Starter 应用
文生视频任务模式
通过组织 entitlement、配额、积分、幂等与退款扩展可选的文生视频演示。
已与启动模板提交
7d452a6同步。
文生视频页面是可选开发模式,不是生产 AI 供应商。仅在启用 demo 与 text-to-video mock 时可用,生产会忽略 demo 开关。接入真实服务时只替换 src/services/ai/video.ts provider adapter。
POST /api/tasks/text-to-video 要求同源、限流、认证、组织 tasks.text_to_video entitlement、共享月度任务上限和足够的组织积分。header 或 body 提供 Idempotency-Key。服务只创建一条组织任务,消费积分并记录根交易号,调用 provider 后标记成功;失败则标记任务并追加积分退款。
成本在 src/config/tasks.ts 按秒数与画幅配置。Plus 当前为组织每月 50 个任务/500 积分,Max 任务不限/2,500 积分,Free 不含此能力。通过 GET /api/tasks/[uuid] 获取任务,访问按组织限定。
真实长任务应保留这些不变量,但改为持久异步执行,使用 provider 幂等、验证 callback、保存外部 ID,并测试重复请求、余额不足、超时、callback replay 与退款失败。