FLUX 3 Video

POST

tasks

FLUX 3 Video

curl --request POST \
  --url https://api.qingbo.ai/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "image_urls": [
    "<string>"
  ],
  "video_urls": [
    "<string>"
  ],
  "resolution": "<string>",
  "duration": 123,
  "aspect_ratio": "<string>",
  "generate_audio": true,
  "safety_tolerance": 123,
  "ref_task_id": "<string>"
}
'

import requests

url = "https://api.qingbo.ai/v1/tasks"

payload = {
    "model": "<string>",
    "action": "<string>",
    "prompt": "<string>",
    "image_urls": ["<string>"],
    "video_urls": ["<string>"],
    "resolution": "<string>",
    "duration": 123,
    "aspect_ratio": "<string>",
    "generate_audio": True,
    "safety_tolerance": 123,
    "ref_task_id": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    action: '<string>',
    prompt: '<string>',
    image_urls: ['<string>'],
    video_urls: ['<string>'],
    resolution: '<string>',
    duration: 123,
    aspect_ratio: '<string>',
    generate_audio: true,
    safety_tolerance: 123,
    ref_task_id: '<string>'
  })
};

fetch('https://api.qingbo.ai/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.qingbo.ai/v1/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"resolution\": \"<string>\",\n  \"duration\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"generate_audio\": true,\n  \"safety_tolerance\": 123,\n  \"ref_task_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.qingbo.ai/v1/tasks")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"resolution\": \"<string>\",\n  \"duration\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"generate_audio\": true,\n  \"safety_tolerance\": 123,\n  \"ref_task_id\": \"<string>\"\n}")
  .asString();

FLUX 3 Video 是 Black Forest Labs 的视频模型，从文本、1–10 张有序关键帧或一段续写视频生成 5–20 秒带同步音频的片段。本页覆盖标准档 flux-3-video 与草稿档 flux-3-video-draft：两档生成参数相同，草稿档只出 hd、画质更低、单价更低。草稿满意后，可用 flux-3-video 的 finalize 把它转成终稿。

快速开始

curl -X POST https://api.qingbo.ai/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
  }'

curl -X POST https://api.qingbo.ai/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
  }'

curl -X POST https://api.qingbo.ai/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
  }'

curl -X POST https://api.qingbo.ai/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
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-3-video",
    "action": "finalize",
    "ref_task_id": "task-wave1788780141b950265604",
    "resolution": "fhd"
  }'

提交成功后返回 task_id。用 GET /v1/tasks/{task_id} 查询结果，也可以用 Prefer: wait 在一次调用里等待，或配置 Webhook。 接着往下做：先用 flux-3-video-draft 提交 action: "generate" 拿到 task_id；任务 completed 后，把这个 task_id 作为 ref_task_id，用 flux-3-video 提交 action: "finalize"。提示词、时长、画幅和素材沿用草稿，只能改 resolution。

请求参数

string

必填

二选一：flux-3-video 或 flux-3-video-draft。

string

默认值:"generate"

generate：生成视频，两档都支持。文生、关键帧和视频续写由传入的素材决定。
finalize：草稿转终稿，只有 flux-3-video 支持；必须提供 ref_task_id。

string

视频内容描述，action: "generate" 时必填；action: "finalize" 不接受。

string[]

关键帧图片，1–10 张，顺序有意义：1 张为首帧，2 张为首帧 + 末帧，3–10 张时首尾为首末帧、中间帧按时间等距分布。与 video_urls 不能同时传。action: "finalize" 不接受。

string[]

续写视频，最多 1 条，最长 20 秒。传了之后模型接着这段视频往下生成。action: "finalize" 不接受。

string

默认值:"hd"

输出分辨率。flux-3-video 支持 hd 与 fhd（finalize 同样可选）；flux-3-video-draft 只支持 hd。

integer

默认值:"5"

输出时长（秒），5–20 任意整数。action: "finalize" 不接受，沿用草稿时长。

string

默认值:"auto"

画面比例：21:9、2:1、16:9、4:3、1:1、3:4、9:16，或 auto（由模型按提示词与素材决定）。

boolean

默认值:"true"

是否生成同步音频。设为 false 输出无声视频，单价不变。

integer

默认值:"2"

安全容忍度，0–4，越大越宽松。仅 action: "generate"。

string

要转成终稿的草稿任务 ID，action: "finalize" 时必填。取本账户下已完成的 flux-3-video-draft 任务返回的 task_id。

