新版素材库

新版 Seedance 素材库用于保存图片、视频和音频。它与旧版素材库完全隔离，素材组 ID 和素材 ID 不能跨版本使用。

接口基础地址：

https://www.dianlitoken.com/v1/seedance/v2

所有请求都需要点力 API Key：

Authorization: Bearer <API_KEY>

模型与素材库归属

新版素材请求建议始终携带实际要生成的 model，例如：

doubao-seedance-2-0-260128

• JSON 写接口：在请求体中传 "model":"doubao-seedance-2-0-260128"。
• multipart 上传：增加 -F "model=doubao-seedance-2-0-260128"。
• GET 和 DELETE 接口：增加 ?model=doubao-seedance-2-0-260128。

model 用于选择与生成任务兼容的素材库。同一份原始文件可以为不同模型家族分别上传，但返回的 asset:// 标识不一定能跨模型家族复用。后续查询、修改、删除和生成时，应使用与上传时相同的 model。不传 model 仅用于兼容已有客户端。

完整接口列表

新版素材相关能力共 13 项：

功能	方法	路径
创建素材组	POST	/asset-groups
素材组列表	GET	/asset-groups
素材组详情	GET	/asset-groups/{group_id}
修改素材组	PUT	/asset-groups/{group_id}
删除素材组	DELETE	/asset-groups/{group_id}
在线 URL 上传素材	POST	/assets
本地文件上传素材	POST	/assets/upload
素材列表	GET	/assets
素材详情	GET	/assets/{asset_id}
修改素材	PUT	/assets/{asset_id}
删除素材	DELETE	/assets/{asset_id}
创建真人认证会话	POST	/visual-validate/session
查询真人认证结果	POST	/visual-validate/result

以下示例中的路径均相对于上述基础地址。

1. 创建素材组

curl -X POST "https://www.dianlitoken.com/v1/seedance/v2/asset-groups" \
  -H "Authorization: Bearer $DIANLI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "项目素材",
    "description": "人物和参考镜头",
    "model": "doubao-seedance-2-0-260128"
  }'

name 最长 64 个字符，description 最长 300 个字符，两者均可省略。

响应示例：

{
  "groupId": "group-20260717150451-l8rb6",
  "groupType": "AIGC",
  "groupName": "项目素材",
  "description": "人物和参考镜头",
  "createdTime": "2026-07-17 15:04:51",
  "updatedTime": "2026-07-17 15:04:51"
}

2. 查询素材组

素材组列表

curl "https://www.dianlitoken.com/v1/seedance/v2/asset-groups?model=doubao-seedance-2-0-260128" \
  -H "Authorization: Bearer $DIANLI_API_KEY"

响应中的 data 只包含当前 API Key 所属用户、当前新版渠道下创建或认证得到的素材组。

该接口一次返回当前用户登记的全部素材组；需要分页展示时，可由客户端对 data 分页。

素材组详情

curl "https://www.dianlitoken.com/v1/seedance/v2/asset-groups/group-20260717150451-l8rb6?model=doubao-seedance-2-0-260128" \
  -H "Authorization: Bearer $DIANLI_API_KEY"

3. 修改或删除素材组

curl -X PUT "https://www.dianlitoken.com/v1/seedance/v2/asset-groups/group-20260717150451-l8rb6" \
  -H "Authorization: Bearer $DIANLI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "新名称",
    "description": "新的素材组说明",
    "model": "doubao-seedance-2-0-260128"
  }'

curl -X DELETE "https://www.dianlitoken.com/v1/seedance/v2/asset-groups/group-20260717150451-l8rb6?model=doubao-seedance-2-0-260128" \
  -H "Authorization: Bearer $DIANLI_API_KEY"

删除素材组会使组内素材不能再用于新任务，请先确认业务侧不再引用。

4. 本地文件上传

先创建素材组，再使用返回的 groupId 上传文件：

curl -X POST "https://www.dianlitoken.com/v1/seedance/v2/assets/upload" \
  -H "Authorization: Bearer $DIANLI_API_KEY" \
  -F "group_id=group-20260717150451-l8rb6" \
  -F "asset_name=参考镜头" \
  -F "model=doubao-seedance-2-0-260128" \
  -F "file=@/path/to/reference.mp4"

本地上传会根据文件扩展名识别 Image、Video 或 Audio，无需额外传入素材类型。

响应示例：

{
  "id": "asset-20260717112309-z75vh"
}

5. 在线 URL 上传

资源 URL 必须是上游可直接下载的公网 HTTP/HTTPS 地址：

