Seedance 2.0：素材入库与状态自查

为什么要入库

完成入库的可信素材可用于 Seedance 2.0 视频生成。未入库的同一形象素材通常无法作为可信素材引用。

推荐流程

1. 创建素材组（可按角色/场景命名）。
2. 向素材组上传素材（图片/视频/音频）；每次请求上传一个文件。
3. 用查询接口轮询素材状态，直到 Active 或 Failed。
4. 状态为 Active 后，用素材 URI（格式 asset:// 后接素材 ID）参与视频生成。

状态说明

• Processing：预处理中，请继续轮询，勿立即用于生成。
• Active：可用，可用于后续推理。
• Failed：处理失败，不可用；请检查格式后重新上传。

轮询建议

1. 上传后拿到素材 ID。
2. 周期性查询状态（例如每隔数十秒）。
3. Processing → 继续等；Active → 可生成；Failed → 停止并排错。

上传为异步接口，可能排队；视频类处理更久，请预留等待时间。

项目隔离（高频踩坑）

• 素材组、素材、视频生成所用密钥/接入点须属于同一项目。
• 上传与查询时传入的项目名不一致，会出现「上传成功但查不到 / 无法生成」。
• 未指定项目时，通常落到默认项目；建议固定在同一项目中管理素材。

在视频请求中如何引用

• URL 字段使用：asset:// 后接素材 ID。
• 提示词中用「图片1 / 视频1 / 音频1」指代，序号为同类素材在请求中的顺序。
• 不要在提示词里直接写素材 ID。