Skip to main content

简短回答

两个问题分开回答:
  1. 不会自动上传:调用 Seedance 2.0 接口时,人脸参考图不会自动入库到素材库。需要单独走素材库上传流程拿到 asset:// 素材 ID,再在视频生成请求里引用它。
  2. 会被拦截:含写实人脸的参考图直接传入会被上游内容安全机制拦截。直接传真人照片生视频会失败。
正确链路有两种走法,按你的人物类型选:
  • 虚拟人像(AI 生成的写实人像,现实中无对应真人):用素材库的「虚拟人像入库」拿 asset:// ID 后引用
  • 真人人脸(艺人、模特、用户本人):先做活体扫脸认证 → 入库时带真人素材组 groupId → 拿 asset:// ID 后引用
  • 近 30 天内 Seedance 生成的产物:可以用做二次创作的参考图(走 Seedance 模型近 30 天内生成的含人脸产物路径)

详细说明

为什么不能直接传人脸图?

Seedance 2.0 生成人物一致性视频时,不能直接上传含写实人脸的参考图(防深伪拦截)。这是上游内容安全机制的限制,不是 API易 这边的策略。

正确的工作流

1

判断素材类型

先确认你的人像属于哪一类:
  • 动漫 / 风格化角色(二次元、卡通):不含写实人脸,不需要入库,直接传公网 URL 或 base64 即可
  • 虚拟人像(AI 生成写实人像):走「虚拟人像入库」,全自动无审核
  • 真人人脸(艺人、模特、用户本人):必须先做活体扫脸认证
2

上传到素材库拿 asset:// ID

  • 网页:在 icover.ai 素材库 上传图片,等待状态变「可用」后复制 asset://xxx
  • API:用 presign + POST /api/asset-library/assets 走完整代码链路,详见 素材引用实战
3

在视频生成请求里引用素材 ID

Seedance 2.0 接口的 content 里用 image_url 字段传 asset://<Id>,提示词里用「图片1」指代人物。详见 Seedance 2.0 视频生成 API
两把钥匙,不要混用
  • 素材库 KEY(icover.ai 创建):只用于上传 / 入库 / 查询素材
  • APIYI SeeDance2 令牌(api.apiyi.com 创建,须勾选 SeeDance2 分组):只用于视频生成接口
详细说明见 素材库

真人素材的特殊流程

真人照片不能仅靠”上传入库”绕过防深伪拦截——必须由被拍摄者本人完成活体扫脸认证(登录本人火山账号做人脸识别),从源头锁定肖像权归属,无法由他人代为认证。具体流程:
1

生成真人认证链接

让艺人用手机扫码 / 打开链接,登录其火山账号完成活体认证
2

查询认证结果

得到该艺人专属的真人素材组 groupId
3

入库时带 groupId

上传素材时带上该组 groupId,通过人脸一致性校验后拿到 asset:// ID。同一艺人换妆造复用同一组,无需重复认证
真人 ≠ AI 生成的写实人像。现实中不存在对应人物的 AI 生成写实人像(例如 Nano Banana 生成的人物)属于「虚拟人」,直接走「虚拟人像入库」即可,没有授权环节。只有真实存在的人的照片才是「真人人脸」——这类图片上传不等于授权,必须被拍摄者本人完成活体认证。

常见问题

不会。asset:// 素材 ID 永久有效,入库一次即可反复引用。但视频生成成功后返回的 content.video_url 是 24 小时有效的签名直链,过期后无法访问——请在任务成功后立即下载转存
可以。同一个素材组可以上传多张图(侧脸 / 多人 / 模糊可能失败,建议清晰正面)。asset:// ID 是素材级 ID,不是图片级 ID——同一素材组内的不同图共享同一个 ID。
不收。虚拟人像入库、真人认证等私域素材库能力在 API易 随 Seedance 2.0 接口免费使用,不另收年费。
上游内容安全机制拦截。HTTP 400 不扣费,但请求被拒绝——你需要在请求前完成素材入库,再引用 asset:// ID。

相关文档