Seedance 2.0 视频生成

Seedance 2.0 系列支持文生视频、图生视频（首帧 / 首尾帧）、全模态参考、视频编辑与视频延长。这个家族走方舟（Ark）原生协议：请求体与响应体沿用官方「创建视频生成任务 / 查询视频生成任务」的结构，参数原样透传。本页先给「场景总览」，再按场景逐个给出可直接运行的请求与各状态响应；示例的提示词和素材 URL 均取自官方文档原文。

场景总览

示例证据：每个小节都标注「已实测」或「依官方文档（未实测）」。「已实测」指用线上测试账号真实调用并成功。

通用说明

支持的模型

可售分辨率以模型页的价格配置为准：未定价的档位返回 400 InvalidParameter。

通用请求与轮询代码

下文各场景的 Python 示例都使用这里的 create 与 wait。

import time, requests

API_KEY = "sk-ms-xxxxxxxx"
URL = "https://api.modelsite.ai/api/v3/contents/generations/tasks"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}


def create(body):
    r = requests.post(URL, headers=HEADERS, json=body, timeout=60)
    r.raise_for_status()
    return r.json()["id"]


def wait(task_id, interval=10):
    while True:
        task = requests.get(f"{URL}/{task_id}", headers=HEADERS, timeout=30).json()
        if task["status"] == "succeeded":
            return task
        if task["status"] in ("failed", "expired", "cancelled"):
            raise RuntimeError(task.get("error"))
        time.sleep(interval)

请求体

所有字段平铺在顶层，除「平台处理」的字段外都原样转发，平台不改写、不补默认值。

官方标注 Seedance 2.0 系列不支持的字段，不要传：frames、camera_fixed、draft、output_format、omni_reference_task_type、service_tier: "flex"。平台不拦截，上游会拒绝。

三种输入场景互斥，不可混用：首帧（1 张图）、首尾帧（2 张图，role 必填）、多模态参考（19 张 reference_image、03 段 reference_video、0~3 段 reference_audio，至少含 1 张图或 1 段视频，不能只传音频）。

含参考视频的任务按「输入含视频」档位计价（单价低于不含视频档）；平台只在模型配置了该档位时才接受 video_url，否则返回 400 InvalidParameter（video input is not supported yet on this model）。两个模型目前都已配置该档位。

文生视频

何时用：只有文字描述，没有任何素材。

证据：已实测（线上测试账号）：dreamina-seedance-2-0 与 dreamina-seedance-2-0-mini 的 480P / 720P 文生视频均有线上成功结算记录（2026-10-10 至 2026-10-18）；2026-10-19 又实测 dreamina-seedance-2-0 的 480p 4 秒（completion_tokens 40,594）与 1080p 5 秒（completion_tokens 245,025），均成功，下方两个成功响应取自这两次实测，ID、时间戳、视频 URL 已换占位。1080p 实测使用的提示词不含知名角色：含知名角色的提示词会被上游以版权限制拒绝且不计费（见「失败 · 版权限制」）。本例提示词取自官方「创建视频生成任务」页文生视频示例。

创建任务请求

curl https://api.modelsite.ai/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer sk-ms-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
{
  "model": "dreamina-seedance-2-0",
  "content": [
    {
      "type": "text",
      "text": "写实风格，晴朗的蓝天之下，一大片白色的雏菊花田，镜头逐渐拉近，最终定格在一朵雏菊花的特写上，花瓣上有几颗晶莹的露珠"
    }
  ],
  "resolution": "480p",
  "ratio": "16:9",
  "duration": 4,
  "generate_audio": true,
  "watermark": false
}
EOF

创建响应

{
  "id": "video_<opaque-token>",
  "status": "queued"
}

id 是平台签发的不透明任务令牌，查询时原样带上；创建本身不扣费。实际响应还会带 created_at 等字段，请只依赖 id。

轮询请求

curl "https://api.modelsite.ai/api/v3/contents/generations/tasks/video_<opaque-token>" \
  -H "Authorization: Bearer sk-ms-xxxxxxxx"

各状态响应

