Seedance 素材管理

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

素材管理与视频生成相互独立。创建素材时使用 volc-asset、volc-asset-video 或 volc-asset-audio，再将返回的 asset://<ID> 传给支持的 Seedance 模型。

对于特定内容请求，请选择 Direct 资源下对应的模型：图片使用 volc-asset-nsfw，视频使用 volc-asset-video-nsfw，音频使用 volc-asset-audio-nsfw。NSFW 模型名称是在标准模型 ID 后添加 -nsfw 后缀。

支持的 Seedance 模型

官方模型	AnyFast 模型 ID
Seedance 2.5	`seedance-2.5`
Seedance 2.0	`seedance-2.0`
Seedance 2.0 Fast	`seedance-2.0-fast`
Seedance 2.0 Mini	`seedance-2.0-mini`

为什么使用素材管理？

持久存储 — 素材存储在火山引擎，不会像临时 URL 那样过期
多格式支持 — 支持上传图片、视频和音频文件
分组管理 — 按项目或活动将相关素材归组
数据隔离 — 每个 API 令牌只能看到自己的素材
直接集成 — 在 Seedance 的 image_url、video_url、audio_url 字段中直接使用 asset://<ID>

支持的格式

类型	格式	限制
图片	JPG, PNG, GIF, WebP, BMP, TIFF, HEIC, HEIF	< 30 MB，300–6000 px，宽高比 0.4–2.5
视频	MP4, MOV	< 50 MB，2–15 秒，480p/720p，24–60 FPS
音频	MP3, WAV	< 15 MB，2–15 秒

Seedance 2.5 增强输入能力

本节仅适用于 seedance-2.5，作为上方原有素材管理说明的独立补充。调用模型时，可以通过公开 URL、支持的 Base64 数据或 asset://<ID> 素材引用传入媒体。

本节描述的是 Seedance 2.5 生成请求所使用的输入素材。上游参数和示例参见火山引擎 Seedance 2.5 官方文档。

图片要求

传入方式： 图片 URL、图片 Base64 编码或素材 ID。
图片格式： JPEG、PNG、WebP、BMP、TIFF、GIF、HEIC、HEIF。
图片尺寸： 宽高比（宽/高）为 0.4–2.5；宽和高均为 300–6000 px。
文件大小： 单张图片小于 30 MB，请求体不超过 64 MB。大文件请勿使用 Base64 编码。

生成方式	图片数量
图生视频—首帧	1 张
图生视频—首尾帧	2 张
多模态参考生视频	1–30 张

视频要求

传入方式： 视频 URL 或素材 ID，不支持视频 Base64 输入。
视频格式： MP4、MOV。
分辨率： 480p、720p。
时长和数量： 单个视频时长为 2–30 秒，最多传入 10 个参考视频，所有视频总时长不超过 30 秒。
视频尺寸： 宽高比（宽/高）为 0.4–2.5；宽和高均为 300–6000 px。
总像素数： 宽和高的乘积为 409600（640 × 640）至 8295044（3326 × 2494）。
文件大小： 单个视频不超过 200 MB。
帧率： 24–60 FPS。

容器格式	常用文件扩展名	MIME	支持编码
MP4	`.mp4`	`video/mp4`	视频：H.264/AVC、H.265/HEVC；音频：AAC、MP3
QuickTime	`.mov`	`video/quicktime`	视频：H.264/AVC、H.265/HEVC；音频：AAC、MP3

音频要求

传入方式： 音频 URL、音频 Base64 编码或素材 ID。
音频格式： WAV、MP3。
时长和数量： 单个音频时长为 2–30 秒，最多传入 10 段参考音频，所有音频总时长不超过 30 秒。
文件大小： 单个音频不超过 15 MB，请求体不超过 64 MB。大文件请勿使用 Base64 编码。

保存时间

任务记录： 保存 7 天，查询区间为 [T-7 天, T)，其中 T 为请求发起时刻的 UTC 秒级时间戳。
生成视频 URL： 保存 24 小时，下载次数上限为 100 次。请及时下载或转存生成视频。

24 小时有效期适用于生成视频的结果 URL，与 GetAsset 返回的临时 URL 不是同一个概念。长期引用素材时请继续使用 asset://<asset_id>。

