Справочник 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
}Параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
generationType | string | Да | Тип генерации: text_to_video или image_to_video |
prompt | string | Да | Описание видео, которое вы хотите сгенерировать |
aspectRatio | string | Нет | Соотношение сторон видео. По умолчанию: auto |
imageUrl | string | Условно | Обязательно если generationType равен image_to_video |
imageKey | string | Нет | Ключ хранилища для загруженных изображений |
Ответ
{
"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}Параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
uuid | string | Да | 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
}
}Лучшие практики
- Ответственный опрос: Проверяйте статус видео каждые 5-10 секунд, не непрерывно
- Обработка ошибок: Реализуйте логику повторных попыток с экспоненциальной задержкой
- Кэширование результатов: Сохраняйте сгенерированные видео, чтобы избежать повторной генерации
- Используйте webhooks: Эффективнее опроса для уведомлений о завершении
- Валидация входных данных: Проверяйте длину промпта и форматы изображений перед вызовами API
Поддержка
Нужна помощь с API?