{
  "id": "video_<opaque-token>",
  "status": "running"
}

注意事项 / 限制

• 示例用 480p 与最短 4 秒，成本最低；按需改 resolution / duration（[4, 15]）。
• dreamina-seedance-2-0-mini 同样可用：把 model 换成它即可，分辨率只有 480p / 720p。
• generate_audio 默认 true，设为 false 输出无声视频；生成的音频为单声道。
• return_last_frame、watermark、seed 等可选字段见上文请求体。
• 1080p 的成功响应来自另一条不含知名角色的提示词；请求形态相同，只是 resolution 为 "1080p"、duration 为 5。
• 示例响应里的 usage 数值：文生视频 480p 4 秒、1080p 5 秒与 4K 4 秒为实测值，其余为按官方公式（宽 × 高 × 帧率 × 时长 / 1024，含视频时再加输入视频时长）估算的示意值，以实际返回为准。

首帧图生视频

何时用：已有一张图，希望它作为视频第一帧。图片也可以用 Base64 data URI 传入。

证据：依官方文档（未实测）。提示词与首帧图取自官方「创建视频生成任务」页「有声视频-首帧」示例；Base64 示例的提示词取自该页「图生视频-base64编码」示例，Base64 内容为占位。

创建任务请求

curl https://api.modelsite.ai/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer sk-ms-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
{
  "model": "dreamina-seedance-2-0",
  "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"
    }
  ],
  "resolution": "480p",
  "ratio": "adaptive",
  "duration": 4,
  "generate_audio": true,
  "watermark": false
}
EOF

创建响应

{
  "id": "video_<opaque-token>",
  "status": "queued"
}

id 是平台签发的不透明任务令牌，查询时原样带上；创建本身不扣费。实际响应还会带 created_at 等字段，请只依赖 id。

轮询请求

curl "https://api.modelsite.ai/api/v3/contents/generations/tasks/video_<opaque-token>" \
  -H "Authorization: Bearer sk-ms-xxxxxxxx"

各状态响应

{
  "id": "video_<opaque-token>",
  "status": "running"
}

注意事项 / 限制

• role 为 first_frame 或省略，都表示首帧；只能传 1 张图。
• ratio: adaptive 让输出宽高比跟随输入图；固定比例与图片宽高比不一致时可能出现画面拉伸 / 跳变，官方建议裁剪图片或使用 adaptive。
• Base64 数据请求体 ≤ 64 MB，大文件不要用 Base64；格式名小写，如 data:image/png;base64,...。
• 示例用 480p 与最短 4 秒，成本最低；按需改 resolution / duration（[4, 15]）。
• dreamina-seedance-2-0-mini 同样可用：把 model 换成它即可，分辨率只有 480p / 720p。
• 素材 URL 是官方文档示例里的原链接，仅用于演示；生产环境请换成你自己的素材。
• 示例响应里的 usage 数值：文生视频 480p 4 秒、1080p 5 秒与 4K 4 秒为实测值，其余为按官方公式（宽 × 高 × 帧率 × 时长 / 1024，含视频时再加输入视频时长）估算的示意值，以实际返回为准。

首尾帧图生视频

何时用：已有起止两张图，让视频从第一张自然过渡到第二张。

证据：依官方文档（未实测）。提示词与首尾帧图取自官方「创建视频生成任务」页「有声视频-首尾帧」示例。

创建任务请求

curl https://api.modelsite.ai/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer sk-ms-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
{
  "model": "dreamina-seedance-2-0",
  "content": [
    {
      "type": "text",
      "text": "图中女孩对着镜头说“茄子”，360度环绕运镜"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://arkdocs.tos-cn-beijing.volces.com/images/video-generation/seepro_first_frame.jpeg"
      },
      "role": "first_frame"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://arkdocs.tos-cn-beijing.volces.com/images/video-generation/seepro_last_frame.jpeg"
      },
      "role": "last_frame"
    }
  ],
  "resolution": "480p",
  "ratio": "adaptive",
  "duration": 4,
  "generate_audio": true,
  "watermark": false
}
EOF

创建响应

