Black Forest Labs

FLUX 3 Max

flux-3-max/keyframes-to-video

支持文生视频与图生视频的视频生成模型，主打低延迟快速出片，公开基准称 10 秒片段约 11–12 秒生成，适合创意迭代与短视频素材

flux-3-max/image-to-video flux-3-max/keyframes-to-video flux-3-max/text-to-video

试用 flux-3-max/keyframes-to-video

输入

关键帧

作品灵感

查看全部作品

输出

video

填写参数并生成，结果会显示在这里。

价格

flux-3-max/keyframes-to-video 每秒

规格	单价
720P	$0.0608
1080P	$0.1036

定位简介

flux-3-max/keyframes-to-video 是 flux-3-max 家族的关键帧驱动图生视频线路：开发者给出提示词与最多 10 张关键帧图片，按帧索引把它们锚定在 24 fps 时间轴上的指定位置，由模型补全关键帧之间的运动与转场，输出 5 至 20 秒、720p 或 1080p 的视频。适合需要精确控制画面节奏的分镜预演、广告与短片素材制作团队，通过 HiAPI.ai 统一接口调用。

核心亮点

关键帧定点控制画面节奏——最多 10 张图片按帧索引落在时间轴任意位置，中间过程由模型补全，而非只给定首帧。
关键帧支持同步音频——默认开启音频生成，输出与画面同步的声音，减少后期配音环节。
推理强度可切换——reasoning_level 提供 low 与 high 两档，复杂场景用高强度提升解读质量，简单场景可压低延迟。

能力说明

关键帧时间轴编排：以 24 fps 为时间基准，用 frame_index 指定每张关键帧出现的位置，帧索引需唯一且不超过时长乘 24，实现逐段精确的画面叙事。

5 至 20 秒时长与双分辨率：duration 覆盖 5 到 20 秒，resolution 可选 720p 或 1080p，按输出秒数计费，便于按片段长度控制成本。

八种画幅与自动跟随：aspect_ratio 提供 21:9、16:9、1:1、9:16 等八种比例，auto 则沿用输入图像比例，一条线路覆盖横屏、竖屏与方形投放。

提示词与推理强度联动：prompt 最长 6000 字符，配合 reasoning_level 控制对复杂场景的解读深度，在画质与响应延迟之间取舍。

适用场景

分镜师与广告团队：关键画面加脚本——把已定稿的分镜图作为关键帧排入时间轴，产出节奏可控的动态分镜预演，用于客户提案与拍摄前评审。
品牌短片制作：产品图与旁白文案——以产品静帧为关键帧、提示词描述运镜与氛围，生成带同步音频的短素材，直接用于社媒投放与官网展示。
创意团队：多套关键帧方案对比——同一提示词下替换关键帧组合与画幅比例批量出片，产出多条候选视频用于快速迭代筛选。
竖屏内容创作者：9:16 关键帧序列——用竖屏画幅与 5 至 10 秒短时长产出短视频片段，作为发布素材或二次剪辑的中间资产。

限制与选型建议

该线路只接受图生视频输入，至少需要一张关键帧图片，纯文字起片应选择同家族 text-to-video 线路；输出分辨率限于 720p 与 1080p，时长上限 20 秒，更长或更高规格的成片需分段生成后拼接。high 推理强度会带来更高延迟，节奏简单的素材可改用 low。关键帧图片须为公开 HTTPS 地址，帧索引规划错误会导致排片不符预期，提交前需核对时间轴。

近期更新

查看更新日志 →

模型上新 flux-3-max/text-to-video 视频生成模型上线 Oct 31, 2026
价格调整 flux-3-max/text-to-video 价格调整 Oct 31, 2026
价格调整 flux-3-max/image-to-video 价格调整：新增定价 $0.0608 Oct 31, 2026

常见问题

查看全部常见问题 →

FLUX 3 Max 图生视频需要哪些输入？

必填 prompt 和 image_url（首帧图片，支持 PNG/JPEG/WebP）。可选 end_image_url 作为尾帧，以及 duration、resolution、aspect_ratio、generate_audio 和 reasoning_level。
可以设置视频时长吗？

可以。duration 取 5–20 之间的整数秒，按 1 秒步进，默认 5 秒；图生视频和文生视频共用同一套按秒价格。先用 5 秒确认源图是否稳定，再延长时间。
画幅由什么决定？

aspect_ratio 默认 auto，输出跟随首帧图片的比例；也可以手动指定 21:9、2:1、16:9、4:3、1:1、3:4 或 9:16。手动指定与图片比例不一致时，画面可能被裁切。
尾帧怎么用？

image_url 传首帧，end_image_url 传尾帧，视频会从首帧过渡到尾帧。提示词只写中间发生的变化，两张图的机位和光线越接近，过渡越平稳。

提交生成任务

POST https://api.hiapi.ai/v1/tasks

请求头

Authorizationstring必填

账号 API Key，所有请求必填。示例：Bearer YOUR_HIAPI_API_KEY。获取 API Key

Content-Typestring可选

请求体固定按 JSON 解析；如携带，仅接受 application/json（可带 charset），其他取值返回 415。示例：application/json。

Idempotency-Keystring可选

幂等键，最长 255 字节。同账户同键的重试只创建一次任务，重放返回首次 taskId。

