第 3 课
按官方限制做首帧生成,分清 Flash 与旗舰差异,并对照刊例估算费用
按官方限制做首帧生成,分清 Flash 与旗舰差异,并对照刊例估算费用
课程目录第 3 / 3 课
学习位置仅保存在当前浏览器,有效期 180 天。
按官方限制做首帧生成,分清 Flash 与旗舰差异,并对照刊例估算费用
本课对照官方文档「Doubao Seedance 2.5 系列教程」「视频生成教程」「模型价格」编写。命令在 2026-11-21 核对;首帧示例提示词、官方配图和刊例价均来自当前官方文档。成功成片采用官方文档示例,本环境未用真实密钥跑出成功视频。
本课目标
- 按官方限制提交一条首帧生视频任务:
ratio必须为adaptive - 使用官方「图生视频-基于首帧」示例的提示词和官方首帧图,只把 Model ID 换成 Flash
- 分清 Flash 与旗舰在分辨率、样片(Draft)模式和参考素材上限上的差异
- 对照官方刊例价,估算 16:9、5 秒、输入不含视频时的费用,并记住以
usage.completion_tokens为准
前置条件
- 已完成前两课,能够创建任务并查询状态
- 已导出
ARK_API_KEY,并已开通 Seedance 2.5 flash - 本课会请求官方文档中的公开配图 URL,不需要自己准备本地图片
第 1 步:先看清首帧任务的特殊限制
官方系列教程「任务类型与限制」写明:当 content.role 设置为 first_frame / last_frame 时,任务属于首帧 / 首尾帧生视频,此时 ratio 必须为 adaptive。模型会自动保持输出视频宽高比和 first_frame 指定的首帧图片一致。配置方法也写了两步:
content中需包含role为first_frame的图片;首尾帧生视频还需包含role为last_frame的图片。ratio必须为adaptive。
如果这里写成 16:9 或其他固定比例,任务可能先创建成功,再在查询阶段异步报错,错误码是 InvalidParameter.TaskTypeConstraint。

2026-11-21 实拍,已滚动到「任务类型与限制」。表中可见首帧/首尾帧的触发条件是
content.role设置为first_frame/last_frame。右侧「特殊限制」列在 1280 宽视口中略有裁切,完整表述见上文官方原文。https://ark.volcengine.com/region:cn-beijing/docs/seedance-2-5
官方「创建视频生成任务」对「图生视频-首帧」还写了一句:需要传入 1 个 image_url 对象,role 为 first_frame 或不填。也就是说,只做首帧时,不填 role 也可以。本课按系列教程的配置方法显式写出 role 为 first_frame,避免和参考图、尾帧混用。官方还提醒:首帧 / 首尾帧与全模态参考是互斥场景,不可混用。
第 2 步:用官方首帧示例生成视频
官方「视频生成教程」在「图生视频-基于首帧(含音频)」一节给出了下面这条提示词,以及官方首帧图。提示词一个字都不改:
「女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动,可以听到风声」
官方首帧图地址是:
https://arkdocs.tos-cn-beijing.volces.com/images/video-generation/i2v_foxrgirl.png

这是官方视频生成教程里的首帧示例原图,不是示意图,也不是 AI 概念图。来源见上面的 TOS 地址。

