应该使用哪个 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_pending、prompt_applied、prompt_rejected 等提供商事件作为真实状态,而不是用假的进度计时器。
还需要处理 chunk、deadline_missed、stream_exhausted 与 error,并在付费时间结束时发送 stop、关闭媒体轨道。
计费与退款边界
创建会话前应原子预扣积分。如果 fal 接受会话前协商失败,可以退回预扣积分。一旦提供商会话开始,60 秒最低成本已经发生,用户断线不应自动全额退款。
截至 2026 年 9 月 4 日,fal 公布的前两周促销价为每视频秒 $0.02,标准价为每秒 $0.08。实际接入前应再次查看 H3 Max Director 官方页面。
查看完整产品层
AIR Live 在上述基础设施之上增加可见导演队列、60 秒倒计时、语音转指令以及独立的低成本预览模式。打开导演台查看完整产品约定。