Skip to main content
GET

Seedance 2.0 查询素材

这个接口用于查询通过 POST /api/asset/createMedia 创建的素材。
  • 根据素材 ID 查询素材详情
  • 返回素材 URL、类型和状态
  • 可用于确认素材是否已从 Processing 变为 Active
  • 查询接口使用裸素材 ID;视频生成接口使用 asset://{asset_id} 引用素材

方法与路径

从素材 ID 到视频生成引用

GET /api/asset/getid 参数只接收素材 ID 本身,例如 asset-20260528143012-a8x7k。不要在查询接口里加 asset:// 前缀。 Result.StatusActive 后,可以把同一个素材 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
素材类型。常见值为 imagevideoaudio
string
素材状态。常见值为 ProcessingActiveFailed

使用场景

创建素材后确认状态

创建素材接口返回 Processing 后,使用素材 ID 查询,直到 Result.Status 变为 Active

检查素材类型

读取 Result.AssetType,确认素材是否按预期注册为 imagevideoaudio

注意事项

  • id 必须来自素材创建接口返回的 Result.Id
  • GET /api/asset/getid 参数不要带 asset:// 前缀。
  • Processing 表示素材仍在处理,建议等待 Active 后再用于视频生成。
  • Failed 表示素材处理失败,需要重新检查原始 URL、文件格式或上游限制。

相关页面