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

# FLUX 3 Video

> Black Forest Labs FLUX 3 Video：文生、关键帧、视频续写，带同步音频，按分辨率档 × 秒数计费

FLUX 3 Video 是 Black Forest Labs 的视频模型，从文本、1–10 张有序关键帧或一段续写视频生成 5–20 秒带同步音频的片段。本页覆盖标准档 `flux-3-video` 与草稿档 `flux-3-video-draft`：两档参数集合完全相同，草稿档只出 `hd`、画质更低、单价更低，适合先快速看效果再用标准档出片。换档只改 `model`，两档之间不会自动切换。

## 快速开始

<CodeGroup>
  ```bash 文生视频 theme={"system"}
  curl -X POST https://www.qingbo.dev/v1/tasks \
    -H "Authorization: Bearer $WAVE_API_KEY" \
    -H "Content-Type: application/json" \
    -H "Idempotency-Key: flux-video-001" \
    -d '{
      "model": "flux-3-video",
      "action": "generate",
      "prompt": "雨夜的东京街头，霓虹倒映在积水里，一个人撑伞走过",
      "resolution": "fhd",
      "aspect_ratio": "9:16",
      "duration": 8
    }'
  ```

  ```bash 关键帧 theme={"system"}
  curl -X POST https://www.qingbo.dev/v1/tasks \
    -H "Authorization: Bearer $WAVE_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "flux-3-video",
      "action": "generate",
      "prompt": "花苞缓缓绽放，镜头慢慢推进",
      "image_urls": [
        "https://cdn.example.com/bud.jpg",
        "https://cdn.example.com/bloom.jpg"
      ],
      "resolution": "hd",
      "duration": 5
    }'
  ```

  ```bash 视频续写 theme={"system"}
  curl -X POST https://www.qingbo.dev/v1/tasks \
    -H "Authorization: Bearer $WAVE_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "flux-3-video",
      "action": "generate",
      "prompt": "镜头继续跟随主角走向远处的灯塔",
      "video_urls": ["https://cdn.example.com/clip.mp4"],
      "resolution": "hd",
      "duration": 5
    }'
  ```

  ```bash 草稿档预览 theme={"system"}
  curl -X POST https://www.qingbo.dev/v1/tasks \
    -H "Authorization: Bearer $WAVE_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "flux-3-video-draft",
      "action": "generate",
      "prompt": "日出时分安静的海边天文台，镜头固定，画面无文字",
      "resolution": "hd",
      "duration": 5,
      "generate_audio": false
    }'
  ```
</CodeGroup>

