seedance-submitter

Seedance 提交器

适用场景

• 通过 PostPlus Cloud 准备、验证、提交、轮询或调试 Seedance 2.0/2.5 任务。

不适用场景

• 缺少必需输入，且猜测会改变结果。
• 任务类别、钩子逻辑、分镜脚本或参考素材策略尚未确定。 请先使用 video-generation 和 video-request-architect。

执行边界

• 此运行器负责验证、提交和轮询规范化的 Seedance 请求。不得做出创意策略、任务分类或参考素材策略方面的决策。
• 除非用户指定其他模型，否则将 sd2 解释为 Seedance 2.0 Mini（video-seedance-2-mini-*），这是当前默认档位。标准版/快速版仍可显式使用；需要参考视频/音频时应使用这两种版本。
• Seedance 2.5 有四种有意区分的场景端点。绝不能仅因为存在图像，就将一种场景转换为另一种：
  • video-seedance-2-5-text：仅提示词；不接受媒体输入。
  • video-seedance-2-5-first-frame：恰好一个 --first-frame；输出从该帧开始，因此这不是仅用于特征参考的素材。
  • video-seedance-2-5-first-last-frame：恰好一个 --first-frame 和一个 --last-frame；提供方契约将比例固定为 adaptive，将时长固定为 -1。
  • video-seedance-2-5-reference：一个或多个可重复使用的 --reference-image、--reference-video 或 --reference-audio；这些素材用于引导特征、风格和内容，不是开场帧或结束帧。
• 对于 2.0，标准版/快速版的 -text 端点接受图像/视频/音频参考素材；Mini 版的 -text 仅接受图像。每个 -image 端点都需要一个 --image 作为首帧，且不接受参考素材槽位。
• 已发布的端点键及其选项枚举（分辨率、宽高比、时长范围）通过 postplus media schema --json 查询；此处不会硬编码。
• 将 duration 设为端点公布的范围内（参见 schema）。对于落在可用值之间的剪辑目标，请选择最近的有效 duration，并设置 targetEditDurationSeconds。
• 当 targetEditDurationSeconds < duration 时，请包含 timeline.activePerformanceEndSeconds 和 timeline.tailStrategy。
• 如果目标脚本或节拍计划超出端点的最大时长，请拆分为可独立提交的片段。不要提交一个超长请求。
• 对于 2.5 的参考素材 edit 或 extend，请提供参考视频，并使用 schema 中的精确约束（aspect_ratio=adaptive、duration=-1）。CLI 和 Web 边界会在提交给提供方并计费前拒绝不受支持的组合。

来源与请求

• 锁定媒体、脚本、时长、输出根目录、来源依据，以及用户需要提交任务还是仅获取命令。
• promptPlan.*、timeline.* 和 targetEditDurationSeconds 属于创作词汇，不是 Seedance 请求字段。使用从 postplus media schema --json 获取的扁平提供方契约中的端点 CLI 标志提交（--prompt、旧版 2.0 的 --image、2.5 的 --first-frame / --last-frame、--duration、--resolution、--aspect-ratio、--generate-audio、--output-format、--omni-reference-task-type，以及可重复使用的 --reference-image / --reference-video / --reference-audio——仅限发布了这些槽位的端点支持参考标志）；CLI 会拒绝所选端点契约之外的任何标志。将故事线/音频计划以及任何 timeline.activePerformanceEndSeconds / timeline.tailStrategy 指令编入单条 --prompt 叙述中，然后将支持的渲染时长档位映射到 --duration；时间线创作字段没有单独的标志或请求字段，也无需编写请求 JSON 封装。
• 明确绑定参考素材：说明 [image 1]、[image 2]、[audio 1] 或 [video 1] 控制什么。最终请求中不要依赖 same as previous、content above 或未绑定的本地句柄。
• 使用 postplus media-file upload --skill seedance-submitter --input-file <file> --mime <mime> --output <upload.json> 将本地参考媒体上传到托管存储，然后将 output.mediaReference——一种永不过期的持久 postplus-media:// 引用——传入 Seedance 媒体标志（例如 --reference-image <output.mediaReference>）。托管边界会在发送到提供方时将其换成新的签名 URL，因此上传一次后，可以在后续提交中重复使用同一引用。output.data.download_url 是会过期的签名 URL；优先使用 output.mediaReference。
• 不要声称通过 PostPlus 托管存储上传后会自动获得 Moyu 真人豁免。仅当企业版 Seedance 2.0 的 first_frame 路径具备真实的端到端证据时，才会启用 Moyu 资产库自动升级。在一次有记录的运行中，reference_image 在改写为 asset:// 后仍因隐私限制而被拦截；目前也未批准任何付费 Seedance 2.5 豁免冒烟测试；这两条路径都会触发提供方的类型化策略边界。

审核与交接

• 提交前，请确认验证已通过、每个片段都能独立成立、参考素材已绑定、必需媒体均已就绪、来源依据明确且输出路径持久可靠。
• Seedance 2.5 的支持情况已通过官方/实时提供方材料以及本地提交/轮询/结果/计费模拟验证。在获批的付费冒烟测试检查 MP4、实际时长、分辨率、音轨和结算之前，不要将这些输出属性标记为已通过产物验证。
• 如果渲染仍在等待中，请返回片段 ID、清单路径、output.data.id 生成句柄、轮询命令 postplus media poll --handle <output.data.id>，以及预期的本地 renders/ 输出路径。轮询命令会在命令内部等待（每 8s 重新检查一次，每次最多 45s；--wait-seconds 0 = 单次检查）：只要渲染仍在等待，就重复运行同一命令，不要重新提交，也不要编写更紧密的重试循环。
• 使用 postplus media-file download --url <fresh-output-url> --output-file <renders/...> 将已完成的渲染保存到磁盘（对于存放在托管存储中的媒体，使用 --reference <postplus-media://...>）；提供方输出 URL 是临时的，因此请在 URL 仍有效时下载。

停止条件

• 如果缺少用户必需意图、来源证据或其拥有的输入产物，且猜测会改变结果，则停止。
• 如果所属 CLI 或脚本命令失败，请报告确切错误并停止。不要通过仅提供元数据的回答、就绪状态探测、本地载荷改写、备用提供方或未发布工具来绕过失败。

公共命令边界

• 根据用户输入选择最精简的匹配命令或工作流，并直接运行。
• 就绪状态诊断：postplus doctor --skill seedance-submitter。
• 轮询待处理的渲染任务：postplus media poll --handle <output.data.id>（每次调用最多在命令内等待 45s；如果仍在处理中，请重新运行）。
• 仅在构造或修复未知请求格式时使用 postplus media schema --json。
• 使用下方生成的命令运行托管提交；不要直接调用提供商 API。

postplus media create video-seedance-2-fast-image \
  --prompt <prompt> \
  --image <image> \
  --output <result.json>

• 如果 CLI 返回报价确认质询，请运行 postplus quote confirm --json --challenge-file <challenge.json>，并使用返回的令牌重试。