通用的 callback_url、callback_events、Prefer: wait、Idempotency-Key 和费用上限请求头见提交任务。两档都不接受 n、seed、quality、negative_prompt、first_frame_image 与 audio_urls。以上之外的参数会返回 400，不计费。action: "finalize" 时 aspect_ratio 与 generate_audio 不生效。

限制

条件	限制
每次任务	每次任务只生成一个视频；关键帧图片 1–10 张（顺序有意义：首帧、末帧、中间帧等距），续写视频最多 1 条
传了 `video_urls`	视频续写模式下图片会被忽略，不要同时传
续写视频时长	最长 20 秒
`flux-3-video-draft` 的分辨率	只有 `hd`
`action: "finalize"`	草稿转终稿只接受草稿任务（ref_task_id）与分辨率；提示词、时长、图片和视频沿用草稿，不能再传。

计费

两档都按分辨率档 × 输出秒数计费。传了 video_urls（续写）时改按同分辨率的续写档计，续写档高于普通档；续写视频本身的秒数不计费。

请求	单价档	计费秒数
`flux-3-video` · `generate`	`hd` / `fhd`，续写时为对应续写档	请求的 `duration`
`flux-3-video-draft` · `generate`	`hd`，续写时为 `hd` 续写档	请求的 `duration`
`flux-3-video` · `finalize`	终稿的 `hd` / `fhd`，草稿是续写时为对应续写档	草稿的时长

finalize 单独计一次终稿费用，草稿费不抵扣。generate_audio、aspect_ratio、关键帧张数与提示词长度都不影响价格。

各模型的单价见 GET /v1/models 返回的 price_config，或控制台「模型市场」。看这一单实际花了多少：任务响应里的 cost（整数 quota，500,000 quota = 1 USD）。

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

响应

任务完成

{
  "task_id": "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://api.qingbo.ai/v1/tasks/task-wave1788780141b950265604",
    "cancel": "https://api.qingbo.ai/v1/tasks/task-wave1788780141b950265604/cancel"
  }
}

result.videos 返回生成的视频，url 是数组，expires_at 是视频链接的过期时间戳。完整字段说明见查询任务状态。

可用模型

模型 ID	动作	分辨率	时长（秒）	可传的媒体输入
`flux-3-video`	`generate` `finalize`	`hd` `fhd`	`5`–`20`	`image_urls` 1–10 · `video_urls` ≤1
`flux-3-video-draft`	`generate`	仅 `hd`	`5`–`20`	`image_urls` 1–10 · `video_urls` ≤1

相关文档

FLUX 3 Video

curl --request POST \
  --url https://api.qingbo.ai/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "image_urls": [
    "<string>"
  ],
  "video_urls": [
    "<string>"
  ],
  "resolution": "<string>",
  "duration": 123,
  "aspect_ratio": "<string>",
  "generate_audio": true,
  "safety_tolerance": 123,
  "ref_task_id": "<string>"
}
'

import requests

url = "https://api.qingbo.ai/v1/tasks"

payload = {
    "model": "<string>",
    "action": "<string>",
    "prompt": "<string>",
    "image_urls": ["<string>"],
    "video_urls": ["<string>"],
    "resolution": "<string>",
    "duration": 123,
    "aspect_ratio": "<string>",
    "generate_audio": True,
    "safety_tolerance": 123,
    "ref_task_id": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    action: '<string>',
    prompt: '<string>',
    image_urls: ['<string>'],
    video_urls: ['<string>'],
    resolution: '<string>',
    duration: 123,
    aspect_ratio: '<string>',
    generate_audio: true,
    safety_tolerance: 123,
    ref_task_id: '<string>'
  })
};

fetch('https://api.qingbo.ai/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.qingbo.ai/v1/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"resolution\": \"<string>\",\n  \"duration\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"generate_audio\": true,\n  \"safety_tolerance\": 123,\n  \"ref_task_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.qingbo.ai/v1/tasks")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"resolution\": \"<string>\",\n  \"duration\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"generate_audio\": true,\n  \"safety_tolerance\": 123,\n  \"ref_task_id\": \"<string>\"\n}")
  .asString();

文本生成

图像生成

视频生成

音频处理

工具与嵌入

任务管理

账户与用量

快速开始

请求参数

限制

计费

响应

可用模型

相关文档

​快速开始

​请求参数

​限制

​计费

​响应

​可用模型

​相关文档

快速开始

请求参数

限制

计费

响应

可用模型

相关文档