视频生成与人脸素材管理

本文档介绍如何使用椋鸟（Starlingdroid）视频生成服务，从素材管理到人脸视频生成的完整流程。涵盖云端素材组管理、本地参考素材配置，以及 Seedance 模型的参考生视频操作。

前置条件

开始之前，请确保：

• 已登录无限画布账号
• 管理员已开启素材管理功能，并在「系统设置」中配置了素材管理上游地址
• 你的账号已配置上游 API Key（管理员可在后台为用户配置）
• 本地直连或云端渠道已配置支持 Seedance 系列模型的 API Key 和 Base URL

如果你使用椋鸟提供的视频生成服务，请联系管理员获取专属 API Key 和接入地址。

第一步：配置视频生成渠道

人脸视频生成需要调用 Seedance 系列模型的 AI 接口。椋鸟提供视频生成服务，同时也支持直接配置火山方舟 Ark 接口。

本地直连模式

1. 点击画布或视频创作台右上角的「配置」按钮。
2. 选择「本地直连」渠道模式。
3. 填写 API Key 和 API 地址（Base URL）：
   • 椋鸟视频生成服务：https://sts.starlingdroid.com
   • 火山方舟 Ark：https://sts.starlingdroid.com/api/v3
   • API Key：对应平台提供的密钥（通常以 sk- 开头）
4. 点击「拉取模型」获取可用模型列表。
5. 选择 doubao-seedance 或 doubao-seedance-2-0 作为视频生成模型。
6. 点击「完成」保存配置。

实际调用链路说明

你填写的 Base URL 会被系统按规则拼接为完整的视频生成接口地址：

系统会自动识别你填写的 Base URL 是否已包含版本路径（/v1、/api/v3、/api/plan/v3），然后拼接正确的后缀。你只需填写基础地址即可。

注意：https://sts.starlingdroid.com/joycreator/openApi 是椋鸟素材管理 API，不是 AI 生成接口，请勿填入此处。如果你不清楚应该填什么地址，请联系管理员获取接入指引。

云端渠道模式

如果管理员已在后台配置了 Seedance 模型渠道，你无需手动配置 API Key，直接选择对应的云端渠道即可使用。

---

第二步：管理上游视频素材（云端素材组）

云端素材组用于管理上传到椋鸟素材库的视频、图片和音频素材。这些素材经过火山引擎预处理后，可在视频生成中以 asset:// 格式引用，实现人脸一致性控制。

2.1 进入素材管理

1. 点击左侧导航栏的「我的素材」。
2. 页面会出现「本地素材」和「云端素材组」两个 Tab。
3. 切换到「云端素材组」Tab。

如果提示「未配置云端素材 API Key」或「未配置上游服务地址」，请联系管理员完成配置。

2.2 创建素材组

1. 点击「新建素材组」按钮。
2. 输入素材组名称（1-64 字符，必填）。
3. 可选填写描述（0-300 字符）。
4. 点击确认创建。

创建成功后，左侧素材组列表会自动刷新，新素材组会出现在列表中。

2.3 上传含人脸的素材

1. 在左侧素材组列表中，选中一个素材组。
2. 点击右侧「上传素材」按钮。
3. 在弹窗中填写：
   • 素材 URL：公网可访问的 HTTP/HTTPS 地址（必须是直链，不支持 base64）
   • 素材类型：Image（人脸图片）、Video（参考视频）、Audio（参考音频）
   • 素材名称：用于展示和搜索（0-64 字符，可选）
4. 点击「上传」。

素材上传后会先显示为「处理中」状态，系统会自动轮询（每 3 秒刷新，最多 2 分钟），状态变为「可用」后即可用于视频生成。

2.4 素材规格要求

人脸素材建议：上传正面清晰、光线均匀的人脸图片，分辨率不低于 720p，背景干净，能获得最好的人脸一致性效果。

---

第三步：准备本地参考素材

除了云端素材组，你还可以直接上传本地图片、视频、音频作为参考素材。本地素材保存在浏览器本地存储中，无需等待云端预处理，即传即用。

3.1 上传本地素材

1. 在「我的素材」页面，保持在「本地素材」Tab。
2. 点击「上传素材」或将文件拖入页面。
3. 支持批量上传图片、视频、音频文件。
4. 上传完成后可直接在视频创作台或画布中使用。

3.2 本地素材与云端素材的区别

