Skip to main content
Seedance 素材管理让你可以上传和组织图片素材，供 Seedance 视频生成使用。上传后，在 Seedance 请求中通过素材 ID（Asset://<ID>）引用素材，无需使用公开 URL。

​
为什么使用素材管理？

  • 持久存储 — 素材存储在火山引擎，不会像临时 URL 那样过期
  • 分组管理 — 按项目或活动将相关素材归组
  • 数据隔离 — 每个 API 令牌只能看到自己的素材
  • 直接集成 — 在 Seedance 的 image_url 字段中直接使用 Asset://<ID>

​
工作流

1. 创建素材组       →  素材组 ID
2. 上传素材到素材组  →  素材 ID
3. 在 Seedance 中使用  →  Asset://<素材 ID>

​
第一步：创建素材组

curl https://www.anyfast.com.cn/volc/asset/CreateAssetGroup \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "volc-asset",
    "Name": "my-project-assets"
  }'

​
第二步：上传素材

支持两种方式：JSON（URL / Base64 / Data URI）和 multipart 文件上传。
URL 字段支持三种格式：
  • 普通 URL：https://example.com/image.jpg
  • Data URI：data:image/png;base64,iVBOR...
  • 纯 Base64 字符串（自动识别，默认当作 PNG）
Base64 / Data URI 会自动上传到对象存储并替换为真实 URL。

​
方式一：JSON

curl https://www.anyfast.com.cn/volc/asset/CreateAsset \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "volc-asset",
    "GroupId": "group-20260320120601-hsw4s",
    "Name": "character-reference",
    "AssetType": "Image",
    "URL": "https://example.com/character.jpg"
  }'

​
方式二：文件上传

cURL
curl https://www.anyfast.com.cn/volc/asset/CreateAsset \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=volc-asset" \
  -F "file=@/path/to/image.jpg" \
  -F "GroupId=group-20260320120601-hsw4s" \
  -F "Name=character-reference"

​
第三步：在 Seedance 中使用

将 Seedance 请求中的 URL 替换为 Asset://<素材 ID>： 
curl https://www.anyfast.com.cn/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance",
    "content": [
      {
        "type": "text",
        "text": "一只猫在阳光明媚的房间里弹钢琴"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "Asset://asset-20260320120147-pqwhc"
        },
        "role": "reference_image"
      }
    ],
    "generate_audio": true,
    "resolution": "720p",
    "ratio": "adaptive",
    "duration": 5
  }'

​
查询素材

​
查询素材组

cURL
curl https://www.anyfast.com.cn/volc/asset/ListAssetGroups \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "volc-asset",
    "Filter": {"Name": "my-project"},
    "PageNumber": 1,
    "PageSize": 10
  }'

​
查询素材组内的素材

cURL
curl https://www.anyfast.com.cn/volc/asset/ListAssets \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "volc-asset",
    "Filter": {
      "Name": "character",
      "GroupIds": ["group-20260320120601-hsw4s"],
      "GroupType": "AIGC"
    },
    "PageNumber": 1,
    "PageSize": 10
  }'

​
计费说明

操作是否计费
CreateAssetGroup按次计费
CreateAsset按次计费
ListAssetGroups不计费
ListAssets不计费
计费基于 model 字段指定的模型价格，默认模型为 volc-asset。

​
数据隔离

使用令牌访问时，系统自动为素材组名称添加 [u-{用户ID}]-[t-{令牌ID}] 前缀，实现用户和令牌级别的数据隔离。查询时自动过滤，仅返回当前令牌有权限的数据。

​
API 参考

创建素材组

创建新的素材组。

创建素材

上传素材到素材组。

查询素材组

查询素材组列表。

查询素材

查询素材组内的素材。