Документация Veo 3.1 API

Полное руководство по интеграции ИИ-генерации видео от Google в ваши приложения.

Руководство по быстрому старту

Начните работу с Veo 3.1 API всего за несколько минут.

Получите API-ключ

Сначала вам нужно получить API-ключ в панели управления.

Сделайте первый запрос

curl -X POST "https://veo3api.com/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a dog running",
    "model": "veo3-fast",
    "watermark": "veo"
  }'

Проверьте статус генерации

Генерация видео выполняется асинхронно. Используйте https://veo3api.com/feed endpoint для проверки статуса или укажите

cURL

curl -X GET "https://veo3api.com/feed?task_id=YOUR_TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Справочник API

Полный справочник по всем эндпоинтам Veo 3.1 API, параметрам и форматам ответов.

Базовый URL

https://veo3api.com

Эндпоинты не используют префикс /api — вызывайте https://veo3api.com/ (например https://veo3api.com/generate).

Аутентификация

Все API-запросы требуют аутентификации с использованием Bearer-токена в заголовке Authorization.

Authorization: Bearer YOUR_API_KEY

POSThttps://veo3api.com/generate

Сгенерировать видео из текстового или изображенного запроса

Тело запроса

Параметр	Тип	Обязательный	Описание
`prompt`	string	*	Текстовый запрос для генерации видео
`model`	string	*	Выбор между veo3 (высокое качество, 180 кредитов) или veo3-fast (быстрая генерация, 25 кредитов)
`aspect_ratio`	string		Соотношение сторон: 16:9 (по умолчанию, 1080P HD), 9:16 (портрет) или Auto (как у изображения)
`image_urls`	string[]		Массив URL изображений для генерации видео из изображений
`watermark`	string		Пользовательский текст водяного знака. Установите null, чтобы отключить

Пример запроса

JSON

{
  "prompt": "a dog running",
  "model": "veo3-fast",
  "watermark": "veo"
}

Ответ

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv"
  }
}

Расход кредитов

Тип модели	Кредиты	Стоимость
`veo3-fast`	25 credits	$0.25
`veo3`	180 credits	$1.80
`extend`	Как у оригинала	-
`get-1080p`	Бесплатно	$0.00

Примечание: кредиты списываются только при успешном завершении генерации. Неудачные задачи кредиты не расходуют.

GEThttps://veo3api.com/feed

Проверить статус задачи генерации видео

Пример запроса

GET https://veo3api.com/feed?task_id=YOUR_TASK_ID

Ответ

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "request": {
      "prompt": "a dog running",
      "model": "veo3-fast",
      "watermark": "veo"
    },
    "response": [
      "https://cdn.veo3api.com/video/example_watermarked.mp4"
    ],
    "status": "COMPLETED",
    "created_at": "2025-10-29 12: 20: 46"
  }
}

💡 Совет: URL сгенерированного видео можно получить из массива data.response.

POSThttps://veo3api.com/extend

Продлить существующее видео с новым запросом. Продлённое видео продолжит оригинал с момента его окончания.

Тело запроса

Параметр	Тип	Обязательный	Описание
`task_id`	string	*	task_id исходного завершённого видео для продления
`prompt`	string	*	Текстовый запрос, описывающий, как продолжить видео
`seeds`	integer		Случайное зерно (10000–99999) для воспроизводимой генерации. Один и тот же seed даёт похожие результаты
`watermark`	string		Пользовательский текст водяного знака. Установите null, чтобы отключить

Пример запроса

JSON

{
  "task_id": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
  "prompt": "The dog continues running and jumps over a fence",
  "watermark": "veo"
}

Ответ

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "veo8b2c3dd60b80557bb4c678fddef53cdextd",
    "original_task_id": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
    "credits_consumed": 25
  }
}

Примечание: продлевать можно только завершённые задачи. Видео, преобразованные в 1080P, продлить нельзя.

GEThttps://veo3api.com/get-1080pБесплатно

Получить HD-версию 1080P завершённой задачи. Этот эндпоинт бесплатный и не расходует кредиты.

Пример запроса

GET https://veo3api.com/get-1080p?task_id=YOUR_TASK_ID

Ответ

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
    "result_url": "https://cdn.veo3api.com/video/example_1080p.mp4"
  }
}

💡 Совет: этот эндпоинт полностью бесплатный. Вы можете получить версию 1080P любого завершённого видео без списания кредитов.

HTTP-коды статуса

Код статуса	Описание
`200`	Запрос выполнен успешно
`400`	Неверный запрос — некорректные параметры
`401`	Нет авторизации — неверный API-ключ
`429`	Превышен лимит запросов
`500`	Внутренняя ошибка сервера