Seedance素材库用户使用说明

目前系统会在视频生成链路中自动处理大多数人脸素材，通常不需要手动调用素材库管理相关接口。

建议优先按普通视频生成方式直接提交图片或视频素材，让系统自动处理。若生成失败、素材不可用或提示需要入库，再尝试上传到普通素材目录；如果仍失败，或素材涉及公众人物、演员、网红、主播等具有较高辨识度或商业使用风险的人脸，再使用真人目录并走扫码授权流程。

使用流程概述

Seedance素材库用于在自动处理无法满足要求时，手动入库并引用可信素材。多数情况下，用户可以先直接调用视频生成接口；只有当直接生成失败、素材不可用或需要明确授权时，才需要按下方流程手动创建素材目录、上传素材，并在审核通过后使用内部素材 URI。

推荐流程如下：

Step 0. 直接生成
  -> 直接在视频生成请求中传入普通图片/视频 URL
  -> 系统会自动处理大多数人脸素材

Step 1. 普通素材目录兜底
  -> 如果直接生成失败、素材不可用或提示需要入库，先创建普通目录并上传素材
  -> 素人或普通个人素材优先尝试普通目录

Step 2. 真人扫码授权兜底
  -> 如果普通素材目录仍失败，或素材涉及公众人物、演员、网红、主播等
  -> 创建真人目录，按认证链接或二维码完成扫码授权
  -> 授权通过后上传素材并获得素材 URI

Step 3. 使用入库素材生成视频
  -> 在视频生成请求中使用 asset://na_asset_xxx 引用素材
  -> Prompt 中用“图片1”“图片2”等顺序描述素材

使用前准备

使用前请确认：

您已获得平台分配的用户账号或用户令牌。

您的账号已开通可用的视频模型。

素材 URL 必须能被平台服务端公网访问。

一般情况下，不需要手动创建素材目录；请先直接调用视频生成接口。

普通目录不需要扫码认证。直接生成失败后，素人或普通个人素材可优先尝试普通目录。

公众人物、演员、网红、主播等具有较高辨识度或商业使用风险的真人人脸素材，建议确认授权并直接使用真人目录完成扫码授权。

真人目录需要本人完成认证；认证未通过的素材目录不能上传素材。

用户令牌调用接口时，使用以下任一鉴权方式：

或：

Step 0. 直接使用普通素材生成

多数场景下，您不需要先调用素材库接口。可以直接在视频生成请求中传入图片或视频 URL：

{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "图片1中的人物自然微笑，镜头缓慢推进，背景为明亮的室内空间。",
  "image": "https://example.com/person.png",
  "resolution": "720p",
  "duration": 5,
  "metadata": {
    "ratio": "9:16",
    "generate_audio": true
  }
}

如果该方式可以成功生成视频，就不需要创建素材目录，也不需要上传素材。

当出现以下情况时，再继续使用素材库：

生成失败，错误提示素材不可用。

素材审核未通过或被要求入库。

需要在多次生成中稳定复用同一素材。

涉及公众人物、演员、网红、主播等需要明确授权的人脸素材。

Step 1. 创建素材目录

素材目录用于归档同一人物、同一虚拟形象或同一业务对象下的素材。

控制台操作

进入控制台的素材库页面。

点击新建素材目录。

选择目录类型：

普通目录：直接生成失败后，素人或普通个人素材可优先选择。不需要真人认证，创建后通常即可上传素材。

真人目录：公众人物、演员、网红、主播等素材建议直接选择；普通目录生成失败、模型返回素材不可用，或业务明确要求真人授权时也应选择。需要本人完成真人认证。

填写素材目录名称并提交。

如果返回认证链接或二维码，请由本人打开链接或扫码完成认证。

API 调用

请求示例：

{
  "kind": "real",
  "name": "本人形象"
}

字段说明：

字段	必填	说明
`kind`	是	`real` 表示真人目录，`virtual` 表示普通目录
`name`	是	素材目录名称，建议填写便于识别的名称

响应示例：

{
  "success": true,
  "data": {
    "id": "na_folder_xxxxx",
    "kind": "real",
    "name": "本人形象",
    "verify_status": "pending",
    "h5_link": "https://example.com/verify",
    "created_time": 1780666000,
    "updated_time": 1780666000
  }
}

Step 2. 查看素材目录状态

如果素材目录需要认证，完成认证后可刷新目录详情查看最新状态。

认证状态说明：

