Перейти к основному содержанию
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",
    "audio": true
  }'

{
  "id": "video_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ",
  "object": "generation.task",
  "model": "viduq3-pro",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {}
}
  • Асинхронный режим обработки, возвращает ID задачи для последующих запросов
  • Поддерживаемые модели: viduq3-pro, viduq3-turbo, viduq3
  • viduq3-pro: Высокое качество, синхронизация аудио-видео, генерация раскадровки
  • viduq3-turbo: Быстрая генерация, интеллектуальное переключение сцен, лучшая экономичность
  • viduq3: Лучшая мультиракурсная согласованность, мульти-референс генерация
Используйте общедоступные URL изображений. Не передавайте base64 данные в image_urls; загрузите локальные изображения через API загрузки изображений.

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

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

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

​
model
string
обязательно
Название модели Vidu Q3.Варианты:
  • viduq3-pro - высокое качество, синхронизация аудио-видео
  • viduq3-turbo - самая быстрая генерация, интеллектуальное переключение сцен
  • viduq3 - лучшая мультиракурсная согласованность, мульти-референс/субъекты
​
prompt
string
обязательно
Текстовый промпт, максимум 5000 символов.Описывает субъект, действие, сцену, камеру и стиль. В режиме subjects используйте @name для ссылки на субъекты.Пример: "Кот играет на пианино, камера медленно приближается, кинематографическое качество"
​
duration
integer
по умолчанию:"5"
Длительность видео (секунды).
  • viduq3-pro / viduq3-turbo: 1 до 16
  • viduq3: 3 до 16
​
resolution
string
по умолчанию:"720p"
Разрешение видео.Варианты:
  • 540p
  • 720p
  • 1080p
​
aspect_ratio
string
Соотношение сторон видео.Распространённые значения: 16:9, 9:16, 1:1Модели Q3 поддерживают произвольное соотношение сторон. При предоставлении image_urls соотношение обычно определяется по референсному изображению.
​
image_urls
string[]
Массив URL референсных изображений.
  • viduq3-pro / viduq3-turbo
    • Не предоставлено: текст-в-видео
    • 1 изображение: изображение-в-видео, используется как начальный кадр
    • 2 изображения: первый-последний кадр
  • viduq3
    • Обязательно, до 7 референсных изображений
Пример: ["https://example.com/reference.jpg"]
​
audio
boolean
Включить аудио-видео выход.
  • Все модели Q3: по умолчанию true
При true система генерирует речь и звуковые эффекты на основе промпта.
​
seed
integer
Случайное зерно для воспроизводимых результатов.
​
metadata
object
Расширенные параметры для полей upstream API, не представленных как основные.

​
Выбор модели

МодельСценарийИзображенияРазрешениеДлительность
viduq3-proВысокое качество текст/изображение/первый-последний кадрОпционально, до 2540p / 720p / 1080p1-16s
viduq3-turboБыстрая генерация текст/изображение/первый-последний кадрОпционально, до 2540p / 720p / 1080p1-16s
viduq3Мульти-референс/субъекты генерацияОбязательно, до 7540p / 720p / 1080p3-16s

​
Тарификация

Vidu Q3 тарифицируется по модели, разрешению и типу генерации:
  • viduq3-pro: высокое качество, примерно 2x цены turbo
  • viduq3-turbo: быстрый, лучшая экономичность
  • viduq3: мульти-референс генерация

​
Ответ

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

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

​
Текст-в-видео

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

​
Изображение-в-видео

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

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

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

​
Мульти-референс видео

{
  "model": "viduq3",
  "prompt": "Сохраняя персонажа из референсов, прогулка по футуристической улице города",
  "image_urls": [
    "https://example.com/character-front.jpg",
    "https://example.com/character-side.jpg"
  ],
  "duration": 6,
  "resolution": "1080p"
}

​
Режим Subjects

{
  "model": "viduq3",
  "prompt": "@cat и @dog бегают в парке, солнечный день",
  "image_urls": ["https://example.com/park-bg.jpg"],
  "duration": 8,
  "resolution": "720p",
  "audio": true,
  "metadata": {
    "subjects": [
      {"name": "cat", "images": ["https://example.com/cat.jpg"]},
      {"name": "dog", "images": ["https://example.com/dog.jpg"]}
    ],
    "audio_type": "all"
  }
}
Генерация видео является асинхронной задачей. Используйте Получить статус задачи для запроса прогресса и результатов.
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",
    "audio": true
  }'

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