限流说明

RPM 限流： 账号下同模型每分钟允许创建的视频生成任务数量上限。超过限制时，创建任务会返回错误。
并发数限制： 账号下同模型同一时刻允许处理的任务数量上限。超过并发数的任务会进入队列等待处理。

计费模型

模型名	素材类型	说明
`volc-asset`	图片	默认，上传图片无需指定
`volc-asset-video`	视频	上传视频时必须指定
`volc-asset-audio`	音频	上传音频时必须指定

素材加白与审核耗时

模型名	素材类型	理想加白耗时
`volc-asset`	图片	6–9 秒
`volc-asset-video`	视频	9–12 秒
`volc-asset-audio`	音频	3–6 秒

上述时间为理想情况，实际耗时可能受文件体积、素材格式和审核队列拥塞影响。审核队列繁忙时，素材从创建到可用可能出现约 10 秒到 2 分钟的延迟。请在素材状态变为 Active 后再通过 asset://<ID> 使用。

异步处理与素材 URL

CreateAsset 是异步接口。接口返回素材 ID 只表示上传请求已被接收，素材仍需经过上游预处理后才能用于推理。请轮询调用 GetAsset，直到 Status 变为 Active。

状态	含义	是否可用于 Seedance 请求
`Processing`	素材正在排队或预处理。	否
`Active`	素材已可用。	是，使用 `asset://<asset_id>`
`Failed`	预处理失败。	否

不要将 GetAsset.URL 作为长期素材引用保存或直接用于生成。官方示例标注该 URL 有效期为 12 小时。生成视频时请使用 asset://<asset_id>。

工作流

创建素材组              →  素材组 ID
在素材组中创建素材       →  素材 ID
使用素材生成视频         →  异步任务 ID
轮询获取结果             →  预签名下载链接

真人活体认证工作流

当你需要创建私域真人肖像素材组时，使用 LivenessFace 流程。AnyFast 会创建一个移动端认证页面，用户在手机上完成真人活体认证后，认证结果会生成一个 LivenessFace 素材组。

完整授权流程和官方术语请参见录入真人形象素材指南。

真人活体认证必须使用选择了 Byteplus-Direct 分组的 API 令牌。普通 AIGC 素材分组仅支持 GroupType: "AIGC"，无法创建真人认证会话或 LivenessFace 真人素材。

创建认证会话

调用 CreateVisualValidateSession 获取 H5Link 和 BytedToken。

cURL

curl https://www.anyfast.ai/volc/asset/CreateVisualValidateSession \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "CallbackURL": "https://example.com/callback"
  }'

在手机上打开 H5Link

将返回的 H5Link 发给用户，用户在手机上完成真人活体认证。

查询认证结果

认证完成后，使用 BytedToken 调用 GetVisualValidateResult。认证成功会返回 GroupId。

cURL

curl https://www.anyfast.ai/volc/asset/GetVisualValidateResult \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "BytedToken": "2026070222152680501D985EA34A3BE3D8"
  }'

管理 LivenessFace 素材组

将返回的 GroupId 用于 UpdateAssetGroup、ListAssetGroups、CreateAsset、ListAssets 和 GetAsset。查询真人认证素材组或素材时，请传入 Filter.GroupType: "LivenessFace"。

如果认证未完成或未生成素材组，GetVisualValidateResult 可能返回 {"GroupId": ""}。无效或过期的 token 会返回上游错误。

向 LivenessFace 素材组上传图片时，图片人脸需要与真人认证的人一致。不一致时会返回 FaceMismatch，素材状态为 Failed。

第一步：创建素材组

首先创建一个素材组以获取素材组 ID。

curl https://www.anyfast.ai/volc/asset/CreateAssetGroup \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "volc-asset",
    "Name": "your-custom-name"
  }'

import requests

response = requests.post(
    "https://www.anyfast.ai/volc/asset/CreateAssetGroup",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "model": "volc-asset",
        "Name": "your-custom-name"
    }
)

group_id = response.json()["Id"]
print(f"素材组 ID: {group_id}")

预期响应：

{
  "Id": "group-20260427160000-xxxxx"
}

