用途:该技能用于调用 Maxgent FAL API 代理生成视频,支持文生视频、图生视频以及首尾帧模式。
主要能力与路由:默认自动路由(高质量)。文生视频使用 fal-ai/veo3.1;图生视频使用 fal-ai/sora-2/image-to-video/pro。可选显式模型包括 veo-3.1、sora-2-pro、kling-v3-pro、kling-v3-standard。首尾帧默认路由为 fal-ai/veo3.1/first-last-frame-to-video,加 --fast-first-last 时为 fal-ai/veo3.1/fast/first-last-frame-to-video。
前提条件:需要 MAX_API_KEY 环境变量(由 Max 自动注入);需要 Python 3.10+,支持 uv run 或 python3。
用法:运行 uv run skills/video-gen/video-gen.py,可传 --model、--prompt、--size、--seconds、--output-dir、--start-image、--end-image、--frame-mode、--fast-first-last、--generate-audio、--enhance-prompt、--negative-prompt、--cfg-scale。--size 支持 720P、1080P、1280x720、720x1280;--seconds 如 8 或 8s;--output-dir 默认 $MAX_PROJECT_PATH;--negative-prompt 与 --cfg-scale 仅 Kling 支持。
执行流程:检查 MAX_API_KEY;收集提示词、时长、分辨率、首尾帧选项与质量档位,默认输出到 $MAX_PROJECT_PATH;本地图片会自动经代理上传获取可访问 URL;等待队列完成并下载输出的 mp4,成功后报告保存路径。
限制:HTTP 402(额度不足)应立即停止、不要重试,并告知用户 API 额度已耗尽;其它错误可换模型或调整参数重试一次,再次失败即停止并报告。