{
  "id": "video_<opaque-token>",
  "status": "queued"
}

id 是平台签发的不透明任务令牌，查询时原样带上；创建本身不扣费。实际响应还会带 created_at 等字段，请只依赖 id。

轮询请求

curl "https://api.modelsite.ai/api/v3/contents/generations/tasks/video_<opaque-token>" \
  -H "Authorization: Bearer sk-ms-xxxxxxxx"

各状态响应

{
  "id": "video_<opaque-token>",
  "status": "running"
}

注意事项 / 限制

• 两张图 role 必须分别是 first_frame 与 last_frame（可以是同一张图）；宽高比不一致时以首帧为准，尾帧自动裁剪。
• 官方首尾帧示例的素材是 1:1 图片，因此使用 ratio: adaptive。
• 示例用 480p 与最短 4 秒，成本最低；按需改 resolution / duration（[4, 15]）。
• dreamina-seedance-2-0-mini 同样可用：把 model 换成它即可，分辨率只有 480p / 720p。
• 素材 URL 是官方文档示例里的原链接，仅用于演示；生产环境请换成你自己的素材。
• 示例响应里的 usage 数值：文生视频 480p 4 秒、1080p 5 秒与 4K 4 秒为实测值，其余为按官方公式（宽 × 高 × 帧率 × 时长 / 1024，含视频时再加输入视频时长）估算的示意值，以实际返回为准。

全模态参考

何时用：同时用多张参考图、参考视频、参考音频生成新视频：继承图片的形象与风格，视频的运镜与动作，音频的音色与节奏。

证据：请求含参考视频的计价路径已实测（video_input 为含视频档的 480P 4 秒任务有线上成功结算记录，2026-10-11）；本页这个具体场景与素材：依官方文档（未实测）。提示词与全部素材取自官方「Seedance 2.0 系列教程」全模态参考示例。

创建任务请求

curl https://api.modelsite.ai/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer sk-ms-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
{
  "model": "dreamina-seedance-2-0",
  "content": [
    {
      "type": "text",
      "text": "全程使用视频1的第一视角构图，全程使用音频1作为背景音乐。第一人称视角果茶宣传广告，seedance牌「苹苹安安」苹果果茶限定款；首帧为图片1，你的手摘下一颗带晨露的阿克苏红苹果，轻脆的苹果碰撞声；2-4 秒：快速切镜，你的手将苹果块投入雪克杯，加入冰块与茶底，用力摇晃，冰块碰撞声与摇晃声卡点轻快鼓点，背景音：「鲜切现摇」；4-6 秒：第一人称成品特写，分层果茶倒入透明杯，你的手轻挤奶盖在顶部铺展，在杯身贴上粉红包标，镜头拉近看奶盖与果茶的分层纹理；6-8 秒：第一人称手持举杯，你将图片2中的果茶举到镜头前（模拟递到观众面前的视角），杯身标签清晰可见，背景音「来一口鲜爽」，尾帧定格为图片2。背景声音统一为女生音色。"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg"
      },
      "role": "reference_image"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg"
      },
      "role": "reference_image"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_tea_video1.mp4"
      },
      "role": "reference_video"
    },
    {
      "type": "audio_url",
      "audio_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
      },
      "role": "reference_audio"
    }
  ],
  "resolution": "480p",
  "ratio": "16:9",
  "duration": 4,
  "generate_audio": true,
  "watermark": false
}
EOF

创建响应

{
  "id": "video_<opaque-token>",
  "status": "queued"
}

id 是平台签发的不透明任务令牌，查询时原样带上；创建本身不扣费。实际响应还会带 created_at 等字段，请只依赖 id。

轮询请求

curl "https://api.modelsite.ai/api/v3/contents/generations/tasks/video_<opaque-token>" \
  -H "Authorization: Bearer sk-ms-xxxxxxxx"

各状态响应

{
  "id": "video_<opaque-token>",
  "status": "running"
}

注意事项 / 限制

