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 — флагманская модель генерации видео от 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)
curl -X POST "https://speshu.ai/api/v1/media" \
-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"
},
"async": 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: Для большего контроля над результатом загрузите исходное изображение и опишите желаемую анимацию.
Асинхронная генерация
Генерация видео — асинхронный процесс. После отправки запроса вы получите id, который нужно использовать для проверки статуса:
- Отправка запроса: POST запрос на
/api/v1/media возвращает id генерации
- Проверка статуса: GET запрос на
/api/v1/media/{id} возвращает текущий статус
- Получение результата: Когда статус
completed, в ответе будет URL готового видео
