素材库

图片、视频或音频只需上传一次，之后便可通过固定的 asset:// 引用在支持的生成任务中重复使用，无需每次请求都重新上传。Seedance 中涉及真人或高度拟真人脸的参考素材必须通过素材库引用。

• 控制台入口：素材库
• 支持类型：图片、视频和音频
• 单文件大小上限：50 MB

核心概念

概念	说明
素材	上传的一张图片、一段视频或一段音频。每个素材都有固定 ID，例如 asset_1qdZ9QEqnvCzWPXKn3K9LXV1sotX1Hvp。
引用	格式为 asset://{素材 ID} 的字符串。在生成请求接受参考素材 URL 的位置，可以使用该引用。
资产组	用于整理素材的文件夹。移动素材不会改变素材引用、素材内容或生成效果。

在控制台中使用

1. 登录后，从左侧导航栏打开素材库。
2. 点击「上传素材」，选择一个或多个本地文件、粘贴一个或多个 URL，也可以同时使用两种方式。
3. 根据需要选择资产组。也可以在上传后新建分组或移动素材。
4. 打开素材详情，复制 asset://asset_... 引用；素材卡片上也提供快捷复制操作。
5. 将引用填入支持素材库的生成请求字段。

素材库页面还支持：

• 切换大、中、小图标或列表视图。
• 按素材名称或素材 ID 搜索。
• 批量移动或删除选中的素材。
• 在素材详情页查看最近的任务使用记录。

在 Seedance 中使用

单张首帧参考图可以在 images 中使用素材引用：

curl https://api.xinfera.cn/v1/video/generations \
  -H "Authorization: Bearer $XINFERA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-fast",
    "prompt": "角色缓缓转身，微风吹动衣角",
    "images": ["asset://asset_1qdZ9QEqnvCzWPXKn3K9LXV1sotX1Hvp"]
  }'

多素材、混合媒体或需要明确指定素材用途时，使用 metadata.content。公开 URL 和 asset:// 引用可以在同一个请求中混用。完整的请求格式和示例见 Seedance 视频生成。

通过接口管理素材

素材管理和生成任务使用不同的凭证：

操作	凭证	接口前缀
管理素材	个人资料 > 安全 > 访问令牌	/api/asset/...
提交生成	sk- 开头的 API 密钥	/v1/...

不要使用 API 密钥管理素材，也不要使用访问令牌提交生成任务。

运行以下示例前，先设置访问令牌：

export XINFERA_ACCESS_TOKEN="YOUR_ACCESS_TOKEN"

上传本地文件

curl -X POST https://xinfera.cn/api/asset/ \
  -H "Authorization: Bearer $XINFERA_ACCESS_TOKEN" \
  -F "file=@./character.png" \
  -F "name=角色立绘"

从 URL 上传

服务器会下载 URL 指向的文件并保存到素材库：

curl -X POST https://xinfera.cn/api/asset/ \
  -H "Authorization: Bearer $XINFERA_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/character.png","name":"角色立绘"}'

搜索和查看素材

# 按名称或素材 ID 搜索
curl "https://xinfera.cn/api/asset/?search=角色&p=1&page_size=20" \
  -H "Authorization: Bearer $XINFERA_ACCESS_TOKEN"

# 查看单个素材
curl https://xinfera.cn/api/asset/asset_1qdZ9QEqnvCzWPXKn3K9LXV1sotX1Hvp \
  -H "Authorization: Bearer $XINFERA_ACCESS_TOKEN"

移动或删除素材

将 group_id 设为空字符串，可以把素材移出当前分组，但不会删除素材：

# 移动素材到指定分组
curl -X PUT https://xinfera.cn/api/asset/asset_1qdZ9QEqnvCzWPXKn3K9LXV1sotX1Hvp \
  -H "Authorization: Bearer $XINFERA_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"group_id":"ag_xxxxxxxx"}'

# 删除素材
curl -X DELETE https://xinfera.cn/api/asset/asset_1qdZ9QEqnvCzWPXKn3K9LXV1sotX1Hvp \
  -H "Authorization: Bearer $XINFERA_ACCESS_TOKEN"

管理资产组

删除资产组不会删除组内素材，素材会变为未分组状态。

# 查看资产组列表
curl https://xinfera.cn/api/asset/group/ \
  -H "Authorization: Bearer $XINFERA_ACCESS_TOKEN"

# 新建资产组
curl -X POST https://xinfera.cn/api/asset/group/ \
  -H "Authorization: Bearer $XINFERA_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"角色立绘"}'

# 删除资产组
curl -X DELETE https://xinfera.cn/api/asset/group/ag_xxxxxxxx \
  -H "Authorization: Bearer $XINFERA_ACCESS_TOKEN"

常见问题

文件过大或格式不支持

单个文件不能超过 50 MB。如果原始格式无法上传，可以将图片转换为 PNG 或 JPG、视频转换为 MP4、音频转换为 MP3 后重试。

生成任务提示找不到素材

请检查引用中的素材 ID 是否正确、素材是否属于当前账号，以及素材是否已被删除。如果素材仍在素材库中且引用正确，可以尝试其他支持的模型，或将完整报错信息提供给管理员。

生成时提示素材处理失败

50 MB 和支持的媒体类型是素材库的通用限制。具体模型或生成渠道可能还有音频时长、视频尺寸等额外要求。请以生成请求返回的具体原因为准，并根据要求重新上传符合条件的素材。

移动素材会影响生成效果吗？

不会。资产组仅用于整理素材，移动素材不会改变素材 ID、引用或内容。

删除素材后会发生什么？

已经完成的任务及其生成结果不受影响，但被删除的引用不能再用于新任务。重新上传同一文件会得到新的素材 ID。

使用限制

项目	限制
单个文件大小	50 MB
素材名称长度	100 个字符
单账号素材总数	10,000 个
单账号资产组数量	200 个
列表分页大小	默认 20，最多 100
支持的媒体类型	图片、视频和音频