介绍
# Veo 3 Video Generation (Gemini API)
使用捆绑脚本从文本提示词生成 MP4。
## 生成 (文本 → 视频)
```bash uv run {baseDir}/scripts/generate_video.py \ --prompt "A close up of ..." \ --filename "out.mp4" \ --model "veo-3.1-generate-preview" \ --aspect-ratio "9:16" \ --poll-seconds 10 ```
## 通过拼接片段生成更长的视频
Veo 通常每次请求输出约 8 秒的片段。使用 `--segments` 生成多个片段，并用 ffmpeg 将它们拼接起来。
**重要提示：** 此技能会为每个片段发送**一个提示词**（每个片段发起一次 Veo 请求）。使用 `--base-style` 可以保持片段之间的风格一致。
```bash uv run {baseDir}/scripts/generate_video.py \ --prompt "Same scene, consistent style..." \ --filename "out-24s.mp4" \ --model "veo-3.1-generate-preview" \ --aspect-ratio "9:16" \ --segments 3 \ --segment-style continuation ```
选项： - `--base-style "..."`：附加到每个片段提示词的前面（推荐）。 - `--segment-prompt "..."`（可重复）：为每个片段提供一个提示词（覆盖 `--prompt`）。 - `--segment-style continuation`（默认）：为每个片段追加连贯性指令（仅在使用 `--prompt` 时）。 - `--segment-style same`：对每个片段使用完全相同的提示词（仅在使用 `--prompt` 时）。 - `--use-last-frame`：对于片段 >= 2，提取前一片段的最后一帧并将其作为 `lastFrame` 传递以保证连贯性。 - `--emit-segment-media`：在每个片段完成时打印 `MEDIA:`（对跟踪进度很有用）。 - `--keep-segments`：保留中间的 `*.segXX.mp4` 文件。 - `--reference-image path.jpg`（可重复）：使用产品/风格参考来指导生成。
## 要求
- `GEMINI_API_KEY` 环境变量（或 `--api-key`）。 - 当使用 `--segments > 1` 时，PATH 中需包含 `ffmpeg`。
## 故障排查
- 429/RESOURCE_EXHAUSTED：API 密钥没有视频的配额/计费设置。 - 503/UNAVAILABLE：模型过载；请稍后重试。