# Seedance 2.0 能力总览

> Doubao Seedance 2.0 视频生成：模型介绍、技术规格、分辨率与宽高比、计费方式与常见问题

Seedance 2.0 是字节跳动豆包（Doubao）系列的旗舰视频生成模型，支持文生视频、首尾帧图生视频与多模态参考生成，并可同步生成与画面匹配的音频。LoopRouter 以与火山引擎方舟完全一致的接口对外提供该能力。

## 快速入口

<CardGroup cols={2}>
  <Card title="视频生成 API" icon="clapperboard" href="/api-capabilities/seedance2/video-generation">
    完整参数、三种生成模式、响应结构与错误码
  </Card>
  <Card title="在线调试（试一试）" icon="flask" href="/api-reference/create-video-task">
    在文档内直接发起真实请求
  </Card>
  <Card title="素材库" icon="images" href="/asset-management/asset-library">
    上传素材、管理素材组，获取 asset ID
  </Card>
  <Card title="真人认证接口" icon="user-check" href="/asset-management/real-person">
    真实人像素材的活体认证全流程 API
  </Card>
</CardGroup>

## 核心特性

<CardGroup cols={2}>
  <Card title="多模态参考生成" icon="layer-group">
    单次请求最多组合 9 张参考图、3 段参考视频、3 段参考音频，保持角色与风格一致
  </Card>
  <Card title="音画同步" icon="volume-high">
    `generate_audio` 默认开启，人声、音效与配乐与画面同步生成
  </Card>
  <Card title="高分辨率" icon="expand">
    支持 480p / 720p / 1080p / 4k 多档输出，固定 24fps（可用档位依分组）
  </Card>
  <Card title="片段续接" icon="link">
    `return_last_frame` 返回末帧图，用作下一段视频的首帧，串联多个片段
  </Card>
</CardGroup>

## 模型清单

| 模型 | 说明 |
| --- | --- |
| `doubao-seedance-2-0-260128` | 标准版，支持全部生成模式，最高 4k 输出（可用分辨率档位依分组） |

<Note>
模型名与火山官方快照版本号保持一致（`doubao-seedance-2-0-260128`），不需要 `ep-` 开头的接入点 ID。实际可用模型以控制台「模型广场」为准。
</Note>

## 技术规格

| 项目 | 规格 |
| --- | --- |
| 生成模式 | 文生视频 / 首帧图生 / 首尾帧图生 / 多模态参考 |
| 分辨率 | `480p` / `720p` / `1080p` / `4k`，可用档位由[分组](/user-groups)决定：VIP 组全档位，补贴组 `720p` / `1080p`（分组外档位将被 400 拒绝，不扣费） |
| 宽高比 | `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`adaptive`（默认，跟随输入素材） |
| 时长 | 4–15 秒整数，或 `-1` 由模型决定；默认 5 秒 |
| 帧率 | 固定 24fps |
| 音频 | 默认生成同步音频，可用 `generate_audio: false` 关闭 |
| 参考素材 | ≤9 图 + ≤3 视频 + ≤3 音频（音频单段 2–15 秒） |
| 图片要求 | jpeg/png/webp/bmp/tiff/gif/heic/heif；宽高比 (0.4, 2.5)；边长 (300, 6000)px；小于 30MB |
| 提示词建议 | 中文 ≤500 字 / 英文 ≤1000 词；台词用双引号包裹 |
| 任务模式 | 异步任务：`queued → running → succeeded / failed / cancelled / expired` |
| 成片链接 | `content.video_url` 约 2 小时有效，请及时转存 |

## 端点一览

Base URL：`https://api.looprouter.com`

| 方法 | 路径 | 用途 |
| --- | --- | --- |
| POST | `/api/v3/contents/generations/tasks` | 创建视频生成任务 |
| GET | `/api/v3/contents/generations/tasks/{task_id}` | 查询单个任务 |
| GET | `/api/v3/contents/generations/tasks` | 任务列表（分页/筛选） |
| DELETE | `/api/v3/contents/generations/tasks/{task_id}` | 取消/删除任务 |
| POST | `/api/v3/assets?Action=...&Version=2024-01-01` | 素材库与真人认证（[详情](/asset-management/asset-library)） |

