用途:通过 vofy-cli 以确定性、非交互方式生成媒体,适用于文生图、图像编辑、局部重绘、文生视频、图生视频、图像插值、视频转换与延长等任务。
主要能力:支持图像模式 text_to_image、image_to_image、inpainting;视频模式 text_to_video、image_to_video、interpolation、reference_images、multimodal_reference、video_to_video、video_extension、motion_control。默认模型包括 seedream-4.5(通用图像)、gpt-image-1.5(图像编辑或透明素材)、veo-3.1(高质量文生视频)、veo-3.1-fast(快速视频草稿)、kling-3.0(图像动画)、seedance-2.0(视频转换或延长)。
使用方式:先运行 vofy status,认证失败则提示用户运行 vofy login。确定输出类型、源素材、宽高比、时长、分辨率及是否需要本地文件。用户仅有粗略想法或需模型特定措辞时加载 imagine-prompt;仅在严格限制、价格或特殊标志时加载 imagine-models。构建带 --yes 的非交互命令,需要本地输出时加 --download-to ./output。图像基础命令:vofy image create --model <model> --prompt "<prompt>" --aspect-ratio <ratio> --resolution <resolution> --yes --download-to ./output。视频基础命令:vofy video create --model <model> --prompt "<prompt>" --duration <seconds> --aspect-ratio <ratio> --yes --download-to ./output。返回文件路径或资源 URL;异步任务返回任务 id 与下次检查命令。若缺少 vofy,停止并让用户安装 vofy-cli@0.1.7 并完成一次认证。
结果处理:同步命令默认等待完成并打印输出;--download-to ./output 保存文件并自动建目录;--result-url 显式打印资源 URL;--async 提前返回,之后用 vofy tasks --plain --type video 和 vofy task <id_or_prefix> --download-to ./output。若因值不支持失败,运行 vofy models <model> 后重试。
限制与注意:--video 有歧义,必须加 --mode video_to_video 或 --mode video_extension;混合 --reference-image 与 --reference-video 或 --reference-audio 需 --mode multimodal_reference;kling-2.6 的 --audio 与末帧插值需 resolution=1080p;kling-3.0 --multi-shot 需 --shot-type,customize 用 --multi-prompt,intelligence 用 --prompt;源驱动模式可能忽略 --aspect-ratio 或 --resolution。添加 --audio、--background、--web-search、--multi-shot 或运动控制前先运行 vofy models <model>。更多场景见 examples.md,完整 CLI 帮助见 commands-reference.md。