API v1

素材对象

素材状态与安全元数据。

查看 Markdown
  • active 时必须返回 size_bytes 和 sha256；图片和视频还必须返回 width、height，音频和视频还必须返回 duration_ms。
  • 图片不返回 duration_ms，音频不返回 width、height；active 不返回 failure_reason。
  • unavailable 时必须返回 failure_reason，且不返回大小、摘要、尺寸或时长；processing 时这些元数据与 failure_reason 均不返回。

属性

#asset_idstring必填

平台素材标识。

长度36–36格式ast- 加 32 位十六进制
#statusstring必填

当前状态，具体含义见对应取值。

processing处理中
active素材已可用
unavailable不可用
#objectstring必填

对象类型标识。

固定为asset
#media_typestring必填

媒体类型。

可选imageaudiovideo
#modelstring必填

本次使用的模型标识。

dreamina-seedance-2-0-260128Seedance 2.0
dreamina-seedance-2-0-fast-260128Seedance 2.0 Fast
dreamina-seedance-2-0-mini-260615Seedance 2.0 Mini
#namestring

可选显示名称；不含控制符、行段分隔符或双向文本控制符。

长度1–64
#created_atinteger必填

创建时间，Unix 整数秒。

范围≥ 0
#updated_atinteger必填

最后更新时间，Unix 整数秒。

范围≥ 0
#widthinteger

status 为 active 且 media_type 为 image 或 video 时必须返回的像素宽度；音频、处理中或不可用时不返回。

范围≥ 1
#heightinteger

status 为 active 且 media_type 为 image 或 video 时必须返回的像素高度；音频、处理中或不可用时不返回。

范围≥ 1
#duration_msinteger

status 为 active 且 media_type 为 audio 或 video 时必须返回的测量时长，毫秒；图片、处理中或不可用时不返回。

范围≥ 1
#size_bytesinteger

status 为 active 时必须返回的存储大小，字节；处理中或不可用时不返回。

范围≥ 1
#sha256string

status 为 active 时必须返回的实际存储字节 SHA-256 摘要；处理中或不可用时不返回。

长度64–64格式64 位十六进制
#failure_reasonstring

status 为 unavailable 时必须返回的不可用原因；处理中或可用时不返回。

source_url_not_allowed来源地址不符合获取策略
source_fetch_failed来源获取失败
source_too_large来源文件过大
media_type_mismatch媒体类型不匹配
media_constraints_violated不符合媒体约束
review_rejected素材审核未通过
review_unavailable素材审核暂不可用
internal_error服务未能完成请求

用「查询素材状态」读取这个对象。