跳转到主要内容
当前真人素材与虚拟人素材接口正在开发兼容中,尚未正式上线。本文用于说明预期接入流程和上线前准备,不代表这些接口已经可以在生产环境调用。正式上线后会补充完整接口路径、字段、错误码与代码示例。
基础文生视频、图片参考、首尾帧、视频参考等能力仍使用 Seedance 2.0 视频生成 API。本页只说明真人素材和虚拟人素材上线后的额外素材流程。

能力状态

能力当前状态说明
普通文生视频 / 图生视频已按基础 Seedance 接口提供使用 /seedance/api/v3/contents/generations/tasks 创建任务
真人素材开发兼容中,等待上线预计需要真人授权、认证和素材状态校验
虚拟人素材开发兼容中,等待上线预计通过虚拟人素材库或已授权素材 ID 使用
真人 + 虚拟人组合任务开发兼容中,等待上线预计会在同一个视频任务中引用多个已通过校验的人物素材

流程总览

1

准备素材与授权

确认真人肖像、声音、服装形象或虚拟人形象拥有合法授权。真人素材需要完成授权确认和认证流程;虚拟人素材需要确认素材库使用权限。
2

创建或选择人物素材

真人素材预计通过认证后生成可引用的素材 ID;虚拟人预计从素材库选择或创建后获得素材 ID。接口上线前,素材 ID 的字段名和创建路径尚未固定。
3

提交 Seedance 视频任务

视频任务仍围绕提示词、模型、时长、比例、分辨率等 Seedance 参数组织;人物素材会作为额外引用传入。正式请求结构以上线后的接口文档为准。
4

查询与下载结果

任务创建后继续使用任务 ID 查询状态。成功后可读取结果 URL,或通过兼容下载接口 /v1/videos/{id}/content 下载视频文件。

真人素材流程

真人素材适用于需要保持指定真人形象、动作风格或人物一致性的场景。上线后预计会包含以下步骤:
  1. 上传或提交真人素材。
  2. 完成真人授权与必要的认证流程。
  3. 等待素材进入可用状态。
  4. 在 Seedance 视频任务中引用该真人素材。
  5. 查询视频任务状态并下载结果。
当前不要把真人人脸图片或真人视频直接作为普通 image_url / video_url 输入用于真人一致性生成。真人素材能力需要等待兼容接口上线后再按专用流程调用。

虚拟人素材流程

虚拟人素材适用于数字人、品牌角色、虚拟主播、企业形象代言人等场景。上线后预计会包含以下步骤:
  1. 在虚拟人素材库选择已授权素材,或按平台流程创建虚拟人素材。
  2. 获取可用于视频任务的人物素材 ID。
  3. 在提示词中描述虚拟人的动作、镜头、台词或场景。
  4. 在 Seedance 视频任务中引用虚拟人素材 ID。
  5. 查询任务状态并下载结果。
虚拟人素材不等于绕过真人授权。基于真实人物创建的虚拟形象,仍需要满足肖像、声音、姓名、商标和相关授权要求。

真人 + 虚拟人组合

当一个视频同时需要真人素材和虚拟人素材时,预计会采用“多个已校验人物素材引用 + 同一个 Seedance 任务”的方式:
阶段真人素材虚拟人素材
前置校验真人授权、认证、素材状态素材库授权、素材状态
任务引用引用真人素材 ID引用虚拟人素材 ID
提示词控制描述真人动作、表情、镜头位置描述虚拟人动作、互动关系、场景
结果获取同一个任务 ID 查询和下载同一个任务 ID 查询和下载

接入准备建议

  • 业务侧先把真人授权、素材归属、虚拟人素材版权和使用范围整理清楚。
  • 客户端预留“素材创建 / 素材选择 / 素材状态查询 / 视频任务提交”的分步流程。
  • 不要在上线前写死未发布的字段名、接口路径或素材 ID 格式。
  • 上线后先在测试环境用短时长、低分辨率任务验证,再扩大到生产工作流。
该能力上线前,公开文档只保留流程说明。正式接口发布后,会在本页补充可调用接口、请求示例、响应字段、错误码和完整 Python 示例。