Перейти к основному содержанию
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": "viduq3-pro",
    "prompt": "Кот играет на пианино, камера медленно приближается",
    "duration": 8,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

{
  "id": "video_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ",
  "object": "generation.task",
  "model": "viduq3-pro",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {}
}
  • Асинхронный режим обработки, возвращает ID задачи для последующих запросов
  • Поддержка текст-в-видео, изображение-в-видео, генерация первого-последнего кадра
  • Поддержка разрешений 540p / 720p / 1080p
  • Диапазон длительности 1-16 секунд, аудио включено по умолчанию

​
Авторизация

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

​
Параметры запроса

​
model
string
обязательно
Название модели генерации видео, фиксированное значение viduq3-pro
​
prompt
string
обязательно
Текстовый промпт, максимум 2000 символовОбязателен для текст-в-видео. Необязателен для режимов изображение-в-видео и первый-последний кадр.Пример: "Кот играет на пианино, камера медленно приближается"
​
duration
integer
по умолчанию:"5"
Длительность видео (секунды)Диапазон: 1 до 16По умолчанию: 5
​
resolution
string
по умолчанию:"720p"
Разрешение видеоВарианты:
  • 540p - Стандартное разрешение
  • 720p - Высокое разрешение (по умолчанию)
  • 1080p - Полное высокое разрешение
По умолчанию: 720p
​
aspect_ratio
string
Соотношение сторон видео (только для режима текст-в-видео)Варианты:
  • 16:9 - Альбомная
  • 9:16 - Портретная
  • 4:3 - Традиционная альбомная
  • 3:4 - Традиционная портретная
  • 1:1 - Квадрат
Этот параметр доступен только в режиме текст-в-видео (когда image_urls не предоставлен). В режиме изображение-в-видео соотношение сторон определяется автоматически по изображению.
​
image_urls
string[]
Массив URL изображений для режима изображение-в-видеоСистема автоматически определяет режим генерации по количеству изображений:
  • 0 изображений (не предоставлено): Режим текст-в-видео
  • 1 изображение: Режим изображение-в-видео (изображение как начальный кадр)
  • 2 изображения: Режим первого-последнего кадра (первое = первый кадр, второе = последний кадр)
Пример: ["https://example.com/photo.jpg"]
  • Максимум 2 изображения
  • Для режима первого-последнего кадра необходимо предоставить ровно 2 изображения
  • При предоставлении image_urls параметр aspect_ratio недоступен
​
audio
boolean
по умолчанию:"true"
Генерировать аудио (диалоги, звуковые эффекты)По умолчанию: trueУстановите false для видео без звука.
​
seed
integer
Случайное зерно для воспроизводимых результатовИспользование одного и того же зерна с идентичными параметрами даст одинаковый результат.

​
Автоматическая маршрутизация

Количество изображенийРежимОписание
0 (не предоставлено)Текст-в-видеоГенерация только из текста
1Изображение-в-видеоИзображение как начальный кадр
2Первый-последний кадрПервое = первый кадр, второе = последний кадр

​
Ответ

​
id
string
Уникальный идентификатор задачи
​
object
string
Тип объекта, фиксированное значение generation.task
​
model
string
Название использованной модели
​
status
string
Статус задачи
  • queued - В очереди
  • in_progress - Обрабатывается
  • completed - Завершено
  • failed - Ошибка
​
progress
integer
Процент выполнения (0-100)
​
created_at
integer
Unix-временная метка создания задачи

​
Примеры использования

​
Сценарий 1: Текст-в-видео

{
  "model": "viduq3-pro",
  "prompt": "Кот играет на пианино, камера медленно приближается",
  "duration": 8,
  "resolution": "1080p",
  "aspect_ratio": "16:9"
}

​
Сценарий 2: Изображение-в-видео (одно изображение)

{
  "model": "viduq3-pro",
  "prompt": "Человек медленно поворачивается и улыбается",
  "image_urls": ["https://example.com/photo.jpg"],
  "duration": 5,
  "resolution": "720p"
}

​
Сценарий 3: Первый-последний кадр

{
  "model": "viduq3-pro",
  "prompt": "Человек постепенно садится из положения стоя",
  "image_urls": [
    "https://example.com/first.jpg",
    "https://example.com/last.jpg"
  ],
  "duration": 8
}

​
Сценарий 4: Видео без звука

{
  "model": "viduq3-pro",
  "prompt": "Таймлапс морского пейзажа на закате",
  "duration": 10,
  "resolution": "1080p",
  "audio": false
}
Запрос результатов задачиГенерация видео является асинхронной задачей, после отправки возвращается ID задачи. Используйте конечную точку Получить статус задачи для запроса прогресса и результатов.
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "viduq3-pro",
    "prompt": "Кот играет на пианино, камера медленно приближается",
    "duration": 8,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

{
  "id": "video_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ",
  "object": "generation.task",
  "model": "viduq3-pro",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {}
}