Skip to main content
GET
获取 Seedance 素材资产
获取素材及其处理状态。ready 为 true 且 status 为 ACTIVE 时即可用于视频生成。 如果返回 Seedance material asset not found or not accessible,请确认传入的是素材 id,不是 group_id。 project_name 用于同一组织内的资源隔离,默认为 default。相关素材组和素材须使用相同且区分大小写的值;POST/PUT 在 JSON 请求体中传入,GET/DELETE 在查询参数中传入。

请求示例

响应示例

授权

Authorization
string
header
必填

API Key 身份验证。在 Dashboard > API > API Keys 中创建或管理 API Key。

路径参数

assetId
string
必填

查询参数

project_name
string
默认值:default

素材资源的项目范围。

Required string length: 1 - 128

响应

素材资产

id
string
必填

TokenLab 素材资源 ID。在资产变为 ACTIVE 后,请将其用作 material_asset_id。

object
enum<string>
必填
可用选项:
seedance.material_asset
library_type
enum<string>
必填
可用选项:
aigc_avatar,
liveness_face
asset_type
enum<string>
必填
可用选项:
Image,
Video,
Audio
status
enum<string>
必填
可用选项:
PROCESSING,
ACTIVE,
FAILED,
DELETED
ready
boolean
必填

当资产处于活跃状态且未被删除时为 true。

group_id
string | null

拥有此素材资源的 TokenLab 素材组 ID。

project_name
string

此素材资源的项目范围。

asset_name
string | null
error_message
string | null

可公开显示的终端处理错误。永久性源验证失败包括被拒绝的尺寸约束。

metadata
object | null
created_at
integer

素材资源记录创建时的 Unix 时间戳。

updated_at
integer

素材资源记录最后更新时的 Unix 时间戳。