用途
Nano Banana Video Generation 用于借助 nano-banana CLI 调用 Google Veo 3.1 模型生成视频。适用于用户要求创建、生成、动效化或制作 AI 视频的场景。
前提条件
- 必须设置
GEMINI_API_KEY环境变量。 - CLI 通过
npx @the-focus-ai/nano-banana安装。
环境变量设置方式:
export GEMINI_API_KEY="your-api-key-here"
或在项目根目录创建 .env 文件:
GEMINI_API_KEY=your-api-key-here
主要能力
文本生成视频
nano-banana --video "A sunset over mountains, slow dolly-in, cinematic lighting"
为已有图片添加动效
nano-banana --video "The character slowly turns and smiles" --file portrait.png
成本优化的开发模式
nano-banana --video "Quick test scene" --video-fast --no-audio --resolution 720p
指定输出路径
nano-banana --video "A cat playing" --output cat-video.mp4
完整参数控制
nano-banana --video "Dramatic reveal scene" --duration 8 --aspect 16:9 --resolution 1080p --seed 42
使用方式
选项参数
--video:启用视频模式(必需)。--video-model <name>:使用的 Veo 模型,默认为veo-3.1-generate-001。--video-fast:使用快速/低成本模型,默认为高级模型。--duration <sec>:4、6 或 8 秒,默认 8 秒。--aspect <ratio>:16:9 或 9:16,默认 16:9。--resolution <res>:720p、1080p 或 4K,默认 1080p。--audio:生成音频(默认启用)。--no-audio:禁用音频。--seed <number>:可复现随机种子,默认随机。--output <file>:输出路径,默认output/video-.mp4。--file <image>:要添加动效的输入图片。
提示词公式
视频提示词采用五段式结构:
[镜头运动] + [主体] + [动作] + [环境] + [音频/风格]
较弱的提示词示例:
"a person walking"
较强的提示词示例:
"Slow dolly-in shot. A woman in her 30s, shoulder-length wavy black hair, green jacket, walks confidently through a sunlit park. Golden hour lighting, warm color grading. Ambient sounds: birds chirping, distant traffic. Cinematic, aspirational mood. No subtitles, no text overlay."
建议原则:
- 以镜头运动开头(dolly、pan、static、tracking)。
- 详细描述主体(外貌、服装、表情)。
- 说明动作并给出时间线索。
- 包含光照与环境。
- 添加音频设计(对白、音效、环境音)。
- 始终以 "No subtitles, no text overlay, no captions" 结尾。
生成前需澄清的要素
- 核心场景:主要动作或主体是什么?
- 镜头运动:静止、dolly、pan、tracking、crane?
- 风格:电影感、纪录片、广告、随性?
- 音频:对白?音效?环境音?音乐?
- 时长:4、6 或 8 秒?
- 画幅方向:横屏(16:9)还是竖屏(9:16)?
工作流程
- 编写提示词(可参考 prompting-guide.md)。
- 考虑成本:视频生成成本显著高于图片。
veo-3.1-generate-001:每秒 $0.40,8 秒视频 $3.20。veo-3.1-fast-generate-001:每秒 $0.15,8 秒视频 $1.20。 开发流程建议:先用--video-fast --no-audio(最便宜)迭代,再用--video-fast测试并添加音频,最后用默认模型做最终渲染(高级质量)。
- 执行生成命令:
nano-banana --video "your detailed prompt here"
生成过程耗时 2-4 分钟,进度显示在终端中。
- 迭代:若结果不理想,可细化镜头运动(如 "slow dolly-in over 8 seconds")、添加负向指引、简化内容(每个片段聚焦一个主要动作)、或尝试不同时长(4 秒或 6 秒可能更适合快速动作)。
镜头运动参考
- Static:无运动。示例 "Static shot on tripod. A coffee cup steaming..."
- Pan:水平旋转。示例 "Slow pan left across the city skyline..."
- Tilt:垂直旋转。示例 "Tilt down from face to hands..."
- Dolly In:镜头靠近。示例 "Slow dolly-in from medium to close-up..."
- Dolly Out:镜头远离。示例 "Dolly-out revealing the vast landscape..."
- Tracking:与主体平行。示例 "Tracking shot following character walking..."
- Crane:大幅垂直运动。示例 "Crane shot ascending from ground level..."
- Handheld:真实抖动。示例 "Handheld camera, documentary style..."
注意:每个镜头只使用一种主要运动方式,不要组合多种运动。
对白格式
对白使用冒号格式:
Character description says: "Exact dialogue here."
示例:
"A friendly young woman, excited and cheerful, says: 'Welcome to our store!' Standing in bright retail environment. Natural lip-sync. No subtitles."
对白准则:8 秒视频的对白控制在 6-12 个词;描述说话者的语气与情绪;始终添加 "No subtitles, no text overlay"。
音频设计
按层级组织音频:
- 对白(最高优先级)——始终清晰。
- 音效——具体、有时间的动作。
- 环境音——最多 3-5 个背景元素。
- 音乐——最低优先级,"ducks under dialogue"。
示例:
"Sound effects: Door closing at 2-second mark, footsteps on wood. Ambient sounds: Quiet office hum, distant typing. Background music: Soft jazz, low volume, ducks under dialogue."
适用场景与最佳实践
- 前置重要信息——镜头、主体、动作放最前。
- 使用电影术语——"35mm lens"、"shallow depth of field"、"golden hour"。
- 光照描述要具体——如 "Soft window light from left",而非仅 "good lighting"。
- 描述情绪——"intimate"、"epic"、"suspenseful"、"uplifting"。
- 包含负向指引——说明要避免的内容。
图生视频场景:
- 与图片匹配——描述与图片内容相符的运动。
- 从细微开始——小幅运动效果好于剧烈变化。
- 保持光照一致——不要描述与图片不同的光照变化。
多镜头一致性:创建角色描述并完全复用;保持光照风格一致;使用同一类镜头运动风格;使用 --seed 提高结果可复现性。
使用限制与故障排查
- 视频生成超时:生成可能需 2-4 分钟;若持续出现,尝试更简单的提示词或使用
--video-fast。 - 质量差或内容错误:添加更具体的描述、包含负向指引、改用高级模型而非快速模型。
- 视频中出现字幕:始终在提示词中包含 "No subtitles, no text overlay, no captions";Veo 训练素材包含字幕,容易自行添加。
- 音频与视频不匹配:更具体说明声音出现的时机,使用 "Sound effect: X at Y-second mark",并简化音频层级。
- 安全过滤被拒:避免暴力、武器、露骨内容;改写歧义词汇;尝试更通用的描述。
成本优化示例
开发(最便宜):约 $1.20/视频
nano-banana --video "test prompt" --video-fast --no-audio --resolution 720p
带音频测试:约 $1.20/视频
nano-banana --video "test prompt" --video-fast
生产质量:约 $3.20/视频
nano-banana --video "final prompt" --resolution 1080p
示例提示词
examples/ 目录包含完整提示词示例:cinematic-shots.md(镜头运动)、dialogue-and-audio.md(语音与音效)、image-to-video.md(为图片添加动效)。