Skip to main content
POST

认证

string
必填
所有接口均需要使用 Bearer Token 进行认证访问 API Key 管理页面 获取 API Key:

生成模式

flux-3-video统一入口:按传参自动判定模式,也可 mode 显式指定。 mode 可选值:t2v / i2v / v2v / draft_enhance,或官方拼写 text-to-video / image-continuation / video-continuation显式 mode 优先级最高

图生视频关键帧语义

image_urls 中图片的顺序即语义,不要排序或去重:

请求参数

string
必填
固定值:flux-3-video
string
必填
提示词。草稿转正片(draft_from_task_id)时不能传,传了会被拒绝。
integer
默认值:"5"
时长(秒),5~20 的整数,默认 5
不支持 duration: "auto"(按秒计费需确定秒数)。不传、传 "auto" 或其它非整数 → 均按 5 秒,不报错也不自适应。
视频续写时,实际产出时长可能短于请求秒数(例如请求 5 秒产出 4 秒)。提交时按请求秒数预扣,出片后按实际计费秒数退还差额;最终以查询接口 cost 为准。文生 / 图生无此现象。
string
默认值:"hd"
分辨率
  • hd(默认;也接受 720p
  • fhd(也接受 1080p
实测:hd 约 16:9 时 1280×704;fhd 约 1920×1088。
草稿模式(draft:true只能使用 hd
string
默认值:"auto"
宽高比可选:21:92:116:94:31:13:49:16,或 auto(默认,按提示词与素材自动选择)
string[]
图生视频关键帧,1~10 张,公网 http(s) URL 或 base64
string
视频续写的输入视频(mp4,公网 URL 或 base64)
string[]
video_url,取数组第一个(兼容写法)
boolean
默认值:"true"
是否生成同步音频,默认 true。设为 false 出无声视频(不降价
boolean
默认值:"false"
草稿模式:约 1/3 价出低质预览,且只能配 resolution: hd
string
草稿转正片:指向自己的一条已成功的草稿任务 ID
  • 仅可改 resolution;提示词、时长、图片、视频一律不能改
  • 按正片全价计费,草稿费用不抵扣
  • draft:true 互斥
integer
默认值:"2"
内容审核宽松度 0~4,默认 2,越大越宽松
勿与 FLUX.2 图片(05)或 Kontext(06)混淆。
string
显式指定模式(可选),见「生成模式」

草稿模式

视频生成较贵时,可用两段式试稿:

出草稿

草稿转正片

草稿转正片会使用草稿保存的原始参数(模式 / 提示词 / 种子 / 素材)进行全质量渲染。视频续写草稿转正片按续写正片单价计费。

请求示例

文生视频(竖屏)

图生视频(首尾帧)

视频续写

无声视频

参数约束

常见提交错误(通常不扣费)

内容审核拒绝会进入 failed 终态并全额退款

能力覆盖

Response

integer
响应状态码,成功时为 200
array
返回数据数组
查询任务结果视频为异步任务。使用 获取任务状态 轮询。建议每 5~10 秒一次,客户端超时 15 分钟(20 秒 fhd 更慢)。实测 t2v + hd + 5 秒约 60 秒出片。成功后取 result.videos[0].url;产物已转存平台 CDN,长期可用。cost 为最终扣费金额。失败全额退款。