Создать задачу «текст в видео»
- Официальная документация: https://platform.vidu.cn/docs/text-to-video
- Создаёт задачу «текст в видео» и возвращает task_id
- Управление генерацией через model, prompt и другие параметры
Authorizations
Request Body
Текстовый промпт
Текстовое описание для генерации видео.
Примечание: не более 2000 символов
Название модели
Допустимые значения: viduq3-turbo, viduq3-pro, viduq2, viduq1
- viduq3-turbo: быстрее, чем viduq3-pro
- viduq3-pro: эффективная генерация качественного аудио-видео; более живое и выразительное изображение
- viduq2: новейшая модель
- viduq1: чёткая картинка, плавные переходы, стабильная камера
Стиль
По умолчанию general; допустимо: general, anime
general: универсальный стиль; управление через промпт
anime: аниме-стиль; выраженный аниме-вид; управление разными аниме-промптами
Примечание: не действует при использовании модели q2
Длительность видео; по умолчанию зависит от модели:
- viduq3-pro, viduq3-turbo: по умолчанию 5 с, диапазон 1–16
- viduq2: по умолчанию 5 с, диапазон 1–10
- viduq1: по умолчанию 5 с, допустимо только 5
Случайное зерно (seed)
Если не указано или 0 — используется случайное значение
При ручной установке используется заданное зерно
Соотношение сторон
По умолчанию 16:9; допустимо: 16:9, 9:16, 3:4, 4:3, 1:1
Примечание: 3:4 и 4:3 поддерживаются только моделью q2
Разрешение; по умолчанию зависит от модели и длительности:
- viduq3-pro, viduq3-turbo (1–16 с): по умолчанию 720p, допустимо 540p, 720p, 1080p
- viduq2 (1–10 с): по умолчанию 720p, допустимо 540p, 720p, 1080p
- viduq1 (5 с): по умолчанию 1080p, допустимо 1080p
Амплитуда движения
По умолчанию auto; допустимо: auto, small, medium, large
Примечание: не действует при использовании модели q2
Добавлять ли фоновую музыку к сгенерированному видео.
По умолчанию false; допустимо true, false
При true система выбирает подходящую музыку из библиотеки BGM.
- Длина BGM не ограничена; подстраивается под длительность видео
Параметр сквозной передачи
Не обрабатывается; только передача данных
Примечание: максимум 1048576 символов
Добавлять ли водяной знак
- true: добавить водяной знак
- false: не добавлять
Примечание 1: содержимое водяного знака фиксировано (сгенерировано ИИ); по умолчанию выключено
Примечание 2: видео с водяным знаком доступно через параметр watermarked_url в API запроса задачи
Позиция водяного знака на изображении:
1: верхний левый угол
2: верхний правый угол
3: нижний правый угол
4: нижний левый угол
По умолчанию: 3
Содержимое водяного знака (URL изображения)
Если не указано — текст по умолчанию: «Сгенерировано ИИ»
Идентификатор метаданных (JSON-строка), сквозная передача; произвольный или примерный формат:
{
"Label": "your_label","ContentProducer": "yourcontentproducer","ContentPropagator": "your_content_propagator","ProduceID": "yourproductid", "PropagateID": "your_propagate_id","ReservedCode1": "yourreservedcode1", "ReservedCode2": "your_reserved_code2"
}
Если пусто, по умолчанию используются метаданные, сгенерированные Vidu
URL обратного вызова (POST). Укажите callback_url при создании задачи; Vidu отправляет обновления статуса на этот URL. Тело совпадает с ответом API запроса задачи.
Значения status в callback:
- processing: в обработке
- success: завершено (до 3 повторов при сбое доставки)
- failed: ошибка (до 3 повторов при сбое доставки)
Vidu использует аутентификацию по подписи callback; см. документацию по подписи callback
Responses
Успех