FLUX 视频生成（flux-3-video）

Black Forest Labs 的 FLUX 3 视频模型：文生视频、图生视频（关键帧）和视频续写，可同步生成对白、音效和环境音。接口采用 BFL 官方格式，异步执行：提交任务 → 轮询结果 → 下载视频。

POST https://studio.dataeyes.ai/flux/v1/flux-3-video
GET  https://studio.dataeyes.ai/flux/v1/get_result?id={id}

鉴权使用模型 API Key，Authorization: Bearer sk-xxx 与 BFL 官方的 x-key: sk-xxx 均可。

快速示例

cURL

Python

提交成功后立即返回任务 ID 和查询地址：

{
  "id": "d969c847-daef-4ba8-857c-ecda7c4977f1",
  "polling_url": "https://studio.dataeyes.ai/flux/v1/get_result?id=d969c847-daef-4ba8-857c-ecda7c4977f1"
}

查询结果

生成中：

{ "id": "d969c847-daef-4ba8-857c-ecda7c4977f1", "status": "Generating" }

完成后：

{
  "id": "d969c847-daef-4ba8-857c-ecda7c4977f1",
  "status": "Ready",
  "result": {
    "sample": "https://storage.fonedis.cc/……/content.mp4?Expires=……"
  }
}

失败时：

{
  "id": "340a951d-1a67-4eed-9dbc-a88b4588eeed",
  "status": "Error",
  "details": "background worker died while task was queued (heartbeat lost)"
}

`status`	说明
`Pending`	排队中
`Generating`	生成中
`Ready`	已完成，视频地址在 `result.sample`
`Error`	失败，原因在 `details` 字段

实测 5 秒 hd 视频从提交到完成约 2～3 分钟，建议每 10 秒左右查询一次。result.sample 是带签名的临时链接（实测约 2 小时后过期），请在完成后及时下载转存。

三种模式

通过 mode 指定模式，不同模式需要的字段不同：

`mode`	用途	必填字段	`duration` 范围
`t2v`	文生视频	`prompt`	5～20 秒
`i2v`	图生视频（关键帧）	`prompt`、`keyframes`	5～20 秒
`v2v`	视频续写	`prompt`、`start_video`	5～15 秒

图生视频 i2v

视频续写 v2v

keyframes 是 [秒数, 图片] 的数组，1～10 组，秒数需在 0 到 duration 之间。传一组 [0, 图片] 即用该图作为开头画面；传 [0, 图1] 和 [5, 图2] 即指定首尾帧。图片使用公网 URL。

请求参数

参数	类型	必填	说明
`mode`	string	是	`t2v`、`i2v`、`v2v`
`prompt`	string	是	画面、动作、光线和声音的描述；需要角色说话时，把台词写在引号里
`duration`	integer	是	视频时长（秒），整数。`t2v`、`i2v` 为 5～20，`v2v` 为 5～15
`resolution`	string	否	`hd`（默认）、`fhd`、`qhd`、`uhd`，也可写 `720p`、`1080p`、`2k`、`4k`，见下方「分辨率」
`aspect_ratio`	string	否	`auto`（默认，按提示词与参考图自动选择）、`21:9`、`2:1`、`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`9:21`
`generate_audio`	boolean	否	是否同步生成声音，默认 `true`；`false` 输出无声视频
`keyframes`	array	`i2v` 必填	`[秒数, 图片 URL]` 数组，1～10 组
`start_video`	string	`v2v` 必填	待续写视频的 mp4 公网 URL
`safety_tolerance`	integer	否	内容审核宽松度，0（最严格）～4

备注

暂不支持 BFL 的草稿模式：传 draft 或 mode: "draft_enhance" 会返回 400。

分辨率

实测 hd + 16:9 输出 1280×704，5.04 秒，带音轨。四个档位与计费档位对应如下：

`resolution`	等价写法	计费档位
`hd`	`720p`	720p
`fhd`	`1080p`	1080p
`qhd`	`2k`	2k
`uhd`	`4k`	4k

计费

按生成时长（秒）× 分辨率档位单价计费；视频续写（v2v）按「含视频输入」的单价计费。各档单价见模型广场中 flux-3-video 的详情，扣费明细见使用日志。提交时按请求参数预扣，参数校验失败的请求不扣费。

FLUX 视频生成（flux-3-video）

快速示例#

查询结果#

三种模式#

请求参数#

分辨率#

计费#

常见问题#

快速示例

查询结果

三种模式

请求参数

分辨率

计费

常见问题