Dub2 · 内部下单台

JobSpec v1 统一入口 · POST /webhook/orders

Dub-Submit-0918-02

内部工具（不对外）。与「导演 AI」同一份契约——人工在此下单，本身就在持续压测契约。
对外用户端将来走「前端 → AI 下单层 → 流水线」，AI 层是唯一对外接缝；本页不做注册/缴费/账号。

⚙️ 接口配置

n8n 基址（不含 path） Authorization（可选，当前网关不校验）

① 下单

项目名 project.name 清晰度 source.quality

项目描述 project.description 源片链接 source.url

steps 含 download / separate / transcribe / translate / dub 时必填

步骤 steps

⚠️ 「精细化跳过」尚未实现：入口是 split 时实际仍会跑完整 Dub-2 链（响应里如实回 steps_effective）。

版本 editions （每批最多 10）

交付物 deliverables

video 默认。srt 需额外生成步骤，dialog_json 已随单产出。

回执 notify

邮件收件人 to（当前主力通道）

回调 URL（预留）回调密钥 secret（预留）

回调通道已建好（HMAC-SHA256 X-Signature + 5 次退避重试 + 投递日志），但 域名必须先加入白名单（Dub_Aliyun."0917-NOTIFY-CALLBACK-ALLOW"）；未加白名单会被跳过且不出网。phone 占位不实现。

显示高级生产参数（已预填线上默认值，可逐项改）

每个空里已填好线上真实默认值（2026-09-17 逐项核对自 Dub-2R-01-Prepare / Prepare Fields 的 P('KEY', 默认)）。 留空 = 不传 = 由工作流默认生效；改了才覆盖。

幂等键 idempotency_key （同键重复提交 = 返回原批次，不重复生产）

② 查批次 / 取成片

对应 GET /webhook/order-status?batch_id=…；清单可拉 GET /webhook/order-manifest?batch_id=…。

③ 契约速查

处理模式 full / single / reorder

契约里没有 mode 字段——网关按片段数自动判定：
· full = 不给 clips（整片）　· single = 恰好 1 段　· reorder = ≥2 段
所以本页的三选一驱动输入形态，并在提交前校验段数一致（避免"选了 single 却给 3 段"）。

时间码怎么写

顺序 = 成片播放顺序；时间基准 = 原片时间轴；单位秒。
可写 0:34-0:38 接 1:20-1:35、34~38、1:20->1:35、H:MM:SS。

clips / order

clips 按成片顺序写，order 恒填 [0,1,…,n-1]（最不易错）； order 必须是 0..n-1 的合法排列，否则 400 BAD_ORDER。

网关错误响应字段

{"ok":false,"error":"BAD_ORDER","message":"…"} —— 是 error/message。

上限

每批 ≤ 10 版本；每版 ≤ 50 片段。

④ 分段调试入口（老控制台，仅供单段排障）

下列旧页直接打各段老 webhook（Dub-0-Download / Dub-1-Split / Dub-2-Dub / Dub-3-Mix），不走批次与幂等：

· Dub-Submit-0917-02（本页前一版，时间码与 clips 会同时出现）

⚠️ 正常下单请用本页，否则不会产生批次号、拿不到回调与投递日志。

建立 2026-09-17（第 4 版 · 同步全片取样参数）· 契约 JobSpec v1 · 母计划 20260917-04