状态	中文含义	是否可上传素材
`pending`	待认证	否
`reviewing`	审核中	否
`approved`	已通过	是
`rejected`	已拒绝	否
`failed`	失败	否
`needs_reverify`	需重新认证	否

只有当素材目录状态为 approved 时，才可以继续上传素材。

Step 3. 上传素材

素材目录可用后，可以上传素材。上传后系统会进行异步处理，处理通过后素材才可以用于视频生成。

素材建议

图片素材建议使用清晰、主体明确、无遮挡的图片。

素人或普通个人真人人脸素材建议先直接调用视频生成接口；如果生成失败，再上传到普通目录并尝试生成视频；如果普通目录仍失败、素材被拒绝，或返回需要真人认证的提示，再创建真人目录并按二维码/认证链接完成本人授权。

公众人物、演员、网红、主播等具有较高辨识度或商业使用风险的人脸素材，建议先确认授权，并直接使用真人目录完成扫码授权。

真人目录素材应与认证本人一致。

避免多人合照、严重遮挡、过度美颜、低清晰度图片。

素材 URL 必须可公网访问。

API 调用

请求示例：

{
  "folder_id": "na_folder_xxxxx",
  "url": "https://example.com/material.png",
  "type": "Image",
  "name": "正面形象"
}

字段说明：

字段	必填	说明
`folder_id`	是	素材目录 ID
`url`	是	公网可访问的素材 URL
`type`	否	素材类型，支持 `Image`、`Video`、`Audio`，默认 `Image`
`name`	否	素材名称，便于管理

响应示例：

{
  "success": true,
  "data": {
    "id": "na_asset_xxxxx",
    "folder_id": "na_folder_xxxxx",
    "name": "正面形象",
    "type": "Image",
    "url": "https://example.com/material.png",
    "verify_status": "reviewing",
    "asset_id": "na_asset_xxxxx",
    "asset_uri": "asset://na_asset_xxxxx",
    "created_time": 1780666000,
    "updated_time": 1780666000
  }
}

Step 4. 查看或刷新素材状态

查询素材目录下的素材：

刷新单个素材状态：

素材状态说明：

状态	中文含义	是否可用于视频生成
`reviewing`	审核中	否
`approved`	已通过	是
`rejected`	已拒绝	否
`failed`	失败	否
`needs_reupload`	需重新上传	否

只有当素材状态为 approved 时，才能使用 asset_uri 生成视频。

Step 5. 使用素材生成视频

素材审核通过后，在视频生成请求中使用素材 URI：

asset://na_asset_xxxxx

OpenAI 风格视频接口示例：

{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "图片1中的男孩露出自然微笑，镜头缓慢推进，背景为明亮的室内空间。",
  "image": "asset://na_asset_xxxxx",
  "resolution": "720p",
  "duration": 5,
  "metadata": {
    "ratio": "9:16",
    "generate_audio": true
  }
}

使用提示：

Prompt 中请用“图片1”“图片2”等顺序描述参考素材。

不要在 Prompt 文本里直接填写素材 ID。

多个素材同时使用时，请确保这些素材都属于当前用户且状态均为 approved。

如果直接生成失败，请先尝试普通素材目录；如果普通目录中的素人人脸素材仍生成失败，请不要反复提交同一素材，建议改用真人目录，完成扫码授权后重新上传同一人物素材再生成。

公众人物、演员等素材不建议先用普通目录试错，应优先走真人目录授权流程。

删除素材或素材目录

删除素材：

删除素材目录：

注意：

删除素材后，该素材 URI 将不能继续用于视频生成。

删除操作不可恢复，请谨慎操作。

Seedance人像素材用户使用说明

Seedance素材库用户使用说明#

使用流程概述#

使用前准备#

Step 0. 直接使用普通素材生成#

Step 1. 创建素材目录#

控制台操作#

API 调用#

Step 2. 查看素材目录状态#

Step 3. 上传素材#

素材建议#

API 调用#

Step 4. 查看或刷新素材状态#

Step 5. 使用素材生成视频#

删除素材或素材目录#

Seedance素材库用户使用说明

使用流程概述

使用前准备

Step 0. 直接使用普通素材生成

Step 1. 创建素材目录

控制台操作

API 调用

Step 2. 查看素材目录状态

Step 3. 上传素材

素材建议

API 调用

Step 4. 查看或刷新素材状态

Step 5. 使用素材生成视频

删除素材或素材目录