Перейти к основному содержанию
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
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": {}
}