# 素材对象

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

## 属性

| 字段 | 类型 | 要求 | 说明 |
| --- | --- | --- | --- |
| `asset_id` | string | 必填 | 平台素材标识。 长度：36–36。 格式：ast- 加 32 位十六进制。 |
| `status` | string | 必填 | 当前状态，具体含义见对应取值。 `processing`：处理中； `active`：素材已可用； `unavailable`：不可用； |
| `object` | string | 必填 | 对象类型标识。 固定为：asset。 |
| `media_type` | string | 必填 | 媒体类型。 `image`：图片； `audio`：音频； `video`：视频； |
| `model` | string | 必填 | 本次使用的模型标识。 `dreamina-seedance-2-0-260128`：Seedance 2.0； `dreamina-seedance-2-0-fast-260128`：Seedance 2.0 Fast； `dreamina-seedance-2-0-mini-260615`：Seedance 2.0 Mini； |
| `name` | string | 可选 | 可选显示名称；不含控制符、行段分隔符或双向文本控制符。 长度：1–64。 |
| `created_at` | integer | 必填 | 创建时间，Unix 整数秒。 范围：≥ 0。 |
| `updated_at` | integer | 必填 | 最后更新时间，Unix 整数秒。 范围：≥ 0。 |
| `width` | integer | 可选 | status 为 active 且 media_type 为 image 或 video 时必须返回的像素宽度；音频、处理中或不可用时不返回。 范围：≥ 1。 |
| `height` | integer | 可选 | status 为 active 且 media_type 为 image 或 video 时必须返回的像素高度；音频、处理中或不可用时不返回。 范围：≥ 1。 |
| `duration_ms` | integer | 可选 | status 为 active 且 media_type 为 audio 或 video 时必须返回的测量时长，毫秒；图片、处理中或不可用时不返回。 范围：≥ 1。 |
| `size_bytes` | integer | 可选 | status 为 active 时必须返回的存储大小，字节；处理中或不可用时不返回。 范围：≥ 1。 |
| `sha256` | string | 可选 | status 为 active 时必须返回的实际存储字节 SHA-256 摘要；处理中或不可用时不返回。 长度：64–64。 格式：64 位十六进制。 |
| `failure_reason` | string | 可选 | status 为 unavailable 时必须返回的不可用原因；处理中或可用时不返回。 `source_url_not_allowed`：来源地址不符合获取策略； `source_fetch_failed`：来源获取失败； `source_too_large`：来源文件过大； `media_type_mismatch`：媒体类型不匹配； `media_constraints_violated`：不符合媒体约束； `review_rejected`：素材审核未通过； `review_unavailable`：素材审核暂不可用； `internal_error`：服务未能完成请求； |

## 示例

```json
{
  "asset_id": "ast-11111111111111111111111111111111",
  "object": "asset",
  "media_type": "image",
  "model": "dreamina-seedance-2-0-260128",
  "name": "reference",
  "created_at": 1700000000,
  "updated_at": 1700000100,
  "status": "processing"
}
```

用「[查询素材状态](./api-docs-zh-api-assets-retrieve.md)」读取这个对象。