提交成功后返回 `task_id`。用 [`GET /v1/tasks/{task_id}`](/cn/api-reference/task/status) 查询结果，也可以用 [`Prefer: wait`](/cn/api-reference/task/submit#请求内等待prefer-wait) 在一次调用里等待，或配置 Webhook。

## 请求参数

<ParamField body="model" type="string" required>
  二选一：`flux-3-video` 或 `flux-3-video-draft`。
</ParamField>

<ParamField body="action" type="string" default="generate">
  `generate` —— 两档都只支持这一个动作。文生、关键帧和视频续写靠传什么素材区分，不靠动作区分。
</ParamField>

<ParamField body="prompt" type="string" required>
  视频内容描述。
</ParamField>

<ParamField body="image_urls" type="string[]">
  关键帧图片，1–10 张，顺序有意义：1 张为首帧，2 张为首帧 + 末帧，3–10 张时首尾为首末帧、中间帧按时间等距分布。与 `video_urls` 不能同时传。
</ParamField>

<ParamField body="video_urls" type="string[]">
  续写视频，最多 1 条，最长 20 秒。传了之后模型接着这段视频往下生成。
</ParamField>

<ParamField body="resolution" type="string" default="hd">
  输出分辨率。`flux-3-video` 支持 `hd` 与 `fhd`；`flux-3-video-draft` 只支持 `hd`。
</ParamField>

<ParamField body="duration" type="integer" default="5">
  输出时长（秒），`5`–`20` 任意整数。
</ParamField>

<ParamField body="aspect_ratio" type="string" default="auto">
  画面比例：`21:9`、`2:1`、`16:9`、`4:3`、`1:1`、`3:4`、`9:16`，或 `auto`（由模型按提示词与素材决定）。
</ParamField>

<ParamField body="generate_audio" type="boolean" default="true">
  是否生成同步音频。设为 `false` 输出无声视频，单价不变。
</ParamField>

<ParamField body="safety_tolerance" type="integer" default="2">
  安全容忍度，`0`–`4`，越大越宽松。
</ParamField>

通用的 `callback_url`、`callback_events`、`Prefer: wait`、`Idempotency-Key` 和费用上限请求头见[提交任务](/cn/api-reference/task/submit)。

两档都不接受 `n`、`seed`、`quality`、`negative_prompt`、`first_frame_image` 与 `audio_urls`。以上之外的参数会返回 `400`，不计费。

## 限制

| 条件                        | 限制                                                     |
| ------------------------- | ------------------------------------------------------ |
| 每次任务                      | 每次任务只生成一个视频；关键帧图片 1–10 张（顺序有意义：首帧、末帧、中间帧等距），续写视频最多 1 条 |
| 传了 `video_urls`           | 视频续写模式下图片会被忽略，不要同时传                                    |
| 续写视频时长                    | 最长 20 秒                                                |
| `flux-3-video-draft` 的分辨率 | 只有 `hd`                                                |

## 计费

两档都按**分辨率档 × 输出秒数**计费。`price_config.video_prices` 按分辨率分键，未单独列出的分辨率按同级的 `default` 兜底档结算。

| 模型 ID                | 分辨率档       | 续写档                            |
| -------------------- | ---------- | ------------------------------ |
| `flux-3-video`       | `hd`、`fhd` | `hd_video_ref`、`fhd_video_ref` |
| `flux-3-video-draft` | `hd`       | `hd_video_ref`                 |

**续写档**——传了 `video_urls` 时，输出秒数按 `<分辨率>_video_ref` 档单价结算，这一档比同分辨率的普通档贵。续写视频本身的秒数不单独计费。

`generate_audio` 不影响价格：有声与无声同价。`aspect_ratio`、关键帧张数、提示词长度同样不影响价格——**分辨率档、是否续写、输出秒数是仅有的三个计费维度**。

只有成功出片才计费。任务失败、取消，或没有返回可用视频时，全额退款。最终费用以任务响应里的 `cost` 为准——整数 quota，**500,000 quota = 1 USD**，不是美元。

<Note>
  **本页不列具体单价**。单价随上游调整，本节只讲计费维度与口径。

  实时单价见 `GET /v1/models` 返回的 `price_config`，或控制台「模型市场」。
  单次调用的实际费用见任务响应里的 `cost`（整数 quota，500,000 quota = 1 USD）。
</Note>

## 响应

```json 任务完成 theme={"system"}
{
  "task_id": "taski-a70bafe415a1a1c4280cc3693261fa80-task-wave1788780141b950265604",
  "model": "flux-3-video-draft",
  "action": "generate",
  "status": "completed",
  "progress": "100%",
  "created_at": 1788780141,
  "completed_at": 1788780199,
  "billing_status": "settled",
  "cost": 135000,
  "result": {
    "videos": [
      {
        "expires_at": 1789089508,
        "url": ["https://cdn.example.com/result.mp4"]
      }
    ]
  },
  "urls": {
    "get": "https://www.qingbo.dev/v1/tasks/taski-a70bafe415a1a1c4280cc3693261fa80-task-wave1788780141b950265604",
    "cancel": "https://www.qingbo.dev/v1/tasks/taski-a70bafe415a1a1c4280cc3693261fa80-task-wave1788780141b950265604/cancel"
  }
}
```

`result.videos` 返回生成的视频，`url` 是数组，`expires_at` 是视频链接的过期时间戳。完整字段说明见[查询任务状态](/cn/api-reference/task/status)。

## 可用模型

| 模型 ID                | 档位 | 分辨率        | 时长（秒）    | 可传的媒体输入                             |
| -------------------- | -- | ---------- | -------- | ----------------------------------- |
| `flux-3-video`       | 标准 | `hd` `fhd` | `5`–`20` | `image_urls` 1–10 · `video_urls` ≤1 |
| `flux-3-video-draft` | 草稿 | 仅 `hd`     | `5`–`20` | `image_urls` 1–10 · `video_urls` ≤1 |

两档共用同一套参数、同样的关键帧语义和同样的画幅集合，差别只在可用分辨率与单价。

## 相关文档

* [视频生成概述](/cn/api-reference/video/overview)
* [FLUX 系列](/cn/api-reference/image/flux)
* [提交任务](/cn/api-reference/task/submit)
* [查询任务状态](/cn/api-reference/task/status)
* [任务系统](/cn/docs/task-system)