curl -X POST "https://www.dianlitoken.com/v1/seedance/v2/assets" \
  -H "Authorization: Bearer $DIANLI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "group_id": "group-20260717150451-l8rb6",
    "asset_name": "人物正面图",
    "asset_url": "https://example.com/character.png",
    "asset_type": "Image",
    "model": "doubao-seedance-2-0-260128"
  }'

asset_type 可选值为 Image、Video、Audio。

asset_url 接受长度不超过 2048 字符、解析到公网地址且使用 80/443 端口的 HTTP/HTTPS URL。Base64 素材请先解码为文件，再使用 multipart 的 /assets/upload 上传。远程服务器必须返回与素材一致的 MIME 类型和有效文件内容。

6. 查询素材

素材列表

curl "https://www.dianlitoken.com/v1/seedance/v2/assets?model=doubao-seedance-2-0-260128" \
  -H "Authorization: Bearer $DIANLI_API_KEY"

该接口返回当前用户、当前新版渠道下由平台登记的素材记录，响应为 {"total":数字,"data":[]}。需要最新处理状态时，请按素材 ID 调用详情接口。

素材详情与处理状态

curl "https://www.dianlitoken.com/v1/seedance/v2/assets/asset-20260717112309-z75vh?model=doubao-seedance-2-0-260128" \
  -H "Authorization: Bearer $DIANLI_API_KEY"

响应示例：

{
  "assetId": "asset-20260717112309-z75vh",
  "groupId": "group-20260717150451-l8rb6",
  "assetName": "参考镜头",
  "assetType": "Video",
  "assetUrl": "https://example.com/temporary-signed-url",
  "status": "ACTIVE",
  "createdTime": "2026-07-17 11:23:09",
  "updatedTime": "2026-07-17 11:24:10"
}

状态	含义	能否用于生成
PROCESSING	正在处理	否，继续查询
ACTIVE	已就绪	是
FAILED	处理失败	否，查看错误后重新上传

assetUrl 是动态签名地址，通常只有有限有效期，不要长期缓存。

7. 修改或删除素材

curl -X PUT "https://www.dianlitoken.com/v1/seedance/v2/assets/asset-20260717112309-z75vh" \
  -H "Authorization: Bearer $DIANLI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset_name":"新的素材名称","model":"doubao-seedance-2-0-260128"}'

curl -X DELETE "https://www.dianlitoken.com/v1/seedance/v2/assets/asset-20260717112309-z75vh?model=doubao-seedance-2-0-260128" \
  -H "Authorization: Bearer $DIANLI_API_KEY"

8. 在生成任务中引用素材

只有 ACTIVE 状态的素材才能用于生成。将素材 ID 写成：

asset://asset-20260717112309-z75vh

火山官方格式示例：

{
  "type": "image_url",
  "image_url": {
    "url": "asset://asset-20260717112309-z75vh"
  },
  "role": "reference_image"
}

平台会验证素材是否属于当前用户和实际调用渠道、类型是否匹配且状态是否为 ACTIVE，随后将 asset://<asset_id> 原样提交给上游。该标识会保留素材库及真人素材的授权上下文；不要将它替换成素材详情返回的动态签名 assetUrl，也不要传入旧版素材 ID、其他用户的素材 ID 或本地文件路径。

9. 真人认证

真人认证也是新版素材库的一部分，包含创建 H5 会话和查询认证结果两个接口。完整示例见新版真人认证。认证成功后返回的素材组 ID 仅可用于新版模型。

文件边界

类型	格式	尺寸与时长	大小上限
图片	JPEG、PNG、WebP 等	单边 300～6000px；宽高比大于 0.4 且小于 2.5	30MB
视频	MP4、MOV	2～15 秒；24～60fps；宽高比 0.4～2.5	200MB
音频	WAV、MP3	2～15 秒	15MB

视频总像素范围及模型可用素材数量仍会按实际模型能力进一步校验。

隔离规则

• 新版素材组和素材绑定当前用户及实际模型家族。
• 上传、查询和生成应使用同一个 model；不要假设所有新版模型共享素材 ID。
• 新版与旧版素材库不能复用 ID。
• 未经当前网关登记的第三方素材 ID 不能通过 asset:// 引用。
• 删除素材后，引用该素材的新任务会失败。

字段命名说明

网关公开写接口统一使用 snake_case，例如 group_id、asset_name、asset_url、asset_type；素材组和素材详情保留上游响应的 camelCase，例如 groupId、assetId、assetUrl。请分别按各接口示例构造请求和解析响应，不要混用字段名。