Справочник API

Полная документация API для генерации видео Veo 3.1 AI

Обзор

API Veo 3.1 позволяет программно генерировать AI-видео из текстовых описаний или изображений. Наш RESTful API разработан простым, мощным и легко интегрируемым в ваши приложения.

Базовый URL

https://veo3o1.com/api

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

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

Authorization: Bearer YOUR_API_KEY

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


Генерация видео

Создайте новое AI-видео из текста или изображения.

Конечная точка

POST /generate-video

Тело запроса

{
  "generationType": "text_to_video" | "image_to_video",
  "prompt": "Your video description",
  "aspectRatio": "auto" | "16:9" | "9:16",
  "imageUrl": "https://...", // Required if generationType is "image_to_video"
  "imageKey": "r2-key" // Optional, for uploaded images
}

Параметры

ПараметрТипОбязательныйОписание
generationTypestringДаТип генерации: text_to_video или image_to_video
promptstringДаОписание видео, которое вы хотите сгенерировать
aspectRatiostringНетСоотношение сторон видео. По умолчанию: auto
imageUrlstringУсловноОбязательно если generationType равен image_to_video
imageKeystringНетКлюч хранилища для загруженных изображений

Ответ

{
  "code": 0,
  "msg": "Success",
  "data": {
    "uuid": "video-uuid-123",
    "status": "pending",
    "generationType": "text_to_video",
    "prompt": "Your video description",
    "aspectRatio": "16:9",
    "createdAt": "2025-10-16T10:00:00Z"
  }
}

Пример

curl -X POST https://veo3o1.com/api/generate-video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "generationType": "text_to_video",
    "prompt": "A beautiful sunset over the ocean with waves gently lapping the shore",
    "aspectRatio": "16:9"
  }'

Получить статус видео

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

Конечная точка

GET /video-status/{uuid}

Параметры

ПараметрТипОбязательныйОписание
uuidstringДаUUID видео из запроса на генерацию

Ответ

{
  "code": 0,
  "msg": "Success",
  "data": {
    "uuid": "video-uuid-123",
    "status": "completed" | "pending" | "processing" | "failed",
    "videoUrl": "https://...", // Available when status is "completed"
    "progress": 85, // Processing progress (0-100)
    "estimatedTime": 120 // Estimated seconds remaining
  }
}

Значения статуса

  • pending: Видео находится в очереди на обработку
  • processing: Видео генерируется
  • completed: Видео готово и доступно для скачивания
  • failed: Генерация не удалась (проверьте сообщение об ошибке)

Загрузка изображения

Загрузите изображение для генерации видео из изображения.

Конечная точка

POST /upload-video-image

Запрос

Используйте multipart/form-data для загрузки файла изображения.

curl -X POST https://veo3o1.com/api/upload-video-image \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/image.jpg"

Ответ

{
  "code": 0,
  "msg": "Upload successful",
  "data": {
    "imageUrl": "https://...",
    "imageKey": "r2-key-123"
  }
}

Поддерживаемые форматы

  • JPEG/JPG
  • PNG
  • WebP
  • Максимальный размер файла: 50MB

Коды ошибок

КодОписание
0Успех
1000Неверные параметры
1001Недостаточно кредитов
1002Ошибка аутентификации
1003Превышен лимит запросов
5000Ошибка сервера

Пример ответа с ошибкой

{
  "code": 1001,
  "msg": "Insufficient credits",
  "data": {
    "required": 2,
    "current": 0
  }
}

Лучшие практики

  1. Ответственный опрос: Проверяйте статус видео каждые 5-10 секунд, не непрерывно
  2. Обработка ошибок: Реализуйте логику повторных попыток с экспоненциальной задержкой
  3. Кэширование результатов: Сохраняйте сгенерированные видео, чтобы избежать повторной генерации
  4. Используйте webhooks: Эффективнее опроса для уведомлений о завершении
  5. Валидация входных данных: Проверяйте длину промпта и форматы изображений перед вызовами API

Поддержка

Нужна помощь с API?