第二步：在素材组中创建素材

使用第一步获取的素材组 ID 上传素材（如角色参考图）。

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

response = requests.post(
    "https://www.anyfast.ai/volc/asset/CreateAsset",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "model": "volc-asset",
        "GroupId": "group-20260427160000-xxxxx",
        "Name": "character-reference",
        "AssetType": "Image",
        "URL": "https://example.com/example.png"
    }
)

asset_id = response.json()["Id"]
print(f"素材 ID: {asset_id}")

预期响应：

{
  "Id": "asset-20260427160000-xxxxx"
}

URL 字段支持三种格式：

普通 URL：https://example.com/image.jpg

Data URI：data:image/png;base64,iVBOR...

纯 Base64 字符串（自动识别，默认当作 PNG）

Base64 / Data URI 会自动上传到对象存储并替换为真实 URL。

上传视频

上传视频时必须指定 "model": "volc-asset-video" 和 "AssetType": "Video"。

cURL

curl https://www.anyfast.ai/volc/asset/CreateAsset \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "volc-asset-video",
    "GroupId": "group-20260427160000-xxxxx",
    "Name": "reference-clip",
    "AssetType": "Video",
    "URL": "https://example.com/clip.mp4"
  }'

上传音频

上传音频时必须指定 "model": "volc-asset-audio" 和 "AssetType": "Audio"。

cURL

curl https://www.anyfast.ai/volc/asset/CreateAsset \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "volc-asset-audio",
    "GroupId": "group-20260427160000-xxxxx",
    "Name": "background-music",
    "AssetType": "Audio",
    "URL": "https://example.com/bgm.mp3"
  }'

文件上传（multipart）

上传图片

curl https://www.anyfast.ai/volc/asset/CreateAsset \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/image.jpg" \
  -F "GroupId=group-20260427160000-xxxxx" \
  -F "Name=character-reference"

上传视频

curl https://www.anyfast.ai/volc/asset/CreateAsset \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=volc-asset-video" \
  -F "file=@/path/to/video.mp4" \
  -F "GroupId=group-20260427160000-xxxxx" \
  -F "Name=reference-clip" \
  -F "AssetType=Video"

上传音频

curl https://www.anyfast.ai/volc/asset/CreateAsset \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=volc-asset-audio" \
  -F "file=@/path/to/audio.mp3" \
  -F "GroupId=group-20260427160000-xxxxx" \
  -F "Name=background-music" \
  -F "AssetType=Audio"

第三步：使用素材生成视频

引用第二步获取的素材 ID 生成视频。

重要： 素材需严格按照 text、image_url、video_url、audio_url 的顺序传入。请勿调整顺序，否则可能导致报错；当包含多个素材时，也需确保其中不混入其他类型的素材。

cURL

curl https://www.anyfast.ai/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance",
    "content": [
      {
        "type": "text",
        "text": "@图1 中的人物走在 @视频1 的场景中，背景音乐使用 @音频1"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "asset://asset-20260427160000-xxxxx"
        },
        "role": "reference_image"
      },
      {
        "type": "video_url",
        "video_url": {
          "url": "asset://asset-20260427160000-video1"
        },
        "role": "reference_video"
      },
      {
        "type": "audio_url",
        "audio_url": {
          "url": "asset://asset-20260427160000-audio1"
        },
        "role": "reference_audio"
      }
    ],
    "resolution": "720p",
    "duration": 5
  }'

响应将返回一个异步任务 ID（以 asyn 为前缀）。

第四步：轮询获取结果

使用任务 ID 检查生成状态。

cURL

curl https://www.anyfast.ai/v1/video/generations/asynxxxx \
  -H "Authorization: Bearer YOUR_API_KEY"

完成后，响应将包含一个预签名的 S3 下载链接。请注意：

下载链接12 小时后过期。
如果任务进度达到 100% 但返回错误，通常表示输出被服务方内容审核拦截（例如名人肖像或受版权保护的 IP）。这种情况下请尝试修改提示词或更换参考图。

查询素材

组合过滤查询素材组

cURL

