Перейти к основному содержанию
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "Veo3.1-quality-official",
    "prompt": "Дельфин прыгает через кристально чистые голубые воды океана, брызги воды, солнечный свет блестит на поверхности",
    "duration": 8,
    "size": "16:9",
    "resolution": "1080p",
    "metadata": {
      "generateAudio": true,
      "negativePrompt": "размытый, низкое качество"
    }
  }'

{
  "id": "video_01K8SGYNNNVBQTXNR4MM964S7K",
  "object": "generation.task",
  "model": "Veo3.1-quality-official",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {}
}
  • Асинхронный режим обработки, возвращает ID задачи для последующего запроса статуса
  • Прямое подключение к Google Vertex AI с поддержкой всех нативных параметров Veo
  • Поддержка генерации видео из текста, из изображения и интерполяции ключевых кадров
  • Сгенерированные ссылки на видео действительны в течение 24 часов, пожалуйста, сохраните их заблаговременно
Важное изменение: Для улучшения производительности и контроля затрат мы больше не поддерживаем передачу данных изображений в формате base64 непосредственно в image_urls. Пожалуйста, сначала используйте эндпоинт загрузки изображений для загрузки изображений, а затем используйте полученный URL в этом API.

​
Авторизация

​
Authorization
string
обязательно
Все эндпоинты требуют аутентификации Bearer TokenПолучить API Key: Перейдите на страницу управления API Key для получения вашего API KeyДобавьте в заголовки запроса:
Authorization: Bearer YOUR_API_KEY

​
Тело запроса

​
model
string
по умолчанию:"Veo3.1-quality-official"
обязательно
Название модели генерации видеоДоступные модели:
  • Veo3.1-quality-official - Модель высококачественной генерации, идеальна для финального производства
  • Veo3.1-fast-official - Модель быстрой генерации, идеальна для быстрого предпросмотра и итераций
Пример: "Veo3.1-quality-official"
​
prompt
string
обязательно
Текстовое описание для генерации видео
​
duration
integer
Длительность видео в секундахПоддерживаемые значения:
  • 4 - 4 секунды
  • 6 - 6 секунд
  • 8 - 8 секунд (по умолчанию)
​
size
string
Соотношение сторон видеоПоддерживаемые форматы:
  • 16:9 (горизонтальное, по умолчанию)
  • 9:16 (вертикальное)
​
resolution
string
Разрешение видеоПоддерживаемые значения:
  • 720p (по умолчанию)
  • 1080p
  • 4k (preview)
​
image_urls
string[]
Первый кадр для генерации видео из изображения. Видео будет начинаться с этого изображения. Используется только первый URL из массива.⚠️ Поддерживается только формат URL (base64 больше не поддерживается)Ограничения:
  • Максимальный размер файла: 10MB
  • Поддерживаемые форматы: .jpeg, .jpg, .png, .webp
image_urls и metadata.referenceImages нельзя использовать одновременно. Если указаны оба, image_urls (первый кадр) имеет приоритет, а referenceImages будет проигнорирован.
​
metadata
object
Специальные параметры расширения Veo3 Official

​
Ответ

​
id
string
Уникальный идентификатор задачи для запроса статуса
​
object
string
Тип объекта, всегда generation.task
​
model
string
Используемое название модели
​
status
string
Статус задачи
  • queued - В очереди на обработку
  • in_progress - Обрабатывается
  • completed - Успешно завершена
  • failed - Ошибка
​
progress
integer
Процент выполнения задачи (0-100)
​
created_at
integer
Время создания задачи (Unix timestamp)
​
metadata
object
Метаданные задачи
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "Veo3.1-quality-official",
    "prompt": "Дельфин прыгает через кристально чистые голубые воды океана, брызги воды, солнечный свет блестит на поверхности",
    "duration": 8,
    "size": "16:9",
    "resolution": "1080p",
    "metadata": {
      "generateAudio": true,
      "negativePrompt": "размытый, низкое качество"
    }
  }'

{
  "id": "video_01K8SGYNNNVBQTXNR4MM964S7K",
  "object": "generation.task",
  "model": "Veo3.1-quality-official",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {}
}