用途:在 Starchild 环境下处理所有视频生成请求,底层经 sc-proxy 调用 fal.ai 模型,支持文生视频、图生视频、视频生视频与视频编辑。
主要能力:generate_video.py 自动完成提交、轮询、取回结果并把 mp4 下载到 output/videos/。提供 budget、balanced、premium 三档模型,5 秒成本分别约 $0.25、$0.70、$1.20,默认 balanced;可传入完整模型 id 覆盖。提供 image_url 时模型路径会自动由 text-to-video 改写为 image-to-video,视频同理。
必要用法:文生视频执行 exec(open('skills/video/generate_video.py').read()) 后调用 generate_video(prompt=..., model='balanced', duration=5)。图生/视频生视频需先经 publish_asset.py 把素材放入 output/fal_assets/,并保证名为 fal-assets 的预览已发布,再拼出公开 URL 传入。可用 poll_status.py 按 request_id 恢复轮询。请求需带 Authorization: Key fake-falai-key-12345,代理注入真实 FAL_KEY;提交时预扣费,轮询与取结果免费。存放于 https://*.fal.media/ 的成品可公开下载。
适用场景:需要文生视频、以参考图或参考视频驱动生成,以及在既有请求超时后继续取回结果的场景。
限制:图片限 jpg/jpeg/png/webp/gif/bmp 且不超过 10 MB,视频限 mp4/mov/webm/mkv/m4v 且不超过 100 MB。仅允许已注册的 fal 视频端点,其他端点返回 403 endpoint_not_allowed;余额不足返回 402 insufficient_credits。因生产密钥缺少 Serverless 权限,不使用 fal storage 上传,需走预览托管方案;端口池无可用端口时应询问用户停用哪个预览,不可自行结束。官方文档未给出更多分辨率参数、退费规则与并发限制,暂未提供。