fal H3 Max API 指南:预览与 Director 接入

选择正确的 fal H3 Max 接口,保护 FAL_KEY,打开 Director WebRTC 会话,发送提示词版本,并围绕 60 秒最低计费设计积分。
2026/09/04

应该使用哪个 fal H3 Max API?

  • minimax/h3-max/text-to-video:从文字生成一条完成的短片。
  • minimax/h3-max/image-to-video:从图片生成一条完成的短片。
  • minimax/h3-max/director:打开连续 WebRTC 流,并在运行中接受新的提示词版本。

不要把多个有限短片串起来称为 Director。它们的传输方式、计费、失败模式和用户体验都不同。

推荐的浏览器架构

FAL_KEY 必须只保留在服务端。浏览器通过严格限制的服务端代理连接:代理只允许 minimax/h3-max/director,校验登录用户和短期付费会话票据,并拒绝其他 fal 目标。

浏览器 -> POST /api/live/session -> 预扣积分并签发票据
浏览器 -> /api/fal/proxy         -> 仅允许已授权协商
浏览器 <-> fal WebRTC            -> 连续视听流与控制数据

代理不能成为任意 fal 接口的通用转发器。会话创建需要限流,票据应绑定用户与生成任务。

控制消息与状态

公开的 Director AsyncAPI 合同定义了控制通道。客户端应只发送一次 configure,以后每条 prompt 都递增 prompt_version,并以 prompt_pendingprompt_appliedprompt_rejected 等提供商事件作为真实状态,而不是用假的进度计时器。

还需要处理 chunkdeadline_missedstream_exhaustederror,并在付费时间结束时发送 stop、关闭媒体轨道。

计费与退款边界

创建会话前应原子预扣积分。如果 fal 接受会话前协商失败,可以退回预扣积分。一旦提供商会话开始,60 秒最低成本已经发生,用户断线不应自动全额退款。

截至 2026 年 9 月 4 日,fal 公布的前两周促销价为每视频秒 $0.02,标准价为每秒 $0.08。实际接入前应再次查看 H3 Max Director 官方页面

查看完整产品层

AIR Live 在上述基础设施之上增加可见导演队列、60 秒倒计时、语音转指令以及独立的低成本预览模式。打开导演台查看完整产品约定。

把 fal H3 Max API 接成完整创作流程

先选 fal H3 Max API 的交付形式

fal H3 Max API 包含有限生成与实时连接两类约定。先决定需要怎样的 fal H3 Max API 行为,再选择播放器:成片文件可以独立回放,Director 则交付活动媒体流,并继续接收后面的场景指令。

fal H3 Max API 接入不止一个请求函数。完整的 fal H3 Max API 产品还要检查登录与操作权限,提前展示积分要求,解释失败状态,并让用户在生成结束之后仍然能够找到实际输出。

fal H3 Max API 密钥留在服务端

不要把长期 fal H3 Max API 密钥放进浏览器代码。客户端应该经过已鉴权的服务端边界访问 fal H3 Max API,由服务端检查用户和允许执行的操作,而不是把知道页面地址当作调用资格。

fal H3 Max API 代理也要受到保护,不能只检查创建入口。隐藏 fal H3 Max API 的按钮不是权限控制;直接发请求、登录过期或第二个标签页余额过时,都不应该绕开应用对身份和生成资格的判断。

处理 fal H3 Max API 的排队短片

有限短片应跟随 fal H3 Max API 返回的队列地址,并保留请求身份,直到完成或明确失败。fal H3 Max API 返回视频地址之后,界面应出现真正能够播放的结果,而不是只增加一条看似成功的文字日志。

保存足够的 fal H3 Max API 结果信息,才能再次找到同一条请求。fal H3 Max API 的上传或下载重试不应重新生成;供应商拒绝、等待超时与存储故障,也不应该都被界面包装成成功制作了一条新视频。

Director 使用 fal H3 Max API 实时连接

Director 使用 fal H3 Max API 的实时客户端,而不是普通短片队列。先配置开场,再发送递增的提示词版本,fal H3 Max API 的媒体通过当前 WebRTC 连接继续返回,后续指令改变即将生成的场景。

不要丢掉启动期间收到的 fal H3 Max API 指令。它们应该暂存在当前尝试中,连接就绪后顺序发送,取消时一起清除。为这些句子再开一个会话,会同时改变用户体验与供应商费用边界。

语音在 fal H3 Max API 上层处理

这里交给 fal H3 Max API 的是场景指令,不是原始麦克风音频。浏览器先识别,Evolink 整理完整文字,再进入 fal H3 Max API。可选的 Gemini Live 属于另一条语音传输链路,不是视频接口的必需条件。

语音产生的 fal H3 Max API 输入应与文字一样校验。整理失败时保留已经识别出的内容,停止聆听后让迟到回调失效,否则用户以为已经结束时,一条旧转写仍可能突然启动或修改会话。

明确录制 fal H3 Max API 的输出

fal H3 Max API 的视频流不会自动变成账号文件。需要录制接收到的轨道、完成封装并上传,再把结果关联用户。fal H3 Max API 生成与存储重试应分开,避免上传中断后又触发一笔模型请求。

fal H3 Max API 流程应该以回放和下载收尾。检查真实文件格式、音轨以及账号归属,不要只检查某个地址存在。核对 fal H3 Max API 录像时,仅看 MP4 文件名不能证明里面确实是可以播放的视频。

把 fal H3 Max API 的测试范围分清

fal H3 Max API 的传输测试与付费模型测试不是一回事。本地 WebRTC 可以验证录像,却不能证明 fal H3 Max API 的画面质量;模拟余额可以验证按钮拦截,也不能代替数据库记账行为的测试。

真正的 fal H3 Max API 小额测试应使用清晰场景和少量变化,并保留作品与请求标识。这样才能与账单核对,也能避免为了排查一个客户端问题,反复购买相同的生成过程却没有留下结果。

发布前重新核对 fal H3 Max API

发布前应核对 fal H3 Max API 的当前模型名称、支持设置与时长限制。促销有日期,fal H3 Max API 会话的最低计费可能比每秒单价更重要,预算应按实际调用接口使用的计费单位计算。

即使 fal H3 Max API 接通,公开收费仍需要可访问域名和已配置的结账。部署、支付准备和生成准备是不同检查项。供应商未开放时,不能返回示例视频来假装应用已经完成了一次成功生成。