开发环境实测 · 2026-09-08—09 · 资料 → 原型 → 设计 → 开发 → 测试

数字人开放 API 与数字车间讲解联调

三阶段实施完成：独立应用授权、真实资源库、服务端生成成片并绑定训练步骤。

联调 APPID：AP_238179E0A10F97927EA49FA3。密钥已配置在数字车间服务端加密存储，报告不包含密钥、令牌或账号口令。

3 / 3实施阶段完成

533后端自动化检查通过

18真实接口边界检查

2发布版本视频播放验证

实施结果

阶段	交付内容	结果
1. 数字人开放平台	开放应用管理；AP_ APPID；一次性密钥；重置/停用/令牌撤销；接口 Scope、形象/音色/背景/目录/视频授权；限频与并发；公开 API 文档和 OpenAPI 下载。	通过
2. 数字车间接入	数字人类型独立配置；Auth 加密保管 Secret；Tran 使用受保护的内部短期令牌接口；真实资源分页、视频预览、导入、步骤绑定、保存和刷新。	通过
3. 现场生成成片	服务端 TTS + 配对 Viewer + FFmpeg；数据库任务/租约/幂等；关闭刷新恢复、取消重试；生成背景与字幕；成片保存后导入；发布版本受控播放。	通过

公开文档：数字人开放 API 说明。应用管理：数字人系统 → 系统设置 → 开放应用。数字车间：系统管理 → 接口对接 → 数字人。

测试副本	过程	最终证据
狐狸 · 工程 410	资源库选择真实成片 → 播放 → 导入为 VIDEO → 绑定第一步 → 保存 → 刷新验证 → 发布 → 对抗训练预览播放。	发布版本 466，预览任务 52；640 × 360，4.52 秒。
牛奶卡车 · 工程 411	选择形象与音色、数字化教室背景 → 输入文稿 → 提交生成 → 关闭/刷新 → 恢复同一任务 → 成片预览 → 导入绑定 → 发布 → 实装实训预览播放。	发布版本 467，预览任务 53；1280 × 720，4.60 秒。

以下视频为本次接口下载的真实生成文件，可直接播放。数字车间保存了独立的受控文件副本；数字人平台临时视频清理后，固定发布版本仍能播放。

问题	修复与验证
并发资源查询占满小连接池	调用审计移到完整请求释放数据库连接后执行；三个目录并发真实请求 516 ms 完成，均为 200，补充顺序回归。
本地缓存缺失时无法读取远端文件	复用统一文件服务的受控取回及完整性校验；不再仅判断本地路径。真正缺失的背景文件给出明确失败原因。
教学资源不识别 fsvc://	在原固定版本、数据权限及考试白名单基础上支持统一文件服务地址，验证发布后实际播放及跨版本拒绝访问。
生成提交后关闭/刷新导致上下文丢失	保存工程、步骤、APPID、请求键与远程任务映射；重开恢复，提交结果不确定时用原幂等键确认，应用切换不能串用任务。
旧视频绑定与已删除步骤	切换来源清除旧活动绑定；生成前确认步骤存在与版本一致；数字人来源没有 READY VIDEO 时不能发布。
上传凭证篡改检查存在偶发失败	拒绝带非规范补位的 Base64 表示，保持原 HMAC、人员/工程/版本和文件摘要校验；已有失败用例回归通过。

两条历史背景记录（85、79）的源文件在当前环境无法取回，未修改原资料。本次为联调应用授权实际可用的“数字化教室”背景（11）。缺失素材需补传后使用，系统不会伪造成功结果。

截图来自真实 Edge 浏览器。点击可查看原图；中间过程图展示拍摄时状态，最终结果以下方发布播放截图及 JSON 为准。

Python：31 项通过；Auth：123 项通过；Tran：379 项通过。两个前端通过类型检查与生产构建，Java 包构建通过。
真实接口：未认证拒绝、应用/用户令牌隔离、跨应用生成视频拒绝、Range、公开契约、密钥轮换与旧令牌撤销、并发资源查询、删除步骤/旧版本/只读管理员拒绝、内部服务密钥保护及搜索边界。
任务幂等、并发、取消/重试、跨应用任务隔离和租约失效由自动化回归覆盖；真实浏览器覆盖实际生成、恢复、导入及发布后播放。
没有把本次视频播放测试扩写为完整实装识别或对抗计分验收。纯本地对抗演示尚无正式发布版本引用，本次不重构该业务域；正式任务宿主已补充讲解媒体入口。

开发库已执行数字人 033、数字车间 037/038，增量 DDL、完整 SQL、设计和接口文档同步。成片服务使用配置的共享数字人 Viewer、TTS、FFmpeg 与受控文件服务；运行浏览器及加密密钥文件需要随部署配置，不能只复制前端。

已清理数字人平台临时视频 51/52，并停用隔离测试应用；按平台原有删除契约，文件及任务审计历史保留。联调应用继续启用，APPID/密钥已配置，供继续使用。

数字车间保留测试副本 410/411、其独立导入视频及草稿教学任务 52/53。现有教学 API 没有草稿删除入口，保留清单供检查；未创建学员运行、成绩，未修改原有狐狸/卡车模型、场景或训练工程。两个草稿任务尚未面向学员发布。

本报告仅对应开发环境。修改尚未提交或推送 Git。