• 可任意组合：图片 09、视频 03、音频 0~3；不支持「文本 + 音频」或纯音频，至少含 1 张图或 1 段视频。
• 每个媒体块都要带 role；提示词用「图片 n」「视频 n」「音频 n」引用素材。
• 含参考视频，按「输入含视频」档计价；计费 token 包含输入视频时长，且存在官方最低 token 用量限制。
• 官方示例用 11 秒，这里取最短 4 秒以降低成本，提示词里的分镜时间点会随之被截短。
• dreamina-seedance-2-0-mini 同样可用：把 model 换成它即可，分辨率只有 480p / 720p。
• 素材 URL 是官方文档示例里的原链接，仅用于演示；生产环境请换成你自己的素材。
• 示例响应里的 usage 数值：文生视频 480p 4 秒、1080p 5 秒与 4K 4 秒为实测值，其余为按官方公式（宽 × 高 × 帧率 × 时长 / 1024，含视频时再加输入视频时长）估算的示意值，以实际返回为准。

编辑视频

何时用：对已有视频做局部修改：替换主体、增删对象、局部重绘等，运镜保持不变。

证据：请求含参考视频的计价路径已实测（video_input 为含视频档的 480P 4 秒任务有线上成功结算记录，2026-10-11）；本页这个具体场景与素材：依官方文档（未实测）。提示词与素材取自官方「Seedance 2.0 系列教程」编辑视频示例。

创建任务请求

curl https://api.modelsite.ai/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer sk-ms-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
{
  "model": "dreamina-seedance-2-0",
  "content": [
    {
      "type": "text",
      "text": "将视频1礼盒中的香水替换成图片1中的面霜，运镜不变"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_edit_pic1.jpg"
      },
      "role": "reference_image"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_edit_video1.mp4"
      },
      "role": "reference_video"
    }
  ],
  "resolution": "480p",
  "ratio": "16:9",
  "duration": 4,
  "generate_audio": true,
  "watermark": false
}
EOF

创建响应

{
  "id": "video_<opaque-token>",
  "status": "queued"
}

id 是平台签发的不透明任务令牌，查询时原样带上；创建本身不扣费。实际响应还会带 created_at 等字段，请只依赖 id。

轮询请求

curl "https://api.modelsite.ai/api/v3/contents/generations/tasks/video_<opaque-token>" \
  -H "Authorization: Bearer sk-ms-xxxxxxxx"

各状态响应

{
  "id": "video_<opaque-token>",
  "status": "running"
}

注意事项 / 限制

• 请求结构与全模态参考相同：待编辑视频用 reference_video，替换内容用 reference_image，靠提示词描述编辑动作；没有单独的「编辑」开关（omni_reference_task_type 仅 2.5 支持）。
• 含参考视频，按「输入含视频」档计价，且存在最低 token 用量限制。
• dreamina-seedance-2-0-mini 同样可用：把 model 换成它即可，分辨率只有 480p / 720p。
• 素材 URL 是官方文档示例里的原链接，仅用于演示；生产环境请换成你自己的素材。
• 示例响应里的 usage 数值：文生视频 480p 4 秒、1080p 5 秒与 4K 4 秒为实测值，其余为按官方公式（宽 × 高 × 帧率 × 时长 / 1024，含视频时再加输入视频时长）估算的示意值，以实际返回为准。

延长视频

何时用：向前或向后延长一段视频，或把最多 3 段视频串成一个连贯视频。

证据：请求含参考视频的计价路径已实测（video_input 为含视频档的 480P 4 秒任务有线上成功结算记录，2026-10-11）；本页这个具体场景与素材：依官方文档（未实测）。提示词与三段视频取自官方「Seedance 2.0 系列教程」延长视频示例。

创建任务请求

curl https://api.modelsite.ai/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer sk-ms-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
{
  "model": "dreamina-seedance-2-0",
  "content": [
    {
      "type": "text",
      "text": "视频1中的拱形窗户打开，进入美术馆室内，接视频2，之后镜头进入画内，接视频3"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_extend_video1.mp4"
      },
      "role": "reference_video"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_extend_video2.mp4"
      },
      "role": "reference_video"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_extend_video3.mp4"
      },
      "role": "reference_video"
    }
  ],
  "resolution": "480p",
  "ratio": "16:9",
  "duration": 4,
  "generate_audio": true,
  "watermark": false
}
EOF

