配音与批处理任务
支持 VoiceStudio 定时多说话者配音的原生 API。
配音是一条任务流水线,而不是单个请求。转录、翻译、声音分配、时间安排、生成、质量检查和导出是独立阶段,客户端可以检查或重试其中任何阶段。
流程
- 使用
POST /dub/upload上传视频或音频。 - 跟踪
/tasks/stream/{task_id},直到准备就绪。 - 使用
/dub/transcribe-stream/{job_id}或同步的/dub/transcribe/{job_id}进行转录。 - 翻译并编辑片段。
- 分配配置,然后调用
POST /dub/generate/{job_id}。 - 检查质检、预览、分轨和字幕,或下载结果。
上传会返回媒体的 job_id 和准备进度的 task_id。请保留两者:它们跟踪不同内容。
保留的内容
- 片段开始和结束时间
- 多个说话者,各自使用自己的声音
- 导入或生成的 SRT 和 VTT 字幕
- 纯音频和视频任务
- 预览、质检、分轨和最终导出
对于视频文件夹,请使用 /batch/enqueue 和 /batch/jobs,并通过每个任务的状态、取消和下载路由操作。
本地工作流程
这些路由属于桌面 API。尚未发布的 Cloud 契约将源媒体暂存为 Artifact 并运行带版本的异步阶段,不承诺使用这些路径或请求体。
每个阶段都有自己的请求体。构建客户端时,请以 API 参考为准。