---
name: veo-video
description: Генерация видео через Veo 3.1 — от текста к видео, анимация изображений, таймлапсы
$ARGUMENTS: Описание сцены или путь к изображению для анимации, тип (text-to-video/image-to-video/таймлапс)
triggers:
  - veo
  - видео генерация
  - text-to-video
  - image-to-video
  - оживить фото
  - animate
  - таймлапс видео
---

# Veo 3.1 Видеогенератор

Полный пайплайн AI-генерации видео: текст-в-видео, анимация изображений, таймлапсы, расширение видео.

**Принцип режиссуры:** Направляй сцену как режиссёр — не описывай как наблюдатель.

## Быстрый старт

Генерация видео из текста:

```bash
# Простое текст-в-видео
"видео: бизнесмен идёт по офису"

# Оживление изображения
"оживи: девушка машет рукой" + [прикрепить фото]

# Таймлапс переход
"таймлапс: растение растёт из семени"
```

**Формула промпта:** [Субъект] + [Действие] + [Обстановка] + [Камера] + [Свет]

## Параметры/Настройки

| Параметр | Значения | По умолчанию |
|----------|----------|--------------|
| Разрешение | 720p, 1080p | 720p |
| Соотношение | 16:9, 9:16 | 16:9 |
| Длительность | 4, 6, 8 сек | 8 сек |
| FPS | 24 fps | Фиксированно |
| Язык промптов | Только английский | — |

**Хранение:** Видео удаляется через 2 дня — скачивать сразу!

## Примеры использования

### Text-to-Video
```
Создай видео: Medium shot of confident businesswoman walking through modern office, 35mm lens, natural lighting
```

### Image-to-Video (анимация фото)
```
Оживи это фото: плавные движения головы, естественное дыхание, статичная камера
```

### Переход между кадрами
```
Создай переход от первого кадра ко второму: smooth transformation, static camera, no dissolves
```

### Расширение видео
```
Продли это видео на 7 секунд: продолжение того же действия
```

## Workflow

### 1. Подготовка промпта
- Указать тип кадра и камеру
- Описать действие персонажа
- Добавить освещение и стиль
- Указать звук (SFX, ambient)

### 2. Выбор модели
- **veo-3.1-fast** — быстро, дешево ($0.15)
- **veo-3.1** — качество, дороже ($0.25)
- **-fl** суффикс — для кадров (image-to-video)
- **-landscape** — горизонтальное 16:9

### 3. Генерация через API
- Sync API — быстрые тесты
- Async API — продакшн (не списывает при ошибке)

### 4. Постобработка
- Скачивание и сохранение
- Монтаж в CapCut при необходимости
- Доставка в нужном формате

## Файлы

| Файл | Содержание |
|------|-----------|
| `references/prompting-guide.md` | Руководство по написанию промптов |
| `references/best-practices.md` | Лучшие практики оптимизации |
| `references/async-api.md` | Асинхронный API (рекомендуется) |
| `references/prompt-library.md` | Библиотека готовых промптов |
| `references/advanced.md` | Таймлапс, консистентность, стоимость, API |
| `scripts/generate-video.sh` | Скрипт генерации видео |
| `scripts/async-video.py` | Python для Async API |

## Частые ошибки

- **Промпт на русском** — только английский язык
- **Абстрактные описания** — "cool scene" вместо конкретики
- **Забыл указать камеру** — получится случайный ракурс
- **Нет аудио в промпте** — модель угадает (часто плохо)
- **Противоречивые стили** — "bright sunny film noir"
- **PNG больше 8MB** — конвертировать в JPEG
- **Переописывание при image-to-video** — промпт только для движения

### Возможности модели

**1. Text-to-Video** — Промпт → видео, базовая генерация
**2. Image-to-Video** — Одно изображение → анимация (модель с `-fl`, промпт только для движения)
**3. First & Last Frame** — Два кадра → плавный переход (идеально для таймлапсов, обязательно 8 сек)
**4. Reference Images** — До 3 референса для консистентности (только Veo 3.1, 8s, 16:9)
**5. Video Extension** — Продление на 7 сек (до 20 раз, голос из последней секунды)

### Доступные модели

| Модель | Цена | Кадры | Ориентация |
|--------|------|-------|------------|
| `veo-3.1-fast` | $0.15 | нет | Портрет |
| `veo-3.1` | $0.25 | нет | Портрет |
| `veo-3.1-fast-fl` | $0.15 | да | Портрет |
| `veo-3.1-landscape` | $0.25 | нет | Пейзаж |
| `veo-3.1-landscape-fl` | $0.25 | да | Пейзаж |

### Таймлапс, консистентность, стоимость, API

Подробнее: `references/advanced.md`

### Troubleshooting

| Проблема | Решение |
|----------|---------|
| Камера дрифтует | `"static tripod, locked-off camera"` |
| Размытые переходы | `"no dissolves, only physical build-up"` |
| Субтитры на видео | Использовать двоеточие для диалога |
| Нет звука | Явно описать: `"SFX: ..., ambient: ..."` |
| 413 ошибка | PNG→JPEG конвертация |
| Sync timeout | Перейти на Async API |
| Identity drift | Reference images + seed + карточка |