> ## Documentation Index
> Fetch the complete documentation index at: https://speshu.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Veo 3.1

> Генерация видео с моделью Veo 3.1 от Google DeepMind

Veo 3.1 — флагманская модель генерации видео от Google DeepMind с поддержкой 4K апскейлинга и продления видео. Доступна в двух вариантах: Quality и Fast.

## Обзор

| Характеристика       | Quality                                            | Fast                                                                    |
| -------------------- | -------------------------------------------------- | ----------------------------------------------------------------------- |
| ID модели            | `google/veo3`                                      | `google/veo3_fast`                                                      |
| Max prompt           | 2 000 символов                                     | 2 000 символов                                                          |
| Aspect ratio         | 16:9, 9:16, Auto                                   | 16:9, 9:16, Auto                                                        |
| Seeds                | 10000-99999                                        | 10000-99999                                                             |
| Watermark            | до 50 символов                                     | до 50 символов                                                          |
| Референс-изображения | до 2                                               | до 3                                                                    |
| Режимы генерации     | TEXT\_2\_VIDEO, FIRST\_AND\_LAST\_FRAMES\_2\_VIDEO | TEXT\_2\_VIDEO, FIRST\_AND\_LAST\_FRAMES\_2\_VIDEO, REFERENCE\_2\_VIDEO |
| Авто-перевод промпта | Да                                                 | Да                                                                      |

## Параметры

| Параметр            | Тип    | Обязательный | Описание                                                                                            |
| ------------------- | ------ | ------------ | --------------------------------------------------------------------------------------------------- |
| `model`             | string | Да           | ID модели: `google/veo3` (Quality) или `google/veo3_fast` (Fast)                                    |
| `prompt`            | string | Да           | Текстовое описание желаемого видео (до 2 000 символов)                                              |
| `aspect_ratio`      | string | Нет          | Соотношение сторон: `16:9`, `9:16`, `Auto` (по умолчанию `16:9`)                                    |
| `images`            | array  | Нет          | Массив референс-изображений (Quality: до 2, Fast: до 3)                                             |
| `seeds`             | number | Нет          | Seed для воспроизводимости: 10000-99999                                                             |
| `watermark`         | string | Нет          | Текст водяного знака (до 50 символов)                                                               |
| `generationType`    | string | Нет          | Режим генерации: `TEXT_2_VIDEO`, `FIRST_AND_LAST_FRAMES_2_VIDEO`, `REFERENCE_2_VIDEO` (только Fast) |
| `enableTranslation` | string | Нет          | Автоматический перевод промпта на английский: `true`, `false` (по умолчанию `true`)                 |

## Пример запроса (cURL)

```bash theme={null} theme={null}
curl -X POST "https://speshu.ai/api/v1/async/media/tasks" \
  -H "Authorization: Bearer <SPESHU_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/veo3",
    "input": {
      "prompt": "Текстовое описание видео",
      "aspect_ratio": "16:9",
      "seeds": 12345,
      "images": [],
      "generationType": "TEXT_2_VIDEO",
      "enableTranslation": "true"
    }
  }'
```

## Возможности

* **Text-to-Video**: Создание видео по текстовому описанию
* **Image-to-Video**: Анимация статичного изображения
* **Продление видео**: Операция extend для продолжения видео
* **4K апскейлинг**: Увеличение разрешения до 4K

## Операции над видео

| Операция        | Описание                         |
| --------------- | -------------------------------- |
| `extend`        | Продление видео с новым промптом |
| `upscale_1080p` | Апскейл до 1080p                 |
| `upscale_4k`    | Апскейл до 4K                    |

## Советы и лучшие практики

**Описывайте движение**: Veo 3.1 лучше работает, когда в промпте явно описано движение.

**Указывайте стиль съёмки**: Используйте кинематографические термины: «крупный план», «панорама», «tracking shot», «slow motion».

**Выбирайте между Quality и Fast**: Для тестирования и быстрых итераций используйте `google/veo3_fast`. Для финального результата — `google/veo3` (Quality).

**Используйте Image-to-Video**: Для большего контроля над результатом загрузите исходное изображение и опишите желаемую анимацию.

## Асинхронная генерация

Генерация видео — асинхронный процесс. После отправки запроса вы получите `taskId`, который нужно использовать для проверки статуса:

1. **Отправка запроса**: POST запрос на `/api/v1/async/media/tasks` возвращает `taskId`
2. **Проверка статуса**: GET запрос на `/api/v1/async/media/tasks/{task_id}` возвращает текущий статус
3. **Получение результата**: Когда статус `success`, в ответе будет URL готового видео