> ## Documentation Index
> Fetch the complete documentation index at: https://docs.token.poryf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Seedance 2.5 Flash

> Seedance 2.5 Flash 视频生成：文生视频、首尾帧、多模态参考的参数、示例、计费与正品校验。

字节跳动 Seedance 2.5 系列的快速视频模型，支持文生视频、首帧 / 首尾帧图生视频、全模态参考生成、视频编辑和延长，可同步生成声音。

* 模型 ID：`doubao-seedance-2-5-flash-261115`（火山方舟官方模型 ID，与直接调用火山方舟时相同）
* 接口：`POST https://token.poryf.com/v1/videos`（异步任务）
* [查看价格](https://token.poryf.com/pricing/doubao-seedance-2-5-flash-261115)

> [!TIP]
>
> 生成的视频是火山方舟官方原片，平台原样转发、不做转码，可以自己校验 C2PA 内容凭证，见 [确认是官方原片](#确认是官方原片)。

## 请求参数

外层只有 `model`、`prompt`、`seconds`；分辨率、比例、声音、参考素材等其余参数都写在 `metadata` 里，写法与火山方舟官方接口相同。

**Authorization** `string` *required*

`Bearer YOUR_API_KEY`，在 [控制台的 API 密钥页](https://token.poryf.com/keys) 创建。

**model** `string` *required*

`doubao-seedance-2-5-flash-261115`

**prompt** `string`

画面、运动与声音描述，支持中英文等多种语言。文生视频必填；有参考素材时可选。建议写在这里；按方舟写法放在 `metadata.content` 的 `{"type": "text", "text": "..."}` 里也可以，会合并为一段提示词。

**seconds** `integer`

视频时长，对应官方字段 `duration`：4–30 秒的整数。传 `-1` 或省略时由模型选择时长；视频编辑使用 `-1`。

**metadata** `object`

下表列出的参数使用火山方舟的[创建任务格式](https://docs.volcengine.com/docs/ark/create-video-generation-task-api?lang=zh)。模型和时长请用外层的 `model`、`seconds`。

**metadata.resolution** `string` (default: 720p)

分辨率：`480p`、`720p`（默认）。

**metadata.ratio** `string` (default: adaptive)

画面比例：`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`adaptive`（按内容自动决定）。首帧、首尾帧图生视频时必须为 `adaptive`，比例跟随首帧图片。

**metadata.generate\_audio** `boolean` (default: true)

是否同步生成与画面匹配的声音（对白、音效、背景音）。生成声音不额外收费。

**metadata.watermark** `boolean` (default: false)

是否在右下角加「AI 生成」水印。

**metadata.content** `object[]`

参考素材列表，每项形如 `{"type": "image_url", "image_url": {"url": "https://..."}, "role": "first_frame"}`，视频、音频把 `image_url` 换成 `video_url`、`audio_url`。`role` 取值：图片 `first_frame`（首帧）、`last_frame`（尾帧）、`reference_image`（参考图）；视频 `reference_video`；音频 `reference_audio`。首尾帧可以用同一张图。最多 10 张图片、5 个视频、5 个音频。视频和音频各自累计最多 30 秒。

**metadata.omni\_reference\_task\_type** `string` (default: auto)

多模态参考的任务类型：`auto`（模型自动判断）、`reference`（参考生成）、`extend`（视频延长）。显式指定时提交前就会校验参数，例如 `extend` 需要至少一个参考视频，并且 `ratio` 为 `adaptive`。`edit`（视频编辑）需要至少一个 4–30 秒的参考视频，比例为 `adaptive`，时长为 `-1`。

**metadata.output\_format** `string` (default: mp4)

输出文件格式，可选 `mp4`、`mov`。

**metadata.return\_last\_frame** `boolean` (default: false)

返回视频尾帧。成功后通过 `GET /v1/tasks/{id}/artifacts/last_frame/content` 下载尾帧。

**metadata.execution\_expires\_after** `integer` (default: 172800)

任务超时阈值，范围 3600–259200 秒。

**metadata.priority** `integer` (default: 0)

同一推理接入点内的任务执行优先级，范围 0–9。

**metadata.safety\_identifier** `string`

可选终端用户标识，最长 64 个字符。可使用对用户 ID 的哈希值。

**metadata.tools** `object[]`

传入 `[{"type":"web_search"}]` 允许模型按提示词自行检索。参数已通过提交测试，但两次实测的搜索调用计数均为 0，实际搜索执行尚未验收。

> [!WARNING]
>
> * 参考素材使用公网 HTTP(S) URL 或已配置的 `asset://` 素材，不支持 Base64。
> * 任务状态请通过查询接口轮询。Flash 仅支持在线推理，样片模式、`frames`、`seed`、`camera_fixed` 和 `callback_url` 不可用。

## 示例：文生视频

```bash theme={null}
curl https://token.poryf.com/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-5-flash-261115",
    "prompt": "清晨的海边，一只柯基在沙滩上奔跑，镜头缓慢跟随，能听到海浪声",
    "seconds": 5,
    "metadata": {
      "resolution": "720p",
      "ratio": "16:9"
    }
  }'
```

## 示例：首尾帧图生视频

```bash theme={null}
curl https://token.poryf.com/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-5-flash-261115",
    "prompt": "花朵从含苞到完全绽放",
    "seconds": 5,
    "metadata": {
      "content": [
        {"type": "image_url", "image_url": {"url": "https://example.com/first.jpg"}, "role": "first_frame"},
        {"type": "image_url", "image_url": {"url": "https://example.com/last.jpg"}, "role": "last_frame"}
      ]
    }
  }'
```

只传 `first_frame` 一张图即为首帧图生视频。

## 示例：多模态参考

用参考图确定人物形象，用参考视频确定动作和运镜：

```bash theme={null}
curl https://token.poryf.com/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-5-flash-261115",
    "prompt": "参考图片中的人物，按照参考视频的动作在城市街头跳舞",
    "seconds": 8,
    "metadata": {
      "resolution": "720p",
      "ratio": "9:16",
      "content": [
        {"type": "image_url", "image_url": {"url": "https://example.com/person.png"}, "role": "reference_image"},
        {"type": "video_url", "video_url": {"url": "https://example.com/dance.mp4"}, "role": "reference_video"}
      ]
    }
  }'
```

## 响应

提交成功后返回任务对象（示例结构）：

```json theme={null}
{
  "id": "task_xxxxxxxx",
  "object": "video",
  "model": "doubao-seedance-2-5-flash-261115",
  "status": "queued",
  "progress": 0
}
```

任务成功后查询，可能附带 `seedance` 字段，给出火山方舟返回的官方结果信息（示例结构）：

```json theme={null}
{
  "id": "task_xxxxxxxx",
  "object": "video",
  "model": "doubao-seedance-2-5-flash-261115",
  "status": "completed",
  "progress": 100,
  "seedance": {
    "model": "doubao-seedance-2-5-flash-261115",
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "framespersecond": 24,
    "generate_audio": true,
    "usage": { "completion_tokens": 108900, "total_tokens": 108900 }
  }
}
```

`seedance` 只在任务成功后出现，且不保证每次都有，请不要依赖它判断任务结果；以 `status` 为准。查询进度、下载视频的方法见 [视频通用说明](https://docs.token.poryf.com/api/videos/overview.md#查询进度)。

## 计费

按任务实际使用的视频 token 计费，口径与火山方舟官方一致。480p 与 720p 使用相同的 token 单价；带参考视频时使用独立计费档。实时单价见 [模型广场](https://token.poryf.com/pricing/doubao-seedance-2-5-flash-261115)。

token 数约等于 `视频时长（秒）× 宽 × 高 × 24 ÷ 1024`；带参考视频时，参考视频的时长也计入。例如 5 秒 720p（16:9）约 10.8 万 token。

提交时先预扣：时长按请求的 `seconds`，没传或传 `-1` 时按最长 30 秒；分辨率按 `metadata.resolution`，没传时按 720p。任务完成后按实际 token 多退少补（极少数情况下拿不到实际用量时，按预扣结算）；任务失败自动全额退回。

## 确认是官方原片

火山方舟生成的视频文件内嵌 C2PA 内容凭证。平台下载接口原样转发文件、不做转码，你可以自己校验：

* 网页：打开 [Content Credentials Verify](https://contentcredentials.org/verify)，上传下载的 MP4。
* 命令行：安装 [c2patool](https://github.com/contentauth/c2patool) 后执行 `c2patool video.mp4`。

凭证中会标明生成模型（例如 `doubao-seedance-2-5`）。视频经过剪辑、转码后凭证会失效。

## 下载与保存

完成后用 `GET /v1/videos/{id}/content` 下载所选格式的原始视频。平台会自动保存一份，约 30 天内可通过下载接口取回。

## 常见错误

| 出现时机 | 错误 | 原因 |
| - | - | - |
| 提交时返回 400 | `duration must be -1 or an integer between 4 and 30` | 时长超出 Flash 支持的范围 |
| 提交时返回 400 | `doubao-seedance-2-5-flash-261115 resolution must be one of …` | `metadata.resolution` 超出 Flash 支持的分辨率，例如 `1080p` |
| 提交时返回 400 / 503 | `分组 … 下模型 … 无可用渠道` 或其他说明 | 参考素材用了 Base64 / 文件，或用了 Draft 样片模式；改为公网 URL、去掉 Draft 字段后重试 |
| 提交时返回错误，或任务随后变为 `failed` | `InvalidParameter` 等火山方舟错误 | 参数不被模型接受，例如时长超出范围、分辨率写错、参考素材数量或时长超限、首尾帧时 `ratio` 不是 `adaptive`；错误信息给出具体字段。任务失败时费用自动退回 |

其他错误见 [排错指南](https://docs.token.poryf.com/errors.md)。

## 实际出片示例

以下为通过本平台生成的 4 秒原片，未转码，保留生成时的 AIGC / C2PA 元数据。

<video controls playsInline preload="metadata" poster="/images/seedance-2-5-flash-paper-boat.webp" src="https://mintcdn.com/2y/srLA2oFc4U2bsnu-/videos/seedance-2-5-flash-paper-boat.mp4?fit=max&auto=format&n=srLA2oFc4U2bsnu-&q=85&s=f985bddd472b767ad0ac3eb6347cc09a">
  您的浏览器不支持视频播放，请[下载原片](https://docs.token.poryf.com/videos/seedance-2-5-flash-paper-boat.mp4)。
</video>

提示词：一艘白色折纸船沿浅水缓慢漂过，近景镜头横移，水面反射暖色光线，配有柔和的雨声。

参数：`seconds: 4`，`resolution: 480p`，`ratio: 16:9`，`generate_audio: true`，`output_format: mp4`，`return_last_frame: true`。实际用量为 38,830 Token。

本例的 C2PA 签名和文件哈希校验通过；公共信任列表验证结果为 `signingCredential.untrusted`，不代表证书链已获该列表信任。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.