建议：需要多次复用的人脸素材务必上传到云端素材组；临时尝试可直接使用本地素材。

---

第四步：生成人脸视频

4.1 进入视频创作台

1. 点击顶部导航栏的「视频创作台」（/video）。
2. 确保右上角已配置好视频生成渠道和 Seedance 模型。

4.2 添加参考素材

视频创作台的参考图区域支持两种方式添加素材：

方式一：从云端素材库选择

1. 点击参考图区域的「从素材库选择」按钮。
2. 在下拉框中选择一个素材组。
3. 页面展示该组内状态为「可用」的素材卡片。
4. 点击目标素材（含人脸的图片或视频），素材会添加到参考图列表中。
5. 云端素材在列表中会显示预览图和素材名称。

方式二：上传本地素材

1. 直接将本地图片或视频拖入参考图区域。
2. 或点击「上传参考图」按钮选择本地文件。

Seedance 2.0 支持混合引用：云端素材（asset://）和本地素材可同时使用。

4.3 参考素材数量与场景触发

Seedance 会根据参考素材自动判断生成场景：

人脸视频生成的关键：上传 3 张及以上 含同一人脸的参考图片，系统会自动切换为参考生视频模式，确保生成视频中的人物与参考素材一致。

4.4 填写 Prompt

Prompt 中必须使用序号形式指代参考素材，格式为 图片1、视频1、音频1：

注意事项：

• ❌ 错误：asset-2026xxx 这个人物...（火山不会识别 Asset ID）
• ❌ 错误：素材库里的人物...（必须使用序号形式）
• ✅ 正确：图片1 中的人物...

4.5 设置生成参数

在视频配置面板中调整以下参数：

参数修改后会自动保存到本次生成配置中。

4.6 生成与下载

1. 确认 Prompt 和参数无误后，点击「生成视频」按钮。
2. 系统开始创建生成任务，页面显示进度状态。
3. 生成完成后，视频会出现在结果区域。
4. 点击「下载」保存视频到本地，或点击「保存到素材」存入本地素材库。

生成记录会自动保存，包括提示词、参考图、模型和参数。点击历史记录可快速回填本次配置。

---

第五步：在画布中生成人脸视频

除了在视频创作台，你也可以在无限画布中直接生成人脸视频：

1. 在画布中创建一个「视频生成配置节点」。
2. 将含有人脸素材的图片节点或视频节点连接到配置节点上游。
3. 打开配置节点的生成面板，配置参数与 Prompt。
4. 配置节点会自动识别上游素材并生成对应的序号引用（如 图片1）。
5. 点击「生成」按钮，生成的视频节点会自动出现在画布中，并与配置节点连线。

画布中 ≥3 张图片连接或存在视频/音频参考时，同样会自动触发 scene=reference 参考生视频模式。

---

常见问题

Q：云端素材一直显示「处理中」？

A：火山引擎预处理通常需要几秒到几分钟。系统会自动轮询，2 分钟后无论状态如何都会停止。如果超时后仍不是「可用」状态，建议点击素材卡片查看详情，根据错误信息调整素材规格后重新上传。

Q：生成时提示「当前模型不支持素材库引用」？

A：检查选中的云端素材是否有有效的预览 URL（vendorUrl）。只有状态为「可用」且 vendorUrl 不为空的素材才能被 Seedance 正确引用。

Q：人脸视频生成后人物不一致？

A：确保满足以下任一条件以触发参考生视频模式：

• 上传 3 张及以上 含同一人脸的参考图片
• 或包含视频/音频参考素材
• 检查 Prompt 中是否正确使用 图片1、视频1 等序号指代

Q：参考视频被判定包含真人或隐私信息？

A：Seedance 对参考视频有内容安全检测。建议改用：

• 不含真人出镜的参考视频
• 官方允许的模型产物作为参考
• 已授权的 asset:// 云端素材

Q：素材上传提示 URL 格式不正确？

A：云端素材上传只支持 HTTP/HTTPS 公网直链，不支持：

• base64 内联数据
• FTP 地址
• 内网地址
• 需要登录才能访问的链接

Q：拉取模型列表为空？

A：检查 API Key 是否有效、Base URL 是否可访问、以及该 Key 是否已开通 Seedance 模型权限。

---

素材规格速查表

---

相关文档

• 画布节点操作手册
• 我的素材与云端素材组管理（如已发布）