Перейти к основному содержанию
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-fast",
    "prompt": "Дельфины прыгают в голубом океане",
    "duration": 8,
    "aspect_ratio": "16:9",
    "image_urls": ["https://example.com/start-frame.jpg", "https://example.com/end-frame.jpg"],
    "metadata": {
      "generation_type": "frame",
      "resolution": "1080p",
      "enable_gif": false
    }
  }'
{
  "id": "video_01K8SGYNNNVBQTXNR4MM964S7K",
  "object": "generation.task",
  "model": "veo3.1-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {
    "aspect_ratio": "16:9"
  }
}
  • Асинхронный режим обработки, возвращает ID задачи для последующих запросов
  • Поддержка нескольких режимов генерации, включая текст-в-видео и изображение-в-видео
  • Ссылки на сгенерированные видео действительны в течение 24 часов, сохраните их своевременно
Важное изменение: Для повышения производительности и контроля затрат мы больше не поддерживаем передачу данных изображений в формате base64 напрямую в image_urls. Пожалуйста, сначала используйте API загрузки изображений для загрузки изображений и получения URL, а затем вызывайте этот эндпоинт.

Авторизация

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

Тело запроса

model
string
по умолчанию:"veo3.1-fast"
обязательно
Название модели генерации видеоДоступные модели:
  • veo3.1-fast - Модель быстрой генерации, подходит для быстрого предпросмотра и итераций
  • veo3.1-quality - Модель высококачественной генерации, подходит для финальной продукции
Пример: "veo3.1-fast"
prompt
string
обязательно
Текстовое описание для генерации видео
duration
integer
Длительность видео (секунды)Фиксированное значение: 8 (VEO3 поддерживает только 8-секундную длительность)
aspect_ratio
string
Разрешение видеоПоддерживаемые форматы:
  • 16:9 (горизонтальный)
  • 9:16 (вертикальный)
image_urls
string[]
Массив URL референсных изображений для генерации изображение-в-видео⚠️ Только формат URL (base64 больше не поддерживается)
  • Публично доступный URL изображения (http:// или https://)
  • Вы можете использовать API загрузки изображений для загрузки локальных изображений и получения URL
Ограничения:
  • Максимальный размер файла: 10MB
  • Поддерживаемые форматы: .jpeg, .jpg, .png, .webp
metadata
object
Расширенные параметры, специфичные для VEO3

Ответ

id
string
Уникальный идентификатор задачи для запроса статуса
object
string
Тип объекта, всегда generation.task
model
string
Используемое имя модели
status
string
Статус задачи
  • queued - В очереди на обработку
  • in_progress - Обработка
  • completed - Успешно завершено
  • failed - Не удалось
progress
integer
Процент выполнения задачи (0-100)
created_at
integer
Временная метка создания задачи (временная метка Unix)
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-fast",
    "prompt": "Дельфины прыгают в голубом океане",
    "duration": 8,
    "aspect_ratio": "16:9",
    "image_urls": ["https://example.com/start-frame.jpg", "https://example.com/end-frame.jpg"],
    "metadata": {
      "generation_type": "frame",
      "resolution": "1080p",
      "enable_gif": false
    }
  }'
{
  "id": "video_01K8SGYNNNVBQTXNR4MM964S7K",
  "object": "generation.task",
  "model": "veo3.1-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {
    "aspect_ratio": "16:9"
  }
}