Перейти к основному содержанию
POST
https://toapis.com
/
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://cdn.apimart.ai/doc/9998238783208208-9972597b-255d-4e7e-9649-e6ee38a837aa-image_task_01K88B53MTK41PP5KGDTG2PA5P_0.png"]
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}
  • Асинхронный режим обработки, возвращает ID задачи для последующих запросов
  • Поддержка нескольких режимов генерации, включая текст-в-видео и изображение-в-видео
  • Ссылки на сгенерированные видео действительны в течение 24 часов, сохраните их своевременно

Авторизация

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
array
Массив URL референсных изображений для генерации изображение-в-видео💡 Быстрое заполнение (область Try it):
  1. Нажмите ”+ Add an item” для добавления URL изображения
  2. Введите полный URL адрес изображения или данные base64

Ответ

code
integer
Код статуса ответа
data
array
Массив данных ответа
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://cdn.apimart.ai/doc/9998238783208208-9972597b-255d-4e7e-9649-e6ee38a837aa-image_task_01K88B53MTK41PP5KGDTG2PA5P_0.png"]
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}