<Tip>
所有接口统一使用 `Authorization: Bearer sk-...` 请求头，API Key 在 [控制台 → 令牌](https://console.looprouter.com/keys) 创建。路径中的 `/api` 前缀不能省略。
</Tip>

## 模型定价

计费采用**提交预扣、完成结算**的两段式流程：

<Steps>
  <Step title="提交预扣">
    任务创建成功后，按请求参数（分辨率、时长）预估并预扣一笔额度，日志中心会产生一条预扣记录。
  </Step>
  <Step title="完成结算">
    任务成功后按上游返回的实际用量（`usage.total_tokens`，约等于 时长 × 输出宽 × 输出高 × 24 ÷ 1024）重新计算，多退少补；任务失败则全额退回预扣。
  </Step>
</Steps>

<Info>
**视频输入折扣**：当请求 `content` 中包含参考视频（`video_url`）时，系统自动应用带视频输入的优惠倍率，无需额外传参。

**不扣费场景**：参数校验失败（400）、内容审核拒绝（403）均不产生费用。
</Info>

<Warning>
使用 `duration: -1`（模型自选时长）或 `ratio: adaptive` 时，实际费用以任务成功后响应中回填的真实时长/分辨率为准，与预扣金额可能存在差额，结算时自动多退少补。
</Warning>

各分辨率档位的具体单价请以控制台「模型广场」与「日志中心」展示为准。实际扣费还会应用 API Key 所在[分组](/user-groups)的计费倍率（具体折扣以商务对接约定为准），分组同时决定可用的分辨率档位。

## 限流与重试

- 平台按渠道维度做 RPM 智能调度：并发高峰时任务会短暂排队而不是直接失败。
- 收到 429（`当前分组上游负载已饱和，请稍后再试`）或 5xx 时，建议指数退避重试（2s → 4s → 8s）。
- 轮询查询接口建议间隔 15–30 秒；720p / 5 秒视频的典型生成耗时约 2–5 分钟。

## 常见问题

<AccordionGroup>
  <Accordion title="为什么创建任务只返回一个 id，没有视频？">
    这是异步任务接口：创建仅入队并返回任务 ID，需轮询 `GET /api/v3/contents/generations/tasks/{id}` 直到状态变为 `succeeded`，再从 `content.video_url` 下载成片。
  </Accordion>
  <Accordion title="成功状态是 completed 还是 succeeded？">
    是 `succeeded`。判断终态请匹配 `succeeded / failed / cancelled / expired` 四个值。
  </Accordion>
  <Accordion title="支持哪些分辨率？为什么传 480p 会报错？">
    可用档位由 API Key 所在的[分组](/user-groups)决定：VIP 组支持 `480p`、`720p`、`1080p`、`4k` 全档位，补贴组支持 `720p`、`1080p`。传入分组不支持的档位会返回 400（错误信息会列出当前可用档位），且不扣费。
  </Accordion>
  <Accordion title="支持 callback 回调吗？">
    不支持。`callback_url` 会被 400 拒绝，请使用轮询获取任务结果。
  </Accordion>
  <Accordion title="视频链接过期了怎么办？">
    `content.video_url` 是约 2 小时有效的临时链接，过期后重新调用查询接口会得到新的下载链接；但任务本身也有保留期限，请在生成后尽快转存到自己的存储。
  </Accordion>
  <Accordion title="能直接用真人照片作参考图吗？">
    不能。出于防深度伪造要求，真实人脸图片不能直接放入 `image_url`（会被内容审核 403 拒绝）。需先完成 [真人认证](/asset-management/real-person)，把照片上传到认证素材组，再以 `asset://素材ID` 引用。
  </Accordion>
  <Accordion title="同一个 seed 能得到完全相同的视频吗？">
    不能保证完全一致。相同 seed 与参数会得到高度相近的结果，适合微调提示词时保持整体构图稳定。
  </Accordion>
  <Accordion title="Python 请求报 JSON 解析错误 / 响应被截断？">
    在请求头加 `Accept-Encoding: identity`。个别网络环境下网关 gzip 协商会导致 `requests` 解码异常。
  </Accordion>
</AccordionGroup>

## 相关文档

<CardGroup cols={3}>
  <Card title="视频生成 API" icon="clapperboard" href="/api-capabilities/seedance2/video-generation">
    参数与响应详解
  </Card>
  <Card title="素材引用实战" icon="wand-magic-sparkles" href="/asset-management/asset-reference">
    端到端角色一致性教程
  </Card>
  <Card title="快速开始" icon="rocket" href="/getting-started">
    三步跑通第一个视频
  </Card>
</CardGroup>