跳转到主要内容
Seedance 2.0 可以基于可信参考素材生成视频——一张脸、一套服装、一件商品、一段 声音。为保证生成的一致性与合规,这些参考素材存放在模型推理时信任的私有素材库中。 OrcaRouter 把该素材库通过 /v1/asset 暴露出来。 本页讲素材库怎么运作、有什么要求。具体端点、参数和在线调试,见 API Reference → Seedance Assets。

​
素材库结构

  • 资产组（Asset Group）——容器。真人组里一个组对应一个真人;虚拟组则是逻辑分组 （例如一个角色）。
  • 资产（Asset）——组内的单个文件（图片、视频或音频）。只有状态变为 Active 的资产才能用于生视频。
就绪的资产在视频请求中用 asset://<asset_id> 引用。

​
两类资产组

两类组的上传与管理操作完全一致,区别只在怎么建组。
虚拟（AIGC）真人（LivenessFace）
用途虚构 / AI 角色、道具、场景真人的肖像
创建方式直接调用创建接口由本人完成一次人脸核验
原因无需保护身份涉及肖像权——在源头采集本人授权
两个库都需要 Advanced Creation Rights,容量配额在两者间共享。真人库面向受邀账号 开放。

​
素材文件要求

素材以可公网访问的 URL 提供（不支持文件上传、不支持 base64）。限制:
类型格式约束
图片jpeg、png、webp、bmp、tiff、gif、heic/heif宽高比(W/H) 0.4–2.5 · 单边 300–6000 px · < 30 MB
视频mp4、mov480p/720p/1080p · 2–15 秒 · 宽高比 0.4–2.5 · 300–6000 px · 总像素 409,600–2,086,876 · 24–60 fps · ≤ 50 MB
音频wav、mp32–15 秒 · ≤ 15 MB
肖像素材最佳实践（利于人脸一致性）:
  • 全身参考:竖图,人物全身正面。
  • 面部特写:竖图,无表情,取景在肩部以上,脸部约占画面三分之二。
把同一个人的多张优质参考放进同一个组,能让生成视频更忠实地还原其脸部与衣着。

​
资产生命周期（上传是异步的）

上传资产会立即返回 asset_id,文件随后在后台预处理。轮询资产直到 Status 稳定:
  • Processing——仍在预处理,继续轮询。
  • Active——就绪,可用于生视频。
  • Failed——预处理被拒,查看 Error（如格式/尺寸、内容审核拦截,或真人组的 FaceMismatch）。
上传时长不保证 SLA,视频素材比图片更慢。资产返回的签名下载 URL 是临时的（约 12 小时）。

​
真人核验流程

真人组由本人完成一次核验来创建。你的后端不接触人脸数据,只编排流程:
1

发起会话

后端请求 OrcaRouter 发起核验会话,拿到一个 H5 链接（托管的人脸核验页）和一个 session_id。
2

本人核验

把 H5 链接交给终端用户。他们在自己的设备上打开——无需登录 OrcaRouter——完成人脸 核验。一次授权后,同一个人的新造型可以加进同一个组,无需重复核验。
3

完成建组

核验成功后,核验页会把终端用户浏览器重定向回 OrcaRouter 的回调（自动处理）,新建的组 随即登记好。若你传了 return_url,用户会回到你的页面。
4

轮询结果

后端轮询会话,直到 status 为 success（带新的 group_id）或 failed。之后上传 素材、生成视频的方式与虚拟组完全一致。
人脸一致性。 向真人组上传图片时,会与核验参考图比对。非同一人（或一张图里有多张 脸）会被拒,资产变为 Failed / FaceMismatch。组的名称和描述可在建组后通过更新组 接口设置。

​
配额

你的账号有素材数量上限（默认 100,跨所有组合计）。超限的上传会以 403 拒绝。

​
在视频生成中引用素材

资产 Active 后,在 Seedance 视频请求 的 metadata.content[] 里用 asset://<asset_id> 引用,并在 prompt 中按类型 + 位置 （[Image 1]、[Video 1]、[Audio 1]）指代——不要直接写 asset id: 
{
  "model": "byteplus/dreamina-seedance-2-0-260128",
  "prompt": "[Image 1] 中的女孩在柜台整理物品。",
  "metadata": {
    "content": [
      { "type": "image_url", "role": "reference_image",
        "image_url": { "url": "asset://asset-20260318071009-xy98z" } }
    ]
  }
}

​
下一步

  • API Reference → Seedance Assets——每个端点、完整参数和在线调试台 （请求/响应示例在这里）。
  • Seedance 视频——消费这些素材的视频生成端点。