创建响应

{
  "id": "video_<opaque-token>",
  "status": "queued"
}

id 是平台签发的不透明任务令牌，查询时原样带上；创建本身不扣费。实际响应还会带 created_at 等字段，请只依赖 id。

轮询请求

curl "https://api.modelsite.ai/api/v3/contents/generations/tasks/video_<opaque-token>" \
  -H "Authorization: Bearer sk-ms-xxxxxxxx"

各状态响应

{
  "id": "video_<opaque-token>",
  "status": "running"
}

注意事项 / 限制

• 延长 1 段视频时，生成结果一般只含原视频的尾部画面，可在提示词里要求包含原视频（如「……最后接视频 1」）；传 2~3 段视频则补全中间过渡，结果包含原视频与新内容。
• 多段输入视频总长 ≤ 15 秒；输入视频时长全部计入 token，是本页成本最高的 480p 场景之一。
• 官方示例用 8 秒，这里取最短 4 秒；上游是否接受 4 秒的串联输出未验证。
• dreamina-seedance-2-0-mini 同样可用：把 model 换成它即可，分辨率只有 480p / 720p。
• 素材 URL 是官方文档示例里的原链接，仅用于演示；生产环境请换成你自己的素材。
• 示例响应里的 usage 数值：文生视频 480p 4 秒、1080p 5 秒与 4K 4 秒为实测值，其余为按官方公式（宽 × 高 × 帧率 × 时长 / 1024，含视频时再加输入视频时长）估算的示意值，以实际返回为准。

输出 4K 视频

何时用：需要 4K（10bit、H.265 / HEVC）输出的专业场景。

证据：已实测（线上测试账号，2026-10-19）：dreamina-seedance-2-0、4k、16:9、4 秒的文生视频成功，completion_tokens 785,700；下方成功响应取自该次实测，ID、时间戳、视频 URL 已换占位。本例请求（带 1 张参考图、ratio: adaptive）是官方示例的 4 秒版本，未单独实测。提示词与参考图取自官方「Seedance 2.0 系列教程」输出 4K 视频示例（官方示例为 15 秒，这里取最短 4 秒）。

创建任务请求

curl https://api.modelsite.ai/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer sk-ms-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
{
  "model": "dreamina-seedance-2-0",
  "content": [
    {
      "type": "text",
      "text": "生成一段15秒的越野摩托竞技广告感短片。参考图片作为中段飞跃高潮的参考。镜头逻辑依次为：1）中景跟拍，车手从远处沿土坡高速逼近跳台；2）超近低机位后轮飞砂特写，轮胎抓地甩出大量泥土和砂石；3）中近景展示骑手控车、手部发力、悬挂压缩与机械震动；4）侧向英雄中景拍车手冲坡腾空飞跃，画面状态接近图一，泥土在逆光中大面积飞散；5）腾空近景帅气细节，突出头盔护目镜、手部控把、轮胎悬空或车身侧面局部；6）中景跟拍落地，悬挂压缩回弹，随后继续沿土坡赛道高速冲刺收尾。全片同一名骑手、同一辆车、同一条赛道，镜头景别和角度区分清楚，不重复，动作连贯,画面有真实越野跟拍抖动感、速度感、扬土感和夕阳逆光竞技氛围。"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_4k.png"
      },
      "role": "reference_image"
    }
  ],
  "resolution": "4k",
  "ratio": "adaptive",
  "duration": 4,
  "generate_audio": true,
  "watermark": false
}
EOF

创建响应

{
  "id": "video_<opaque-token>",
  "status": "queued"
}

id 是平台签发的不透明任务令牌，查询时原样带上；创建本身不扣费。实际响应还会带 created_at 等字段，请只依赖 id。

轮询请求

curl "https://api.modelsite.ai/api/v3/contents/generations/tasks/video_<opaque-token>" \
  -H "Authorization: Bearer sk-ms-xxxxxxxx"

