真人素材库接口描述-dreamina/dreamina-ep(已下架，请尽快迁移hc模型)
真人素材库 · 接口文档
SD 2.0 渠道素材上传与查询
/api/v4/assets支持模型
该素材文档支持模型如下：
dreamina-seedance-2-0-260128
dreamina-seedance-2-0-fast-260128
dreamina-seedance-2-0-mini-260615
dreamina-seedance-2-0-ep
dreamina-seedance-2-0-fast-ep
dreamina-seedance-2-0-mini-ep
dreamina-seedance-2-5-ep
注意：以上模型素材资产每小时轮训清除，无法获取之前上传资产。（若需要保留资产，则使用doubao/dreamina-hc模型相关文档）目录
通用说明
Base URL
https://docs.aiide.com鉴权方式
统一响应格式
{
"code": 0,
"message": "ok",
"data": {}
}{
"code": -1,
"message": "错误信息"
}1. 上传素材
请求头
| 名称 | 必填 | 说明 |
|---|---|---|
Authorization | 是 | 用户 Token |
Content-Type | 是 | application/json |
请求体参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
url | string | 是 | 素材的 URL 地址 |
asset_type | string | 是 | 素材类型，可选值：Image、Video、Audio |
name | string | 否 | 素材名称 |
请求示例
成功响应示例
{
"code": 0,
"message": "ok",
"data": {
"Id": "asset-20260624154521-7rvsf"
}
}上传后素材可能处于处理中状态。请使用查询素材详情接口轮询素材状态，直至 Status为completed。如果Status为failed，可通过Error字段查看失败原因。
2. 查询素材详情
请求参数
| 位置 | 名称 | 必填 | 说明 |
|---|---|---|---|
| Header | Authorization | 是 | 用户 Token |
| Path | id | 是 | 素材 ID，例如 asset-20260624154521-7rvsf |
请求示例
成功响应示例
{
"code": 0,
"message": "ok",
"data": {
"Id": "asset-20260624154521-7rvsf",
"Name": "girl02",
"AssetType": "Image",
"GroupId": "group-20260624150504-5vm9n",
"Status": "completed",
"URL": "https://...",
"CreateTime": "2026-06-24T07:45:21Z",
"UpdateTime": "2026-06-24T07:45:24Z"
}
}失败素材响应示例
{
"code": 0,
"message": "ok",
"data": {
"Id": "asset-20260626165901-qgsr9",
"Name": "测试02",
"AssetType": "Image",
"GroupId": "group-20260624150504-5vm9n",
"Status": "failed",
"Error": {
"Code": "InputImageSensitiveContentDetected.PolicyViolation",
"Message": "The request failed because the input image may be related to copyright restrictions."
},
"CreateTime": "2026-06-26T08:59:01Z",
"UpdateTime": "2026-06-26T08:59:04Z"
}
}code为0表示查询请求成功；素材本身是否处理成功，应以data.Status为准。
响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
Id | string | 素材 ID |
Name | string | 素材名称 |
AssetType | string | 素材类型 |
GroupId | string | 素材所属分组 |
Status | string | 素材状态，常见值：processing、completed、failed |
URL | string | 素材访问地址，通常在处理完成后返回 |
Error | object | 失败原因，仅处理失败时返回 |
Error.Code | string | 错误代码 |
Error.Message | string | 错误描述 |
CreateTime | string | 创建时间，RFC 3339 UTC 时间字符串 |
UpdateTime | string | 更新时间，RFC 3339 UTC 时间字符串 |
素材状态说明
| 状态 | 说明 |
|---|---|
processing | 素材正在处理中，请继续轮询 |
completed | 素材处理完成，可使用返回的 URL |
failed | 素材处理失败，可通过 Error.Code 和 Error.Message 查看原因 |
修改于 2026-08-11 02:36:34