幂等键

网络超时或客户端自动重试时，同键只创建一次任务、不会重复扣费（幂等范围 = API Key 所属账户）。建议用业务侧唯一标识做键（如 "order-42"）；同键重放返回首次 taskId，键在首次提交 24 小时后过期。详细的场景矩阵见统一异步接口介绍页。

请求体

modelstring必填

当前固定值：flux-3-max/keyframes-to-video

routestring可选

当前固定值：default

inputobject必填

flux-3-max/keyframes-to-video 和线路 default 的业务参数对象，见下方参数表。

promptstring必填minLength 1maxLength 6000

用于描述待生成视频内容的文本提示词，决定视频的画面与内容走向。

durationinteger可选默认值: 5min 5max 20

输出视频的时长，单位为秒，取值范围为 5 到 20，默认 5。

keyframesarray必填minItems 1maxItems 10

沿视频时间线放置的关键帧数组，最多 10 个；每个关键帧包含图片地址与帧序号，且各帧序号必须唯一、不得大于时长乘以 24。

Array [ object ]

数组元素

image_urlstring必填

该关键帧图片的公开 HTTPS 地址，支持 PNG、JPEG 或 WebP 格式。

frame_indexinteger必填min 0

该关键帧在 24 fps 时间线上的帧序号，最大值为时长乘以 24，且在同一数组内不得重复。

resolutionstring可选默认值: "720p"

输出视频的分辨率，默认 720p。

可选项：720p1080p

aspect_ratiostring可选默认值: "auto"

输出视频的宽高比；设为 auto 时跟随输入图片的宽高比，默认 auto。

可选项：auto21:92:116:94:31:13:49:16

generate_audioboolean可选默认值: true

是否在生成视频的同时生成与之同步的音频，默认开启（true）。

reasoning_levelstring可选默认值: "high"

控制解读提示词时投入的推理程度；设为 high 可改善复杂场景的生成效果，但延迟更高，默认 high。

可选项：lowhigh

callbackobject可选

终态通知配置；为空则不回调，由调用方自行查询。详见下方回调说明。

回调（Webhook）

创建任务时提供 callback.url，任务终态时 HiAPI 主动 POST 通知你的服务，可免去轮询。回调请求体与任务详情数据结构同构；签名校验、投递重试与幂等说明见统一异步接口介绍页的回调说明。

urlstring必填

callback 存在时必填；任务终态后向该 URL 发起 POST，须为合法 http(s) URL。

whenstring可选默认值: "final"

当前仅支持 final，即 success / fail 均回调。

可选项：final

storagestring可选默认值: "temp"

产物存储档位：temp（默认，保留约 7 天）或 persistent（长期保存，按大小计费）。余额不足或超出存储上限会静默降级为 temp；实际生效档位见任务详情响应。

可选项：temppersistent

请求示例

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "flux-3-max/keyframes-to-video",
  "input": {
    "prompt": "…",
    "duration": 5,
    "keyframes": "…",
    "resolution": "720p",
    "aspect_ratio": "auto",
    "generate_audio": true,
    "reasoning_level": "high"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "flux-3-max/keyframes-to-video",
    input: {
      "prompt": "…",
      "duration": 5,
      "keyframes": "…",
      "resolution": "720p",
      "aspect_ratio": "auto",
      "generate_audio": true,
      "reasoning_level": "high"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "flux-3-max/keyframes-to-video",
        "input": {
          "prompt": "…",
          "duration": 5,
          "keyframes": "…",
          "resolution": "720p",
          "aspect_ratio": "auto",
          "generate_audio": True,
          "reasoning_level": "high"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

获取任务详情

GET https://api.hiapi.ai/v1/tasks/:id

响应字段

taskIdstring必填

任务 ID，前缀固定 tk-hiapi-。

modelstring必填

解析后的模型全名。用 route 参数提交的任务返回 base@线路（如 gpt-image-2/text-to-image@ext）；否则与创建时传入的模型名一致。

routestring可选

仅当任务用显式 route 参数提交时出现，回显提交时的原值。

statusstring必填

任务状态。

状态枚举

queued 已入队，尚未开始。 handling 处理中。 archiving 处理完成，产物准备中。 success 终态：完成，产物可用（返回 output）。 fail 终态：失败（返回 error）。提交后按 status 判断：success 或 fail 为终态，其余为非终态，建议按 1~3 秒间隔轮询直至终态。成功终态后从 output[].url 下载产物，并在 expireAt 前完成下载或转存；需要长期保留时在创建任务时使用 storage: "persistent"。

creatednumber必填

任务创建时间（Unix 秒）。

completednumber必填

进入终态的 Unix 秒；非终态固定为 0。

outputarray可选

仅 status == success 时出现。产物列表，始终为数组，同一任务可能同时返回多个 type（如 video + first_frame）。

Array [ object ]

数组元素

urlstring必填

资源 URL，可直接下载。

typestring必填

当前可能值：video、image、audio、first_frame、last_frame、thumbnail，后续可能会扩展。

expireAtnumber必填

资源可访问截止时间（Unix 秒）；过期前请完成下载或转存。

errorobject可选

仅 status == fail 时出现。

codestring必填

业务错误码。

messagestring必填

错误描述。

响应示例

成功

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

处理中（非终态）

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

失败

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}