第 3 课

按官方限制做首帧生成,分清 Flash 与旗舰差异,并对照刊例估算费用

按官方限制做首帧生成,分清 Flash 与旗舰差异,并对照刊例估算费用

图文21 分钟

课程目录第 3 / 3 课

学习位置仅保存在当前浏览器,有效期 180 天。

01 / 图文教材

按官方限制做首帧生成,分清 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 指定的首帧图片一致。配置方法也写了两步:

  1. content 中需包含 role 为 first_frame 的图片;首尾帧生视频还需包含 role 为 last_frame 的图片。
  2. ratio 必须为 adaptive。

如果这里写成 16:9 或其他固定比例,任务可能先创建成功,再在查询阶段异步报错,错误码是 InvalidParameter.TaskTypeConstraint。

官方系列教程「任务类型与限制」:首帧/首尾帧要求 ratio 为 adaptive

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 地址。

官方「视频生成教程」图生视频-基于首帧:提示词、首帧图、预览成片与 Python 示例

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 IDdoubao-seedance-2-5-260628doubao-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、movmp4、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,本课不展开跟做。

官方系列教程「使用限制」:Flash 参考图上限为 10 张

2026-11-21 实拍,已滚动到「使用限制」。图中可见全模态参考生视频下,Seedance 2.5 为 30 张,Seedance 2.5 flash 为 10 张;图生视频-首帧为 1 张。

https://ark.volcengine.com/region:cn-beijing/docs/seedance-2-5

官方系列教程「样片模式支持」:写明 Seedance 2.5 flash 不支持样片模式

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、720p46.0028.00

旗舰 Seedance 2.5 在 480p、720p 是 70.00 / 42.00,另有 1080p、4K 档;Flash 没有这两档,定价表里对应位置写的是「不支持」。

官方还给出了 16:9、输出视频时长 5 秒、输入不含视频的估算示例:

价格口径480p720p1080p4K
视频单价(元 / 个)2.214.97不支持不支持
折合价格(元 / 秒)0.440.99不支持不支持

这是官方估算示例,不是你这一次调用的精确账单。官方写明:token 用量估算公式是 (输入视频时长+输出视频时长) × 输出视频的宽 × 输出视频的高 × 输出视频的帧率/1024,该计算结果为估算值,准确用量以调用 API 后返回的 usage.completion_tokens 为准。

计费范围也以官方为准:仅对成功生成的视频计费;因审核等原因导致生成失败的,不收取费用。第 1 课默认分辨率是 720p、时长 5 秒、输入不含视频,对照上表大约是 4.97 元 / 个(约 0.99 元 / 秒)。若你显式把 resolution 设为 480p,估算示例是 2.21 元 / 个(约 0.44 元 / 秒)。真正下账仍以返回的 completion_tokens 乘以对应单价为准。

官方「模型价格」页 Seedance 2.5 系列估算示例:Flash 480p 2.21 元/个、720p 4.97 元/个

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 调用。