2026-11-21 实拍,已滚动到「图生视频-基于首帧(含音频)」。官方示例代码里的 Model ID 仍是旗舰,抄写时请换成 Flash,并把
ratio保持为adaptive。https://ark.volcengine.com/region:cn-beijing/docs/video-generation-tutorial
官方这一节的 Python 示例把 model 写成 doubao-seedance-2-5-260628,并注释 Replace with Model ID;ratio 已经是 adaptive,duration 为 5,watermark 为 True,并开启 generate_audio=True。原文图片对象里没有写 role。下面只做两处说明性调整:Model ID 换成 Flash,并按系列教程显式补上 "role": "first_frame"。提示词、图片 URL 和其他参数保持官方原样:
import os
import time
# Install SDK: python -m pip install --upgrade arkruntime
from arkruntime import Ark
# Make sure that you have stored the API Key in the environment variable ARK_API_KEY
# Initialize the Ark client to read your API Key from an environment variable
client = Ark(
# This is the default path. You can configure it based on the service location
base_url="https://ark.cn-beijing.volces.com/api/v3",
# Get API Key:https://ark.volcengine.com/region:cn-beijing/apikey
api_key=os.environ.get("ARK_API_KEY"),
)
if __name__ == "__main__":
print("----- create request -----")
create_result = client.content_generation.tasks.create(
model="doubao-seedance-2-5-flash-261115", # 官方示例写的是旗舰 ID,已按注释换成 Flash
content=[
{
# Combination of text prompt and parameters
"type": "text",
"text": "女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动,可以听到风声"
},
{
# The URL of the first frame image
"type": "image_url",
"image_url": {
"url": "https://arkdocs.tos-cn-beijing.volces.com/images/video-generation/i2v_foxrgirl.png"
},
"role": "first_frame"
}
],
generate_audio=True,
ratio="adaptive",
duration=5,
watermark=True,
)
print(create_result)
# Polling query section
print("----- polling task status -----")
task_id = create_result.id
while True:
get_result = client.content_generation.tasks.get(task_id=task_id)
status = get_result.status
if status == "succeeded":
print("----- task succeeded -----")
print(get_result)
break
elif status == "failed":
print("----- task failed -----")
print(f"Error: {get_result.error}")
break
else:
print(f"Current status: {status}, Retrying after 10 seconds...")
time.sleep(10)
对应的 curl 仍使用官方创建接口的路径和请求头,请求体与上面一致:
curl -X POST \
"https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ARK_API_KEY" \
-d '{
"model": "doubao-seedance-2-5-flash-261115",
"content": [
{
"type": "text",
"text": "女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动,可以听到风声"
},
{
"type": "image_url",
"image_url": {
"url": "https://arkdocs.tos-cn-beijing.volces.com/images/video-generation/i2v_foxrgirl.png"
},
"role": "first_frame"
}
],
"generate_audio": true,
"ratio": "adaptive",
"duration": 5,
"watermark": true
}'
查询方式和第 2 课相同。官方文档在该示例旁也给出了效果预览视频,这是文档里的示例成片,不是本机跑出来的:
https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/f1f7b95a38ee4ee094c724233e4da4f8
成功成片采用官方文档示例,本环境未用真实密钥跑出成功视频。
第 3 步:分清 Flash 与旗舰,不要把旗舰能力安到 Flash 上
官方系列教程「能力概述」把 Seedance 2.5 和 Seedance 2.5 flash 列在同一张对照表里。和本课直接相关的差异如下(均来自该表和「使用限制」「分辨率」各节):
| 项目 | Seedance 2.5(旗舰) | Seedance 2.5 flash |
|---|---|---|
| Model ID | doubao-seedance-2-5-260628 | doubao-seedance-2-5-flash-261115 |
| 输出分辨率 | 480p、720p(8bit),以及 1080p、4k(10bit) | 仅 480p、720p(8bit),不支持 1080p / 4K |
| 样片(Draft)模式 | 支持 | 不支持 |
| 参考图片上限 | 30 张 | 10 张 |
| 参考视频上限 | 10 个 | 5 个 |
| 参考音频上限 | 10 段 | 5 段 |
| 输出时长 | 4~30 秒;-1 表示由模型在有效时长内自动选择 | 与旗舰相同:4~30 秒;亦可 -1 |
| 输出格式 | mp4、mov | mp4、mov |
| 宽高比 | 21:9、16:9、4:3、1:1、3:4、9:16、adaptive | 与旗舰相同 |
官方「样片模式支持」一节写得很干脆:「仅 Seedance 2.5 支持样片模式,Seedance 2.5 flash 不支持。」不要在 Flash 请求里传 draft=true,也不要把旗舰的 1080p / 4K 或 Draft 两步流程写进 Flash 的调用里。
单次最长 30 秒且可延长,这是 Seedance 2.5 系列能力,Flash 同样适用。但延长、编辑这些任务还有自己的参数限制,例如编辑时 ratio 必须为 adaptive、duration 必须为 -1,本课不展开跟做。

