跳转到内容
HiAPI Docs
HiAPI
在线试用 获取 API Key
中文
English 中文

FLUX.3 Video API

POST /v1/tasks

图片、视频和音频模型通过 统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

模型名称 flux-3
类型 文生视频 / 图生视频 / 视频续写
接口 POST /v1/tasks
价格 见 HiAPI 定价

FLUX.3 Video 将文生视频、1-10 张关键帧图生视频和视频续写整合在一个模型中，支持最长 20 秒、720p/1080p 与可选原生同步音频。

生产建议

生产环境建议
  • 生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
  • GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
  • callback.when 当前建议固定为 final；success 和 fail 都可能触发终态通知，你的服务端需要按 taskId 做幂等处理。

适用场景

带声音的叙事短片

在一次生成中协调画面、环境声、音效和对白，适合广告概念片、剧情分镜与社交内容。

promptgenerate_audio
首尾帧与故事板控制

用 1 张图片固定首帧、2 张固定首尾帧，或用 3-10 张图片组织多关键帧故事板。

imagesduration
视频续写

从最长 15 秒的 MP4 尾部继续画面和声音，适合延展已有镜头。

start_videoduration
低成本提示词预演

先用 Draft 720p 验证构图与动作，再切换完整质量或 1080p。

draftresolution

请求参数

model string 必填

固定填 flux-3。

示例 flux-3
input object 必填

业务参数对象；FLUX.3 Video 的模型专属配置都放在这里。

prompt string 必填

描述场景、动作、运镜、对白与声音；模型会在生成前理解并扩展提示词。

images string[] 可选

可选 PNG、JPEG 或 WebP 图片，最多 10 张。1 张作为首帧，2 张作为首尾帧，3-10 张组成均匀分布的关键帧故事板。不能与 start_video 同时使用。

start_video string 可选

可选 MP4 起始视频，模型会从其末尾继续生成。文件最大 50 MB、最长 15 秒，不能与 images 同时使用。

aspect_ratio enum 可选

输出画幅。auto 会根据提示词和媒体输入自动选择比例。

默认 auto 可选值: auto21:92:116:94:31:13:49:16
resolution enum 可选

输出分辨率。Draft 模式仅支持 720p。

默认 720p 可选值: 720p1080p
duration integer 可选

生成视频的时长，范围为 5-20 秒；明确时长便于提交前准确预估费用。

默认 5
generate_audio boolean 可选

生成与画面同步的环境声、对白和音效；关闭后输出无声视频。

默认 true
draft boolean 可选

生成更快、成本更低的 720p 预览，而不是完整质量视频。

默认 false
callback object 可选

可选回调配置；设置后任务进入终态时 HiAPI 会主动通知你的服务，减少轮询。

url string 必填

传入 callback 时必填；接收任务终态通知的 HTTPS 地址。

示例 https://your-domain.com/hiapi/callback
when enum 可选

回调触发时机；当前建议固定为 final。

默认 final 可选值: final

用例示例

电影感文生视频

使用 16:9、720p 和原生音频生成 5 秒镜头。

请求体
{
  "model": "flux-3",
  "input": {
    "prompt": "A silver maglev train glides through a solar-panel field at golden hour, low tracking shot, cinematic lighting and stable motion",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5,
    "generate_audio": true,
    "draft": false
  }
}
双关键帧图生视频

第一张图片作为首帧，第二张作为尾帧；两者不能与 start_video 同时使用。

请求体
{
  "model": "flux-3",
  "input": {
    "prompt": "A smooth cinematic transition from sunrise to a neon-lit night city, stable camera motion",
    "images": [
      "https://example.com/start.webp",
      "https://example.com/end.webp"
    ],
    "resolution": "1080p",
    "duration": 8,
    "generate_audio": true
  }
}
Draft 视频续写

从已有 MP4 的末尾继续生成低成本 720p 预览。

请求体
{
  "model": "flux-3",
  "input": {
    "prompt": "Continue the forward camera move as the train enters a bright mountain tunnel",
    "start_video": "https://example.com/source.mp4",
    "resolution": "720p",
    "duration": 5,
    "generate_audio": true,
    "draft": true
  }
}

获取结果

  1. 提交成功后立即返回 taskId（不等待生成完成）。
  2. 生产环境优先等待 callback.url 收到终态通知；本地调试时可轮询 GET /v1/tasks/:id。
  3. status=success 后，从返回的 output[].url 下载生成的视频。
  4. 如果 status=fail，按返回的错误信息修正请求，不要盲目重试同一个无效请求。

常见问题

FLUX.3 Video 最长能生成多久？

每次请求可明确设置 5-20 秒的生成时长。作为输入的 start_video 最长为 15 秒。

怎样使用多张图片控制时间线？

传 1 张图片时固定首帧，2 张时固定首尾帧，3-10 张时按时间均匀组成故事板。images 不能和 start_video 一起使用。

Draft 和完整质量有什么区别？

Draft 是更快、更低成本的 720p 预览档，不能选择 1080p。完整质量支持 720p 和 1080p。

FLUX.3 Video 如何计费？

按生成秒数计费，具体费率取决于分辨率、Draft 模式和是否续写视频。 查看实时视频 API 价格

下一步