模型名称flux-3-video 使用 POST /v1/videos 提交任务,使用 GET /v1/videos/{task_id} 查询状态与结果。

请求参数

当前不支持参考视频、参考音频、视频续写、草稿和草稿转正片工作流。

提交任务

受理响应

提交受理成功后会立即返回任务,不代表视频已经生成完成:
参数不符合本页约束时,接口会返回 HTTP 400:

查询任务

使用提交响应中的 id 替换 {task_id} 轮询任务;完成后从 url 取得视频文件:

异步状态与失败响应

视频任务状态只使用 queuedin_progresscompletedfailed。处于 queuedin_progress 时继续调用查询接口;只有 completed 状态才读取顶层 result_url 任务失败时保持视频对象结构,并返回顶层 errorfail_reason,不要按图片接口读取 code/data/works

使用说明

  1. 请求需携带 Authorization: Bearer YOUR_API_KEY;参数范围以本页请求表为准。
  2. 任务处于 queuedin_progress 时请继续查询;只有 completed 状态才表示可以读取 result_url
  3. 参考素材必须是调用方可访问的 URL,并遵守本页给出的数量和组合限制。