curl https://www.anyfast.ai/volc/asset/ListAssetGroups \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "volc-asset",
    "Filter": {
      "Name": "codex-seedance-assets-20260723",
      "GroupIds": ["group-20260723040610-zDYKrgRaKt"],
      "Id": "group-20260723040610-zDYKrgRaKt",
      "GroupType": "AIGC"
    },
    "PageNumber": 1,
    "PageSize": 10
  }'

200

{
  "Items": [
    {
      "GroupType": "AIGC",
      "Id": "group-20260723040610-zDYKrgRaKt",
      "Name": "codex-seedance-assets-20260723",
      "Status": "Active"
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 1
}

查询素材组内的素材

cURL

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

管理素材

更新素材组

cURL

curl https://www.anyfast.ai/volc/asset/UpdateAssetGroup \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "volc-asset",
    "Id": "group-20260427160000-xxxxx",
    "Name": "updated-project-assets"
  }'

更新素材

cURL

curl https://www.anyfast.ai/volc/asset/UpdateAsset \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "volc-asset",
    "Id": "asset-20260427161000-xxxxx",
    "Name": "updated-character-reference",
    "GroupId": "group-20260427160000-xxxxx"
  }'

删除素材

cURL

curl https://www.anyfast.ai/volc/asset/DeleteAsset \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "volc-asset",
    "Id": "asset-20260427161000-xxxxx"
  }'

删除素材组

cURL

curl https://www.anyfast.ai/volc/asset/DeleteAssetGroup \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "volc-asset",
    "Id": "group-20260427160000-xxxxx"
  }'

计费说明

操作	计费模型	是否计费
CreateAssetGroup	`volc-asset`	不计费
CreateAsset（图片）	`volc-asset`	不计费
CreateAsset（视频）	`volc-asset-video`	不计费
CreateAsset（音频）	`volc-asset-audio`	不计费
CreateVisualValidateSession	—	不计费
GetVisualValidateResult	—	不计费
ListAssetGroups	—	不计费
ListAssets	—	不计费
GetAsset	—	不计费
UpdateAssetGroup	`volc-asset`	不计费
UpdateAsset	`volc-asset`	不计费
DeleteAsset	`volc-asset`	不计费
DeleteAssetGroup	`volc-asset`	不计费

数据隔离

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

API 参考

创建素材组

创建新的素材组。

创建素材

上传素材（图片、视频、音频）到素材组。

创建真人认证会话

创建移动端真人活体认证会话。

查询真人认证结果

查询认证会话创建的 LivenessFace 素材组。

查询素材组

查询素材组列表。

查询素材

查询素材组内的素材。

更新素材组

更新素材组信息。

更新素材

更新素材信息。

删除素材

删除一个素材。

删除素材组

删除一个素材组。

​支持的 Seedance 模型

​为什么使用素材管理？

​支持的格式

​Seedance 2.5 增强输入能力

​图片要求

​视频要求

​音频要求

​保存时间

​限流说明

​计费模型

​素材加白与审核耗时

​异步处理与素材 URL

​工作流

​真人活体认证工作流

​第一步：创建素材组

​第二步：在素材组中创建素材

​上传视频

​上传音频

​文件上传（multipart）

​第三步：使用素材生成视频

​第四步：轮询获取结果

​查询素材

​组合过滤查询素材组

​查询素材组内的素材

​管理素材

​更新素材组

​更新素材

​删除素材

​删除素材组

​计费说明

​数据隔离

​API 参考

创建素材组

创建素材

创建真人认证会话

查询真人认证结果

查询素材组

查询素材

更新素材组

更新素材

删除素材

删除素材组

支持的 Seedance 模型

为什么使用素材管理？

支持的格式

Seedance 2.5 增强输入能力

图片要求

视频要求

音频要求

保存时间

限流说明

计费模型

素材加白与审核耗时

异步处理与素材 URL

工作流

真人活体认证工作流

第一步：创建素材组

第二步：在素材组中创建素材

上传视频

上传音频

文件上传（multipart）

第三步：使用素材生成视频

第四步：轮询获取结果

查询素材

组合过滤查询素材组

查询素材组内的素材

管理素材

更新素材组

更新素材

删除素材

删除素材组

计费说明

数据隔离

API 参考