Seedance 2.0
Seedance 2.0 查询素材
使用 GET /api/asset/get 查询 Seedance 2.0 素材详情和处理状态。
GET
Seedance 2.0 查询素材
这个接口用于查询通过POST /api/asset/createMedia 创建的素材。
- 根据素材 ID 查询素材详情
- 返回素材 URL、类型和状态
- 可用于确认素材是否已从
Processing变为Active - 查询接口使用裸素材 ID;视频生成接口使用
asset://{asset_id}引用素材
方法与路径
从素材 ID 到视频生成引用
GET /api/asset/get 的 id 参数只接收素材 ID 本身,例如 asset-20260528143012-a8x7k。不要在查询接口里加 asset:// 前缀。
当 Result.Status 为 Active 后,可以把同一个素材 ID 拼成 asset://{asset_id},传给视频生成接口中的素材字段。
响应示例
认证
Query Parameters
string
required
素材 ID,例如
asset-20260528143012-a8x7k。这里使用裸 ID,不要传 asset://asset-20260528143012-a8x7k。Response
object
请求元信息。
string
素材 ID。用于查询时保持裸 ID;用于视频生成素材字段时拼成
asset://{Result.Id}。string
素材名称。
string
素材 URL。
string
素材类型。常见值为
image、video、audio。string
素材状态。常见值为
Processing、Active、Failed。使用场景
创建素材后确认状态
创建素材接口返回Processing 后,使用素材 ID 查询,直到 Result.Status 变为 Active。
检查素材类型
读取Result.AssetType,确认素材是否按预期注册为 image、video 或 audio。
注意事项
id必须来自素材创建接口返回的Result.Id。GET /api/asset/get的id参数不要带asset://前缀。Processing表示素材仍在处理,建议等待Active后再用于视频生成。Failed表示素材处理失败,需要重新检查原始 URL、文件格式或上游限制。