2026-11-21 实拍,已滚动到「使用限制」。图中可见全模态参考生视频下,Seedance 2.5 为 30 张,Seedance 2.5 flash 为 10 张;图生视频-首帧为 1 张。
https://ark.volcengine.com/region:cn-beijing/docs/seedance-2-5

2026-11-21 用无头 Chrome 实拍,已滚动到「样片模式支持」。原文第一句是「仅 Seedance 2.5 支持样片模式,Seedance 2.5 flash 不支持。」左侧输入示例用的也是官方首帧配图。
https://ark.volcengine.com/region:cn-beijing/docs/seedance-2-5
第 4 步:对照官方刊例估算费用
官方「模型价格」把视频生成按 token 计价,单位是元 / 百万 token,在线推理。Seedance 2.5 flash 在 480p、720p 两档的单价是:
| 输出分辨率 | 输入不含视频 | 输入包含视频 |
|---|---|---|
| 480p、720p | 46.00 | 28.00 |
旗舰 Seedance 2.5 在 480p、720p 是 70.00 / 42.00,另有 1080p、4K 档;Flash 没有这两档,定价表里对应位置写的是「不支持」。
官方还给出了 16:9、输出视频时长 5 秒、输入不含视频的估算示例:
| 价格口径 | 480p | 720p | 1080p | 4K |
|---|---|---|---|---|
| 视频单价(元 / 个) | 2.21 | 4.97 | 不支持 | 不支持 |
| 折合价格(元 / 秒) | 0.44 | 0.99 | 不支持 | 不支持 |
这是官方估算示例,不是你这一次调用的精确账单。官方写明:token 用量估算公式是 (输入视频时长+输出视频时长) × 输出视频的宽 × 输出视频的高 × 输出视频的帧率/1024,该计算结果为估算值,准确用量以调用 API 后返回的 usage.completion_tokens 为准。
计费范围也以官方为准:仅对成功生成的视频计费;因审核等原因导致生成失败的,不收取费用。第 1 课默认分辨率是 720p、时长 5 秒、输入不含视频,对照上表大约是 4.97 元 / 个(约 0.99 元 / 秒)。若你显式把 resolution 设为 480p,估算示例是 2.21 元 / 个(约 0.44 元 / 秒)。真正下账仍以返回的 completion_tokens 乘以对应单价为准。

2026-11-21 实拍,已滚动到 16:9、输出 5 秒、输入不含视频的估算表。图中可见 Flash 的 2.21 / 4.97 与 0.44 / 0.99。1080p、4K 列在 1280 宽视口中被裁切,官方原文对应位置为「不支持」。
https://ark.volcengine.com/region:cn-beijing/docs/model-pricing
在线推理单价表(Flash 在 480p、720p 为 46.00 / 28.00)摘自本轮已下载的官方 model-pricing.md。本课尝试把视口停在该单价表时,页面停在了定价页开头的大语言模型说明,未拍到 Flash 所在行,因此不以截图代替原文。请以当前定价页复核。
常见坑
- 首帧任务把
ratio写成16:9。官方要求必须是adaptive,否则可能异步报InvalidParameter.TaskTypeConstraint。 - 在 Flash 上指定
1080p、4k,或打开draft=true。这两项都是旗舰能力,Flash 不支持。 - 参考素材超过 Flash 上限:图多于 10 张,或视频、音频多于 5 个。
- 把官方 2.21 元、4.97 元的估算示例当成精确账单。准确用量以
usage.completion_tokens为准。 - 审核失败仍去对账。官方写明:仅成功生成的视频计费,审核失败不收费。
小结
到这里,你已经按官方限制准备好了首帧请求,分清了 Flash 与旗舰在分辨率、样片模式和参考上限上的差别,并能对照官方刊例估算 480p / 720p 的费用。成功成片采用官方文档示例,本环境未用真实密钥跑出成功视频。之后若要做编辑、延长或更长的 30 秒叙事,请先回到系列教程核对该任务类型的特殊限制,不要把旗舰独有能力写进 Flash 调用。

