Skip to main content
POST
Генерация видео Vidu Q3
Для пользователей из материкового Китая: используйте https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.
  • Асинхронный API задач: после отправки возвращает унифицированный generation.task
  • Доступные модели: viduq3-pro-fast, viduq3-ad, viduq3-drama, viduq3-mix
viduq3-ad, viduq3-drama и viduq3-mix — не чистые модели text-to-video. Не передавайте только prompt; требуется хотя бы референс-материал. Иначе апстрим обычно возвращает InvalidParameter, например Missing required field 'subjects' in request body.

Аутентификация

string
обязательно
Все эндпоинты требуют Bearer Token аутентификацию.

Поддерживаемые модели

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

string
обязательно
Поддерживаются только следующие 4 публичных имени моделей:
  • viduq3-pro-fast
  • viduq3-ad
  • viduq3-drama
  • viduq3-mix
string
обязательно
Промпт.Даже для моделей референс-генерации рекомендуется всегда заполнять prompt, описывая ракурсы, движение, темп и стиль.
string[]
Список URL референсных изображений.
  • viduq3-pro-fast: используется только первое изображение в качестве первого кадра
  • viduq3-ad / viduq3-drama / viduq3-mix: рекомендуется одно или несколько референсных изображений субъекта/стиля
Совместимые поля:
  • input_reference
  • reference_images
  • images
  • image
string
URL референсного видео.Рекомендуется только для viduq3-ad / viduq3-drama / viduq3-mix. Эквивалентно передаче одного основного референс-видео.
array
Список референсных видео.Используется только viduq3-ad / viduq3-drama / viduq3-mix. Каждый элемент поддерживает:
  • video_url
  • refer_type (опционально)
  • keep_original_sound (опционально)
integer
по умолчанию:5
Длительность видео в секундах. По умолчанию 5.
string
по умолчанию:"720P"
Разрешение, поддерживаются 720P и 1080P.Рекомендации:
  • Для viduq3-drama предпочтительно 1080P
boolean
Генерировать ли аудио.Текущее поведение сервера по умолчанию:
  • viduq3-pro-fast: по умолчанию true
  • viduq3-ad: по умолчанию true
  • viduq3-mix: по умолчанию true
  • viduq3-drama: передавайте значение явно, не полагайтесь на значение по умолчанию
boolean
по умолчанию:false
Добавлять ли водяной знак.
integer
Зерно генерации.
object
Расширенные параметры, передаются по структуре видео-запроса апстрима.Типичные варианты:
  • metadata.input.first_frame_url
  • metadata.input.last_frame_url
  • metadata.input.audio_url
  • metadata.parameters.audio
  • metadata.parameters.watermark
viduq3-ad / viduq3-drama / viduq3-mix на стороне апстрима могут требовать структурированный ввод субъектов (например, subjects). Запрос только с текстовым prompt обычно сразу завершается ошибкой.

Правила ввода

1. viduq3-pro-fast

  • Модель image-to-video по первому кадру
  • Требуется минимум 1 изображение
  • При передаче нескольких изображений используется только первое
  • Подходит для сценариев «оживить статичное изображение»

2. viduq3-ad / viduq3-drama / viduq3-mix

  • Модели генерации по референс-видео; вызов только с prompt не рекомендуется
  • Рекомендуется передавать минимум:
    • 1 референс-видео: url или video_list
    • 1 референсное изображение: image_urls или совместимое поле изображения
  • При отсутствии субъекта/референсов апстрим может вернуть:
    • InvalidParameter
    • Missing required field 'subjects' in request body

Примеры запросов

viduq3-pro-fast image-to-video по первому кадру

viduq3-ad генерация по референс-видео

viduq3-drama нарративная генерация по референсу

viduq3-mix смешанная генерация по референсам

Ответ при успешной отправке

Запрос задачи

GET /v1/videos/generations/{task_id} В обработке:
Успех:
Ошибка:

Примечания

  • После отправки ToAPIs централизованно опрашивает статус апстрим-задачи и возвращает стандартный результат видео-задачи.
  • viduq3-pro-fast — наиболее стабильная форма интеграции на сегодня, подходит для image-to-video по первому кадру.
  • viduq3-ad, viduq3-drama и viduq3-mix предъявляют более строгие требования к референс-материалам. Перед интеграцией подготовьте полный набор материалов по примерам выше и не передавайте только prompt.