seedance 2.0 系列模型（包括 seedance 2.0 和 seedance 2.0 fast ）支持图像、视频、音频、文本等多种模态内容输入，具备视频生成、视频编辑、视频延长等能力，可高精度还原物品细节、音色、效果、风格、运镜等，保持稳定角色特征，赋予使用者如同导演般的掌控权。本文介绍 seedance 2.0 系列模型的专属能力，帮助您快速实现 [Video Generation API](https://www.volcengine.com/docs/82379/1520758) 调用。
:::tip
请确保您的账户余额大于等于 200 元（[前往充值](https://console.volcengine.com/finance/fund/recharge)），或已[购买资源包](https://console.volcengine.com/common-buy/fast/ark_bd%7C%7Cd682ppeeq1mp7kd5q0e0)，否则无法开通 seedance 2.0 及 seedance 2.0 fast 模型。
:::
# 新手入门
本入门教程专为 **API 新手用户** 设计，帮助您一键搭建 Python 开发环境、完成虚拟环境创建和方舟 SDK 安装，并提供直接可运行的 seedance 2.0 示例代码，您只需修改对应的输入素材，即可开始您的视频生成创作。
**1. 准备工作**
在开始之前，请确保您已经完成以下准备：
1. **注册账号**：确保您拥有火山引擎账号并已[登录](https://console.volcengine.com/)。
2. **获取 API Key**：访问 [API Key 管理页面](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey)，点击 **创建 API Key**，并复制保存您的 API Key。注意请妥善保管您的 API Key，不要泄露给他人。
3. [开通模型](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=model&projectName=default&tab=ComputerVision)：请确保您的账户余额大于等于 200 元，否则无法开通 seedance 2.0 及 seedance 2.0 fast 模型。
4. **下载并解压文件**：点击下载下方附件，将其解压到您的本地目录（如桌面或“下载”文件夹）。
**2.操作步骤**
```mixin-react
return (
);
```
**3.运行说明**
运行脚本后，您将看到如下流程：
1. **API Key 校验**：脚本会自动检测您本地是否配置了`ARK_API_KEY`环境变量。如果没有，会提示您手动输入。
2. **素材预览**：脚本会自动在您的默认浏览器中弹出一个本地生成的 HTML 页面，直观地展示本次任务的文本提示词、待替换的参考图片以及原始参考视频。
3. **任务创建与轮询**：脚本向火山方舟服务器发起异步请求。由于视频生成需要一定时间，控制台会每隔 30 秒打印一次任务状态（如 `running`等）。
4. **获取结果**：任务成功后，控制台会输出一段最终生成的视频 URL。您可以复制该链接到浏览器下载或在线播放。
**4.下一步**
在成功跑通本示例后，您可以尝试修改 `python/demo_standard.py`，来打造您专属的视频生成任务：
1. 修改文本提示词
找到代码中的 `user_content` 变量，更改为您想要的画面描述。
2. 替换输入素材 (图片、视频、音频)
您可以将 `reference_image_url`、`reference_video_url` 和 `reference_audio_url` 替换为您自己的素材链接。
**注意**：请确保 URL 是公网可公开访问的链接（建议存放在 TOS 对象存储服务中，并配置为公共读）。
3. 继续学习下文中丰富的使用示例。
# 模型能力
seedance 2.0 fast 和 seedance 2.0 的模型能力相同。追求最高生成品质，推荐使用 seedance 2.0；更注重成本与生成速度，不要求极限品质，推荐使用 seedance 2.0 fast。
|模型名称 | |[seedance 2.0](https://console.volcengine.com/ark/region:ark+cn-beijing/model/detail?Id=doubao-seedance-2-0&projectName=default) |[seedance 2.0 fast](https://console.volcengine.com/ark/region:ark+cn-beijing/model/detail?Id=doubao-seedance-2-0-fast&projectName=default) |
|---|---|---|---|
|Model ID | |doubao\-seedance\-2\-0\-260128 |doubao\-seedance\-2\-0\-fast\-260128 |
|文生视频 | | | |
|图生视频\-首帧 | | | |
|图生视频\-首尾帧 | | | |
|多模态参考【New】 |图片参考 | | |
|^^|视频参考 | | |
|^^|组合参考| | |\
| || | |\
| |* 图片 + 音频| | |\
| |* 图片 + 视频| | |\
| |* 视频 + 音频| | |\
| |* 图片 + 视频 + 音频 | | |
|编辑视频【New】 | | | |
|延长视频【New】 | | | |
|生成有声视频 | | | |
|联网搜索增强【New】 | | | |
|样片模式 | | | |
|返回视频尾帧 | | | |
|输出视频规格 |输出分辨率 |480p, 720p |480p, 720p |
| |输出宽高比 |21:9, 16:9, 4:3, 1:1, 3:4, 9:16 ||
| |输出时长 |4~15 秒 |4~15 秒 |
| |输出视频格式 |mp4 |mp4 |
|离线推理 | | | |
|在线推理限流 |最大 RPM |企业用户：600|企业用户：600|\
| | |个人用户：180 |个人用户：180 |
| |最大并发数 |企业用户：10|企业用户：10|\
| | |个人用户：3 |个人用户：3 |
|离线推理限流 |TPD |\- |\- |
# 基础使用
## 多模态参考
输入文本、参考图、视频（可带音轨）和音频等内容，来生成一段新视频。可继承参考图片的角色形象、视觉风格、画面构图；参考视频的主体内容、运镜方式、动作表现、整体风格；以及参考音频的音色、音乐旋律、对话内容等核心信息。
效果预览如下（访问[模型卡片](https://console.volcengine.com/ark/region:ark+cn-beijing/model/detail?Id=doubao-seedance-2-0)查看更多示例）：
|输入：文本 |输入：图片、视频、音频 |输出 |
|---|---|---|
|全程使用**视频1**的第一视角构图，全程使用**音频1**作为背景音乐。第一人称视角果茶宣传广告，seedance牌「苹苹安安」苹果果茶限定款；首帧为**图片1**，你的手摘下一颗带晨露的阿克苏红苹果，轻脆的苹果碰撞声；2\-4 秒：快速切镜，你的手将苹果块投入雪克杯，加入冰块与茶底，用力摇晃，冰块碰撞声与摇晃声卡点轻快鼓点，背景音：「鲜切现摇」；4\-6 秒：第一人称成品特写，分层果茶倒入透明杯，你的手轻挤奶盖在顶部铺展，在杯身贴上粉红包标，镜头拉近看奶盖与果茶的分层纹理；6\-8 秒：第一人称手持举杯，你将**图片2**中的果茶举到镜头前（模拟递到观众面前的视角），杯身标签清晰可见，背景音「来一口鲜爽」，尾帧定格为**图片2**。背景声音统一为女生音色。 |||\
| || |\
| | | |
```mixin-react
return (
contents = new ArrayList<>();
// 1. Text prompt
contents.add(Content.builder()
.type("text")
.text(prompt)
.build());
// 2. Reference image 1
contents.add(Content.builder()
.type("image_url")
.imageUrl(CreateContentGenerationTaskRequest.ImageUrl.builder()
.url(refImage1)
.build())
.role("reference_image")
.build());
// 3. Reference image 2
contents.add(Content.builder()
.type("image_url")
.imageUrl(CreateContentGenerationTaskRequest.ImageUrl.builder()
.url(refImage2)
.build())
.role("reference_image")
.build());
// 4. Reference video
contents.add(Content.builder()
.type("video_url")
.videoUrl(CreateContentGenerationTaskRequest.VideoUrl.builder()
.url(refVideo)
.build())
.role("reference_video")
.build());
// 5. Reference audio
contents.add(Content.builder()
.type("audio_url")
.audioUrl(CreateContentGenerationTaskRequest.AudioUrl.builder()
.url(refAudio)
.build())
.role("reference_audio")
.build());
// Create video generation task
CreateContentGenerationTaskRequest createRequest = CreateContentGenerationTaskRequest.builder()
.generateAudio(generateAudio)
.model(modelId)
.content(contents)
.ratio(videoRatio)
.duration(videoDuration)
.watermark(showWatermark)
.build();
CreateContentGenerationTaskResult createResult = service.createContentGenerationTask(createRequest);
System.out.println("Task Created: " + createResult);
// Get task details and poll status
String taskId = createResult.getId();
pollTaskStatus(taskId);
\}
/**
* Poll task status
* @param taskId Task ID
*/
private static void pollTaskStatus(String taskId) \{
GetContentGenerationTaskRequest getRequest = GetContentGenerationTaskRequest.builder()
.taskId(taskId)
.build();
System.out.println("----- polling task status -----");
try \{
while (true) \{
GetContentGenerationTaskResponse getResponse = service.getContentGenerationTask(getRequest);
String status = getResponse.getStatus();
if ("succeeded".equalsIgnoreCase(status)) \{
System.out.println("----- task succeeded -----");
System.out.println(getResponse);
break;
\} else if ("failed".equalsIgnoreCase(status)) \{
System.out.println("----- task failed -----");
if (getResponse.getError() != null) \{
System.out.println("Error: " + getResponse.getError().getMessage());
\}
break;
\} else \{
System.out.printf("Current status: %s, Retrying in 10 seconds...%n", status);
TimeUnit.SECONDS.sleep(10);
\}
\}
\} catch (InterruptedException ie) \{
Thread.currentThread().interrupt();
System.err.println("Polling interrupted");
\} catch (Exception e) \{
System.err.println("Error occurred: " + e.getMessage());
\} finally \{
service.shutdownExecutor();
\}
\}
\}
\`\`\`
`}>
);
```
:::tip
* 您可任意组合以下模态内容，注意不支持“文本+音频”、“纯音频” 输入。
* 文本
* 图片：0~9 张
* 视频：0~3 个
* 音频：0~3 个
* **进阶用法**：多模态生视频可通过提示词指定参考图片作为首帧/尾帧，间接实现“首尾帧+多模态参考”效果。若需严格保障首尾帧和指定图片一致，**优先使用图生视频\-首尾帧**（配置 role 为 first_frame/last_frame）。
* 各个模态信息输入要求参见[多模态输入](/docs/82379/1366799#63a97f09)。
:::
## 编辑视频
您可以提供待编辑的视频、参考图片或音频，并结合使用提示词，完成多种视频编辑任务，例如：替换视频主体、视频中对象增删改、局部画面重绘/修复等。
效果预览如下（访问[模型卡片](https://console.volcengine.com/ark/region:ark+cn-beijing/model/detail?Id=doubao-seedance-2-0)查看更多示例）：
|输入：文本 |输入：视频&图片 |输出 |
|---|---|---|
|将**视频1**礼盒中的香水替换成**图像1**中的面霜，运镜不变 |||\
| || |\
| | | |
```mixin-react
return (
contents = new ArrayList<>();
// 1. Text prompt
contents.add(Content.builder()
.type("text")
.text(prompt)
.build());
// 2. Reference image 1
contents.add(Content.builder()
.type("image_url")
.imageUrl(CreateContentGenerationTaskRequest.ImageUrl.builder()
.url(refImage1)
.build())
.role("reference_image")
.build());
// 3. Reference video
contents.add(Content.builder()
.type("video_url")
.videoUrl(CreateContentGenerationTaskRequest.VideoUrl.builder()
.url(refVideo)
.build())
.role("reference_video")
.build());
// Create video generation task
CreateContentGenerationTaskRequest createRequest = CreateContentGenerationTaskRequest.builder()
.generateAudio(generateAudio)
.model(modelId)
.content(contents)
.ratio(videoRatio)
.duration(videoDuration)
.watermark(showWatermark)
.build();
CreateContentGenerationTaskResult createResult = service.createContentGenerationTask(createRequest);
System.out.println("Task Created: " + createResult);
// Get task details and poll status
String taskId = createResult.getId();
pollTaskStatus(taskId);
\}
/**
* Poll task status
* @param taskId Task ID
*/
private static void pollTaskStatus(String taskId) \{
GetContentGenerationTaskRequest getRequest = GetContentGenerationTaskRequest.builder()
.taskId(taskId)
.build();
System.out.println("----- polling task status -----");
try \{
while (true) \{
GetContentGenerationTaskResponse getResponse = service.getContentGenerationTask(getRequest);
String status = getResponse.getStatus();
if ("succeeded".equalsIgnoreCase(status)) \{
System.out.println("----- task succeeded -----");
System.out.println(getResponse);
break;
\} else if ("failed".equalsIgnoreCase(status)) \{
System.out.println("----- task failed -----");
if (getResponse.getError() != null) \{
System.out.println("Error: " + getResponse.getError().getMessage());
\}
break;
\} else \{
System.out.printf("Current status: %s, Retrying in 10 seconds...%n", status);
TimeUnit.SECONDS.sleep(10);
\}
\}
\} catch (InterruptedException ie) \{
Thread.currentThread().interrupt();
System.err.println("Polling interrupted");
\} catch (Exception e) \{
System.err.println("Error occurred: " + e.getMessage());
\} finally \{
service.shutdownExecutor();
\}
\}
\}
\`\`\`
`}>
);
```
## 延长视频
在原有视频基础上，向前或者向后延长视频，或多个视频片段（最多 3 个视频片段）串联成一个连贯视频。
效果预览如下（访问[模型卡片](https://console.volcengine.com/ark/region:ark+cn-beijing/model/detail?Id=doubao-seedance-2-0)查看更多示例）：
|输入：文本 |输入：待延长视频 |输出 |
|---|---|---|
|**视频1**中的拱形窗户打开，进入美术馆室内，接**视频2**，之后镜头进入画内，接**视频3** |||\
| || |\
| || |\
| || |\
| || |\
| | | |
```mixin-react
return (
contents = new ArrayList<>();
// 1. Text prompt
contents.add(Content.builder()
.type("text")
.text(prompt)
.build());
// 2. Reference video 1
contents.add(Content.builder()
.type("video_url")
.videoUrl(CreateContentGenerationTaskRequest.VideoUrl.builder()
.url(refVideo1)
.build())
.role("reference_video")
.build());
// 3. Reference video 2
contents.add(Content.builder()
.type("video_url")
.videoUrl(CreateContentGenerationTaskRequest.VideoUrl.builder()
.url(refVideo2)
.build())
.role("reference_video")
.build());
// 4. Reference video 3
contents.add(Content.builder()
.type("video_url")
.videoUrl(CreateContentGenerationTaskRequest.VideoUrl.builder()
.url(refVideo3)
.build())
.role("reference_video")
.build());
// Create video generation task
CreateContentGenerationTaskRequest createRequest = CreateContentGenerationTaskRequest.builder()
.generateAudio(generateAudio)
.model(modelId)
.content(contents)
.ratio(videoRatio)
.duration(videoDuration)
.watermark(showWatermark)
.build();
CreateContentGenerationTaskResult createResult = service.createContentGenerationTask(createRequest);
System.out.println("Task Created: " + createResult);
// Get task details and poll status
String taskId = createResult.getId();
pollTaskStatus(taskId);
\}
/**
* Poll task status
* @param taskId Task ID
*/
private static void pollTaskStatus(String taskId) \{
GetContentGenerationTaskRequest getRequest = GetContentGenerationTaskRequest.builder()
.taskId(taskId)
.build();
System.out.println("----- polling task status -----");
try \{
while (true) \{
GetContentGenerationTaskResponse getResponse = service.getContentGenerationTask(getRequest);
String status = getResponse.getStatus();
if ("succeeded".equalsIgnoreCase(status)) \{
System.out.println("----- task succeeded -----");
System.out.println(getResponse);
break;
\} else if ("failed".equalsIgnoreCase(status)) \{
System.out.println("----- task failed -----");
if (getResponse.getError() != null) \{
System.out.println("Error: " + getResponse.getError().getMessage());
\}
break;
\} else \{
System.out.printf("Current status: %s, Retrying in 10 seconds...%n", status);
TimeUnit.SECONDS.sleep(10);
\}
\}
\} catch (InterruptedException ie) \{
Thread.currentThread().interrupt();
System.err.println("Polling interrupted");
\} catch (Exception e) \{
System.err.println("Error occurred: " + e.getMessage());
\} finally \{
service.shutdownExecutor();
\}
\}
\}
\`\`\`
`}>
);
```
:::tip
* 向前或向后延长 1 段视频，生成的视频一般只包含原视频的尾部画面。但您也可以通过提示词灵活控制，使其包含原视频内容。 例如：向前延长视频1，[延长内容描述...]，**最后接视频1**。
* 传入 2~3 段视频，补全中间过渡部分，生成的视频会包含原视频内容和新生成的视频内容。
:::
## 使用联网搜索
> 联网搜索能力仅适用于纯文本输入
seedance 2.0 新增支持调用联网搜索工具，通过配置 tools.**type** 参数为 web_search 即可开启联网搜索。
* 开启联网搜索后，模型会根据用户的提示词自主判断是否搜索互联网内容（如商品、天气等）。可提升生成视频的时效性，但也会增加一定的时延。
* 实际搜索次数可通过 [查询视频生成任务 API](https://www.volcengine.com/docs/82379/1521309?lang=zh) 返回的 usage.tool_usage.**web_search** 字段获取，如果为 0 表示未搜索。
|输入：文本 |输出 |
|---|---|
|微距镜头对准叶片上翠绿的玻璃蛙。焦点逐渐从它光滑的皮肤，转移到它完全透明的腹部，一颗鲜红的心脏正在有力地、规律地收缩扩张。||\
|:::tip| |\
|联网搜索玻璃蛙的容貌特征。| |\
|| |\
|:::| |
```mixin-react
return (
contents = new ArrayList<>();
// text prompt
contents.add(Content.builder()
.type("text")
.text(prompt)
.build());
// Create a video generation task
CreateContentGenerationTaskRequest createRequest = CreateContentGenerationTaskRequest.builder()
.model(modelId)
.content(contents)
.generateAudio(generateAudio)
.ratio(videoRatio)
.duration(videoDuration)
.watermark(showWatermark)
.tools(Collections.singletonList(webSearchTool))
.build();
CreateContentGenerationTaskResult createResult = service.createContentGenerationTask(createRequest);
System.out.println(createResult);
// Get the details of the task
String taskId = createResult.getId();
GetContentGenerationTaskRequest getRequest = GetContentGenerationTaskRequest.builder()
.taskId(taskId)
.build();
// Polling query section
System.out.println("----- polling task status -----");
while (true) \{
try \{
GetContentGenerationTaskResponse getResponse = service.getContentGenerationTask(getRequest);
String status = getResponse.getStatus();
if ("succeeded".equalsIgnoreCase(status)) \{
System.out.println("----- task succeeded -----");
System.out.println(getResponse);
break;
\} else if ("failed".equalsIgnoreCase(status)) \{
System.out.println("----- task failed -----");
System.out.println("Error: " + getResponse.getStatus());
break;
\} else \{
System.out.printf("Current status: %s, Retrying in 10 seconds...", status);
TimeUnit.SECONDS.sleep(10);
\}
\} catch (InterruptedException ie) \{
Thread.currentThread().interrupt();
System.err.println("Polling interrupted");
break;
\}
\}
\}
\}
\`\`\`
`}>
);
```
## 更多能力
seedance 2.0 系列模型也支持文生视频、首帧图生视频、首尾帧图生视频、设置视频输出规格等通用基础能力，详情请参见 [视频生成教程-wip](/docs/82379/2298881)。
# 便利创作
seedance 2.0 系列模型不支持直接上传含有真人人脸的参考图/视频。为便利创作者使用肖像，平台推出了以下解决方案。
|方案 |介绍 |
|---|---|
|[使用虚拟人像](/docs/82379/2291680#2bf01416) |平台预置虚拟人像库，为创作者提供免费、合规、丰富多样的肖像素材。适用于需真人风格人脸但无需指定具体人物，追求零合规风险、快速创作的场景。 |
|[使用已授权真人素材](/docs/82379/2291680#f952d0c3) |支持使用已获得授权的真人肖像素材进行视频生成。 |
|[使用模型产物进行二创](/docs/82379/2291680#86c3831f) |本账号下部分模型生成的含人脸原始产物可作为输入素材，再次调用 seedance 2.0 系列模型进行二次创作，不会触发审核拦截。 |
## 使用虚拟人像
对写实风格视频，可通过虚拟人像库预置人像来控制角色样貌。每个素材对应一个独立素材 ID (asset ID)， 在 **content.<模态\>_url.url** 字段中传入 `asset://` 即可生成视频。浏览及检索虚拟人像请参见[虚拟人像库](/docs/82379/2223965)。
|输入：文本 |输入：虚拟人像、图片 |输出 |
|---|---|---|
|固定机位，近景镜头，清新自然风格。在室内自然光下，**图片1**中美妆博主面带笑容，向镜头介绍**图片2**中的面霜。博主将手里的面霜展示给镜头，开心地说“挖到本命面霜了！”；接着她一边用手指轻轻蘸取面霜展示那种软糯感，一边说“质地像云朵一样软糯，一抹就吸收”；最后她把面霜涂抹在脸颊上，展示着水润透亮的皮肤，同时自信地说“熬夜急救、补水保湿全搞定”。要求画面中人物居中，完整展示人物的整个脑袋和上半身，始终对焦人脸，人脸始终清晰，纯净无任何字幕。| ||\
|:::warning|> 虚拟人像| |\
|Asset ID 仅用来向模型传入素材，提示词中仍需使用"**素材类型+序号**”格式引用素材，序号为请求体中该素材在同类素材中的排序。|| |\
|正确用法：**图片1**中美妆博主| | |\
|错误用法：asset\-2026\*\*\*\*是美妆博主|> 产品图像 | |\
|| | |\
|:::| | |
```mixin-react
return (
contents = new ArrayList<>();
// 1. Text prompt
contents.add(Content.builder()
.type("text")
.text(prompt)
.build());
// 2. Reference image 1
contents.add(Content.builder()
.type("image_url")
.imageUrl(CreateContentGenerationTaskRequest.ImageUrl.builder()
.url(refImage1)
.build())
.role("reference_image")
.build());
// 3. Reference image 2
contents.add(Content.builder()
.type("image_url")
.imageUrl(CreateContentGenerationTaskRequest.ImageUrl.builder()
.url(refImage2)
.build())
.role("reference_image")
.build());
// Create video generation task
CreateContentGenerationTaskRequest createRequest = CreateContentGenerationTaskRequest.builder()
.generateAudio(generateAudio)
.model(modelId)
.content(contents)
.ratio(videoRatio)
.duration(videoDuration)
.watermark(showWatermark)
.build();
CreateContentGenerationTaskResult createResult = service.createContentGenerationTask(createRequest);
System.out.println("Task Created: " + createResult);
// Get task details and poll status
String taskId = createResult.getId();
pollTaskStatus(taskId);
\}
/**
* Poll task status
* @param taskId Task ID
*/
private static void pollTaskStatus(String taskId) \{
GetContentGenerationTaskRequest getRequest = GetContentGenerationTaskRequest.builder()
.taskId(taskId)
.build();
System.out.println("----- polling task status -----");
try \{
while (true) \{
GetContentGenerationTaskResponse getResponse = service.getContentGenerationTask(getRequest);
String status = getResponse.getStatus();
if ("succeeded".equalsIgnoreCase(status)) \{
System.out.println("----- task succeeded -----");
System.out.println(getResponse);
break;
\} else if ("failed".equalsIgnoreCase(status)) \{
System.out.println("----- task failed -----");
if (getResponse.getError() != null) \{
System.out.println("Error: " + getResponse.getError().getMessage());
\}
break;
\} else \{
System.out.printf("Current status: %s, Retrying in 10 seconds...%n", status);
TimeUnit.SECONDS.sleep(10);
\}
\}
\} catch (InterruptedException ie) \{
Thread.currentThread().interrupt();
System.err.println("Polling interrupted");
\} catch (Exception e) \{
System.err.println("Error occurred: " + e.getMessage());
\} finally \{
service.shutdownExecutor();
\}
\}
\}
\`\`\`
`}>
);
```
## 使用已授权真人素材
通过真人认证和本人授权后，可将该真人的相关素材（例如该真人的图片、视频、音频）上传至方舟。素材入库成功后，每个素材将获得一个独立素材 ID (asset ID)， 在 **content.<模态\>_url.url** 字段中传入 `asset://`即可使用该素材生成视频。真人认证及素材入库流程请参见[录入真人形象素材](/docs/82379/2315856)。
```Shell
...
"content": [
{
"type": "text",
"text": ""
},
{
"type": "image_url",
"image_url": {
"url": "asset://"
},
"role": "reference_image"
},
{
"type": "video_url",
"video_url": {
"url": "asset://"
},
"role": "reference_video"
},
{
"type": "audio_url",
"audio_url": {
"url": "asset://"
},
"role": "reference_audio"
}
]
...
```
## 使用模型产物进行二创
seedance 2.0 系列模型不支持直接上传含有真人人脸的参考图/视频。为了便利创作者在含人脸场景的二次创作需求，方舟平台信任以下模型生成的含人脸产物，您可使用**本账号下近30天内由以下模型生成的含人脸原始产物**，作为输入素材，再次调用 seedance 2.0 系列模型进行二次创作。
|信任产物范围 |生效时间|有效期|\
| |> 信任该时间之后|> 从产物生成时间|\
| |> 生成的产物 |> 开始计算 |
|---|---|---|
|seedance 2.0 及 2.0 fast 生成的含人脸视频 |2026年03月11日起 |30天 |
|seedance 2.0 及 2.0 fast 生成的含人脸视频对应的尾帧图片 |2026年04月16日起 |30天 |
|[Seedream 5.0 lite 文生图](https://www.volcengine.com/docs/82379/1824121?lang=zh#9695d195)得到的含人脸图片 |2026年04月16日起 |30天 |
:::warning
* 对于含人脸场景，方舟平台仅信任模型原始产物，二次剪辑或超过有效期后均不可使用。
* 对于不含人脸场景，模型产物不存在受信问题，支持自由剪辑后进行二次创作。
:::
|输入：同账号生成的视频 |输出 |
|---|---|
|||\
|||\
|> [使用虚拟人像](/docs/82379/2291680#2bf01416)示例生成的视频 |> 输入：将面霜的颜色修改为白色。|\
| |> ratio 修改为16:9 |
```mixin-react
return (
contents = new ArrayList<>();
// 1. Text prompt
contents.add(Content.builder()
.type("text")
.text(prompt)
.build());
// 2. Reference video
contents.add(Content.builder()
.type("video_url")
.videoUrl(CreateContentGenerationTaskRequest.VideoUrl.builder()
.url(refVideo)
.build())
.role("reference_video")
.build());
// Create video generation task
CreateContentGenerationTaskRequest createRequest = CreateContentGenerationTaskRequest.builder()
.generateAudio(generateAudio)
.model(modelId)
.content(contents)
.ratio(videoRatio)
.duration(videoDuration)
.watermark(showWatermark)
.build();
CreateContentGenerationTaskResult createResult = service.createContentGenerationTask(createRequest);
System.out.println("Task Created: " + createResult);
// Get task details and poll status
String taskId = createResult.getId();
pollTaskStatus(taskId);
\}
/**
* Poll task status
* @param taskId Task ID
*/
private static void pollTaskStatus(String taskId) \{
GetContentGenerationTaskRequest getRequest = GetContentGenerationTaskRequest.builder()
.taskId(taskId)
.build();
System.out.println("----- polling task status -----");
try \{
while (true) \{
GetContentGenerationTaskResponse getResponse = service.getContentGenerationTask(getRequest);
String status = getResponse.getStatus();
if ("succeeded".equalsIgnoreCase(status)) \{
System.out.println("----- task succeeded -----");
System.out.println(getResponse);
break;
\} else if ("failed".equalsIgnoreCase(status)) \{
System.out.println("----- task failed -----");
if (getResponse.getError() != null) \{
System.out.println("Error: " + getResponse.getError().getMessage());
\}
break;
\} else \{
System.out.printf("Current status: %s, Retrying in 10 seconds...%n", status);
TimeUnit.SECONDS.sleep(10);
\}
\}
\} catch (InterruptedException ie) \{
Thread.currentThread().interrupt();
System.err.println("Polling interrupted");
\} catch (Exception e) \{
System.err.println("Error occurred: " + e.getMessage());
\} finally \{
service.shutdownExecutor();
\}
\}
\}
\`\`\`
`}>
);
```
# 提示词技巧
提示词中必须使用"**素材类型+序号**”格式引用素材，序号为请求体中该素材在同类素材中的排序。例如 「图片 n」指代`content`数组中第 n 个`type="image_url"`的参考图片（按数组顺序从1开始计数）。**注意不支持使用 Asset ID 指代素材。**
下文介绍多模态参考、编辑视频、延长视频的提示词典型公式，更多详细内容请参见[Seedance 2.0 系列提示词指南](/docs/82379/2222480)。
:::tip
平台提供 **seedance 2.0 提示词优化技能**，方便您对提示词进行调优。
* 配置方式：可将技能文件配置到 Code Agent / AI Agent 中使用。以 OpenClaw 为例，下载该 SKILL.md 文件，复制完整内容至对话输入框中，并发送”请帮我安装这个技能”，等待工具自动完成安装。
* 使用方式：在 AI 对话框输入 `/sd2-pe + 你的提示词内容`，开始调试提示词。
:::
**多模态参考**
* 图片参考：参考 / 提取 / 结合 +「图片 n」中的「主体 / 被参考元素描述」，生成「画面描述」，保持「主体 / 被参考元素描述」特征一致。
* 视频参考：参考「视频 n」的「动作描述 / 运镜描述 / 特效描述」，生成「画面描述」，保持动作细节 / 运镜 / 特效一致。
* 音频参考：
* 音色参考：「角色」说：“「台词」，音色参考「音频 n」。
* 音频内容参考：理想出现时机 +「音频 n」。
**编辑视频**
* 增加元素：清晰描述「元素特征」+「出现时机」+「出现位置」
* 删除元素：点明需要删除的元素，对于保持不变的元素，在提示词中加以强调，表现更佳
* 修改元素：清晰描述更换元素即可
**延长视频**
* 延长视频：向前/向后延长「视频n」+「需延长的视频描述」
* 轨道补全：「视频1」+「过渡画面描述」+接「视频2」+「过渡画面描述」+接「视频3」
# 使用限制
参见[使用限制](/docs/82379/1366799#66cb028f)。