SuperAPI AI 工具集

seedance-submitter

智能体与模型

查看项目

更新于 10-15 15:32

技能介绍

Seedance Submitter 是一个针对 Seedance 2.0/2.5 视频生成作业的执行型技能,运行在 PostPlus Cloud 之上,主要职责是校验、提交和轮询规范化的 Seedance 请求。它不负责创意策略、任务分类或参考策略判断;当必需输入缺失且猜测会改变结果,或任务类别、钩子逻辑、分镜、参考策略尚未解决时,应停止并先使用 video-generation 与 video-request-architect。

在模型与端点方面,除非用户指定其他模型,sd2 默认指 Seedance 2.0 Mini(video-seedance-2-mini-*)。Standard/fast 仍可显式使用,当需要参考视频或音频时使用它们。Seedance 2.5 有四个刻意分开的场景端点:video-seedance-2-5-text 仅接受 prompt,不接受媒体输入;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,standard/fast 的 -text 端点接受图像、视频、音频参考,mini -text 仅接受图像;每个 -image 端点接受一个 --image 首帧,没有参考槽位。

已发布的端点键及其选项枚举(分辨率、宽高比、时长边界)需通过 postplus media schema --json 发现,不在此硬编码。时长需设置在该端点公布的范围内;对于落在可行值之间的编辑目标,选择最近的有效时长并设置 targetEditDurationSeconds。当 targetEditDurationSeconds 小于 duration 时,需包含 timeline.activePerformanceEndSeconds 和 timeline.tailStrategy。如果目标脚本或节拍计划超过端点最大时长,应拆分为独立的可提交片段,而不要提交单个超大请求。对于 2.5 参考编辑或延长,需提供参考视频并使用精确的 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;timeline 创作字段没有单独的标志或请求字段,也没有请求 JSON 信封需要编写。参考需显式绑定:说明 [image 1]、[image 2]、[audio 1] 或 [video 1] 控制什么,不要依赖“与之前相同”“上述内容”或未绑定的局部句柄。

本地参考媒体可通过 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 真人豁免。自动 Moyu 资产库升级仅对企业版 Seedance 2.0 first_frame 路径且具有真实端到端证据时启用。reference_image 在记录运行中经 asset:// 重写后仍被隐私阻止,且尚无已批准的付费 Seedance 2.5 豁免冒烟测试;这两条路径都会以服务商的类型化策略边界失败。

在提交前,需确认校验通过、每个片段自包含、参考已绑定、所需媒体存在、来源依据明确、输出路径持久。Seedance 2.5 支持已通过官方/实时服务商材料和本地 submit/poll/result/billing 模拟进行契约验证,但在获批的付费冒烟测试检查 MP4、实际时长、分辨率、音轨和结算之前,不应将这些输出属性标记为已工件证明。

如果渲染处于待处理状态,需返回片段 id、manifest 路径、output.data.id 生成句柄、轮询命令 postplus media poll --handle <output.data.id> 以及预期的本地 renders/ 输出路径。轮询命令会在命令内等待(每次调用每 8 秒重新检查,最多 45 秒;--wait-seconds 0 表示单次检查):在渲染仍待处理时重新运行同一命令,而不是重新提交或编写更紧的重试循环。完成渲染后可用 postplus media-file download --url <fresh-output-url> --output-file <renders/...> 保存到磁盘(或对托管存储中的媒体使用 --reference postplus-media://...);服务商输出 URL 是临时的,需趁新鲜下载。

停止条件包括:当所需用户意图、来源证据或自有输入工件缺失且猜测会改变结果时停止。如果自有的 CLI 或脚本命令失败,报告确切错误并停止,不要通过仅元数据回答、就绪探测、本地负载重写、回退服务商或未发布工具来绕过失败。公开命令边界:从用户输入选择最小匹配的命令或工作流并直接运行;就绪诊断使用 postplus doctor --skill seedance-submitter;轮询待处理渲染使用 postplus media poll --handle <output.data.id>;仅在构造或修复未知请求形状时使用 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> 并使用返回的令牌重试。