Перейти к основному содержанию
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini_omni_flash",
    "prompt": "Синяя бутылка с помпой медленно вращается в белой студии, коммерческое product video",
    "duration": 6,
    "aspect_ratio": "9:16",
    "resolution": "720P",
    "image_urls": ["https://example.com/reference.jpg"]
  }'

{
  "id": "video_01JZEXAMPLE",
  "object": "generation.task",
  "model": "gemini_omni_flash",
  "status": "queued",
  "created_at": 1779247407
}
  • Укажите gemini_omni_flash в поле model
  • Поддерживает text-to-video, single-image video generation и режим с 3 референсными изображениями
  • Поддерживаемая длительность: 4 / 6 / 10 секунд
  • Разрешение по умолчанию 720P; 1080p означает landscape 1080P и поддерживает только 16:9
  • Асинхронный API задач: после отправки используйте ID задачи для проверки статуса
Сначала загрузите локальные изображения через Upload Image API, затем передайте полученные URL в image_urls. Не передавайте base64 изображения напрямую.

​
Authorizations

​
Authorization
string
обязательно
Используйте Bearer Token:
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
по умолчанию:"gemini_omni_flash"
обязательно
Название модели. Используйте gemini_omni_flash.
​
prompt
string
обязательно
Текстовый prompt для генерации видео.
​
duration
integer
по умолчанию:"6"
Длительность видео. Поддерживаемые значения: 4, 6, 10.
​
aspect_ratio
string
по умолчанию:"16:9"
Соотношение сторон:
  • 16:9 landscape
  • 9:16 portrait
​
resolution
string
по умолчанию:"720P"
Разрешение видео:
  • 720P по умолчанию
  • 1080p landscape 1080P, только с aspect_ratio: "16:9"
​
image_urls
string[]
Необязательный массив URL референсных изображений. Поддерживаются только три варианта:
  • не передавать поле или передать пустой массив: text-to-video
  • 1 изображение: single-image video generation
  • 3 изображения: режим слияния по референсам
Передача 2 изображений не поддерживается.Backend нормализует image_urls в параметр референсных изображений upstream.

​
Response

​
id
string
ID задачи для проверки статуса.
​
object
string
Тип объекта, обычно generation.task.
​
model
string
Название модели, использованной в запросе.
​
status
string
Статус задачи: queued, in_progress, completed, failed.
​
created_at
integer
Временная метка создания задачи.
​
video_url
string
URL сгенерированного видео после завершения задачи.

​
Examples

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini_omni_flash",
    "prompt": "Синяя бутылка с помпой медленно вращается в белой студии, коммерческое product video",
    "duration": 6,
    "aspect_ratio": "9:16",
    "resolution": "720P",
    "image_urls": ["https://example.com/reference.jpg"]
  }'

{
  "id": "video_01JZEXAMPLE",
  "object": "generation.task",
  "model": "gemini_omni_flash",
  "status": "queued",
  "created_at": 1779247407
}

​
Query Task

Эндпоинт генерации возвращает ID задачи. Используйте общий эндпоинт статуса видео, чтобы получить статус и результат: 
curl --request GET \
  --url https://toapis.com/v1/videos/generations/{task_id} \
  --header "Authorization: Bearer YOUR_API_KEY"