各状态响应

{
  "id": "video_<opaque-token>",
  "status": "running"
}

注意事项 / 限制

• 仅 dreamina-seedance-2-0；dreamina-seedance-2-0-mini 传 4k 返回 400 InvalidParameter。
• 4K 输出为 H.265 / HEVC 编码，部分播放器或浏览器无法直接播放；官方 4K 并发限制更严（企业 1 个并发）。
• 这是本页最贵的场景：4K 的 token 数约为 480p 的 19 倍，单价另有分档，先用短时长验证。
• 素材 URL 是官方文档示例里的原链接，仅用于演示；生产环境请换成你自己的素材。
• 示例响应里的 usage 数值：文生视频 480p 4 秒、1080p 5 秒与 4K 4 秒为实测值，其余为按官方公式（宽 × 高 × 帧率 × 时长 / 1024，含视频时再加输入视频时长）估算的示意值，以实际返回为准。

联网搜索

何时用：提示词涉及时效性或需要上网核实的事物（商品、天气、罕见动物外观等）。

证据：依官方文档（未实测）。提示词取自官方「Seedance 2.0 系列教程」联网搜索示例（官方示例为 11 秒，这里取最短 4 秒）。

创建任务请求

curl https://api.modelsite.ai/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer sk-ms-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
{
  "model": "dreamina-seedance-2-0",
  "content": [
    {
      "type": "text",
      "text": "微距镜头对准叶片上翠绿的玻璃蛙。焦点逐渐从它光滑的皮肤，转移到它完全透明的腹部，一颗鲜红的心脏正在有力地、规律地收缩扩张。"
    }
  ],
  "resolution": "480p",
  "ratio": "16:9",
  "duration": 4,
  "generate_audio": true,
  "watermark": false,
  "tools": [
    {
      "type": "web_search"
    }
  ]
}
EOF

创建响应

{
  "id": "video_<opaque-token>",
  "status": "queued"
}

id 是平台签发的不透明任务令牌，查询时原样带上；创建本身不扣费。实际响应还会带 created_at 等字段，请只依赖 id。

轮询请求

curl "https://api.modelsite.ai/api/v3/contents/generations/tasks/video_<opaque-token>" \
  -H "Authorization: Bearer sk-ms-xxxxxxxx"

各状态响应

{
  "id": "video_<opaque-token>",
  "status": "running"
}

注意事项 / 限制

• 仅适用于纯文本输入；模型自行判断是否搜索，实际次数见查询结果的 usage.tool_usage.web_search（0 表示未搜索）。
• 部分支持：tools 原样透传；若上游对搜索另收费用，平台不另外计费，也未验证该字段在上游是否一定生效。
• 会增加一定时延。
• dreamina-seedance-2-0-mini 同样可用：把 model 换成它即可，分辨率只有 480p / 720p。
• 示例响应里的 usage 数值：文生视频 480p 4 秒、1080p 5 秒与 4K 4 秒为实测值，其余为按官方公式（宽 × 高 × 帧率 × 时长 / 1024，含视频时再加输入视频时长）估算的示意值，以实际返回为准。

返回尾帧图

何时用：想把一段视频的尾帧作为下一段的首帧，串联出更长的视频。

证据：依官方文档（未实测）。return_last_frame 来自官方「创建视频生成任务」页的参数说明，官方没有单独示例；本例用官方文生视频提示词构造。

创建任务请求

curl https://api.modelsite.ai/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer sk-ms-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
{
  "model": "dreamina-seedance-2-0",
  "content": [
    {
      "type": "text",
      "text": "写实风格，晴朗的蓝天之下，一大片白色的雏菊花田，镜头逐渐拉近，最终定格在一朵雏菊花的特写上，花瓣上有几颗晶莹的露珠"
    }
  ],
  "resolution": "480p",
  "ratio": "16:9",
  "duration": 4,
  "generate_audio": true,
  "watermark": false,
  "return_last_frame": true
}
EOF

创建响应

{
  "id": "video_<opaque-token>",
  "status": "queued"
}

