> ## 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.0 Mini

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

字节跳动 Seedance 2.0 Mini，火山方舟官方视频模型，Seedance 2.0 系列中价格最低的版本。支持文生视频、首帧 / 首尾帧图生视频，以及用图片、视频、音频做多模态参考生成，可同步生成音频。

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

> [!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-0-mini-260615`

**prompt** `string`

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

**seconds** `integer`

视频时长，对应官方字段 `duration`：4–15 秒的整数，默认 5。

**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`。首尾帧可以用同一张图。最多 9 张图片、3 个视频、3 个音频，不能只传音频；参考视频、参考音频累计时长不超过 15 秒。

> [!WARNING]
>
> * 图片、视频、音频请使用公网可访问的 `http(s)` URL，不要上传文件或使用 Base64。
> * 请不要使用 Draft 样片模式（`draft`、`draft_task`）、`callback_url` 回调和时长 `-1`：它们不保证可用。请轮询查询任务状态。

## 示例：文生视频

```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-0-mini-260615",
    "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-0-mini-260615",
    "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-0-mini-260615",
    "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-0-mini-260615",
  "status": "queued",
  "progress": 0
}
```

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

```json theme={null}
{
  "id": "task_xxxxxxxx",
  "object": "video",
  "model": "doubao-seedance-2-0-mini-260615",
  "status": "completed",
  "progress": 100,
  "seedance": {
    "model": "doubao-seedance-2-0-mini-260615",
    "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 同价；带参考视频的任务单价更低。实时单价见 [模型广场](https://token.poryf.com/pricing/doubao-seedance-2-0-mini-260615)。

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

提交时先预扣：时长按请求的 `seconds`，没传时按最长 15 秒；分辨率按 `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` 下载 MP4。任务成功后平台会自动保存一份视频，约 30 天内都可以下载，文件和生成时完全一致。保存还没完成或保存失败时，下载改用火山方舟的源文件链接，这个链接约 24 小时后失效。30 天后无法再取回，请在这之前下载，转存到自己的存储。

## 常见错误

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

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


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