id 是平台签发的不透明任务令牌，查询时原样带上；创建本身不扣费。实际响应还会带 created_at 等字段，请只依赖 id。

轮询请求

curl "https://api.modelsite.ai/api/v3/contents/generations/tasks/video_<opaque-token>" \
  -H "Authorization: Bearer sk-ms-xxxxxxxx"

各状态响应

{
  "id": "video_<opaque-token>",
  "status": "running"
}

注意事项 / 限制

• 成功后在 content.last_frame_url 取尾帧图（jpeg，无水印），24 小时有效；把它作为下一次请求的 first_frame（或先下载再传）即可串联。
• 示例用 480p 与最短 4 秒，成本最低；按需改 resolution / duration（[4, 15]）。
• dreamina-seedance-2-0-mini 同样可用：把 model 换成它即可，分辨率只有 480p / 720p。
• 示例响应里的 usage 数值：文生视频 480p 4 秒、1080p 5 秒与 4K 4 秒为实测值，其余为按官方公式（宽 × 高 × 帧率 × 时长 / 1024，含视频时再加输入视频时长）估算的示意值，以实际返回为准。

轮询字段说明

状态流转：queued → running → succeeded / failed / expired。失败与超时不结算。任务只在有限窗口内可查询（官方为最近 7 天），超过窗口或令牌无效时返回 404：

{
  "error": {
    "code": "NotFound",
    "message": "task not found or expired (a task is queryable for a limited window)"
  }
}

不支持或有差异的参数

平台扩展

• id 是平台签发的不透明令牌，不是上游原始任务 ID；创建响应与查询响应里 id 被替换，model 改写为你请求的模型名（不暴露上游型号），响应只保留官方「查询视频生成任务」定义的字段（id、model、status、content、usage、created_at、updated_at、seed、resolution、ratio、duration、frames、framespersecond、generate_audio、service_tier、execution_expires_after、draft、priority、output_format、safety_identifier、tools、error），不会出现其它字段（如内部任务号、progress）。
• 余额不足返回 402；任务成功后按 usage.completion_tokens 结算。
• 平台入口校验失败返回方舟原生形态 {"error": {"code", "message"}}（HTTP 400）。
• 任务失败时 error.code 原样返回；error.message 对官方错误码保留官方文案（已去掉请求 ID），其余文案若含网址、内部 ID、型号或渠道字样，会被替换为固定提示。
• 平台不支持 callback_url：回调体里的任务 ID 无法在平台查询，所以传入会直接返回 400；请以轮询为准。

计费

按实际生成视频消耗的 token 数结算，即查询结果里的 usage.completion_tokens × 对应档位单价（美元 / 百万 token，模型页可切换人民币显示）：

• 单价按输出分辨率分档，且输入含参考视频与不含参考视频是两档价格（含视频更低）。
• 官方对含视频输入设有最低 token 用量：估算值低于下限时按下限计，上游返回值已是下限，平台与官方一致。
• token 估算公式：宽 × 高 × 帧率 × 时长（秒）/ 1024；含视频输入时再加输入视频时长。实测的 usage.completion_tokens 比该公式估算值多约 1%（已核对，2026-10-19：1080p 5 秒公式估算 243,000、实测 245,025；4K 4 秒公式估算 777,600、实测 785,700），以返回值为准。
• 单价按 token 计，各分辨率档的每百万 token 单价不同：官方 4K 档每百万 token 价（26 元）低于 1080p 档（51 元），这是官方定价，不是错误；但 4K 的 token 数多得多（实测 4K 4 秒 785,700 token，1080p 5 秒 245,025 token），总费用仍高于 1080p。
• 创建本身不扣费；失败 / 超时任务不结算。具体单价见模型页。

错误处理

先看 HTTP 状态码：

{
  "error": {
    "code": "InvalidParameter",
    "message": "resolution \"4k\" is not available for dreamina-seedance-2-0-mini (sold: 480p, 720p)"
  }
}

示例提示词与素材来源：官方创建视频生成任务与Seedance 2.0 系列教程；失败错误码取自官方错误码；ID、URL 为占位值。