Создание задачи «изображение → видео»
- Официальная документация: https://platform.vidu.cn/docs/image-to-video
- Создаёт задачу «изображение → видео» и возвращает task_id или сведения о задаче
- Управление генерацией через параметры запроса
Authorizations
Request Body
Текстовый промпт
Текстовое описание для генерации видео.
Примечание: не более 2000 символов
Имя модели
Допустимые значения: viduq2, viduq1, viduq3-turbo, viduq3-pro
- viduq3-turbo: быстрее, чем viduq3-pro
- viduq3-pro: эффективная генерация качественного аудио-видео; более выразительный результат
- viduq2: новейшая модель
- viduq1: чёткое изображение, плавные переходы, стабильная камера
Длительность видео; по умолчанию зависит от модели:
- viduq3-pro, viduq3-turbo: по умолчанию 5 с, диапазон 1–16
- viduq2: по умолчанию 5 с, диапазон 1–10
- viduq1: по умолчанию 5 с, только 5
Случайное зерно
Если не указано или 0 — используется случайное значение
При ручной установке используется заданное зерно
Разрешение; по умолчанию зависит от модели и длительности:
- 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
Параметр сквозной передачи
Не обрабатывается; только передача данных
Примечание: максимум 1048576 символов
Режим непиковой нагрузки; по умолчанию false; допустимо:
- true: генерация в непиковом режиме
- false: немедленная генерация
Примечание 1: в непиковом режиме расходуется меньше кредитов; см. тарифы
Примечание 2: задачи в непиковом режиме выполняются в течение 48 часов; незавершённые отменяются с возвратом кредитов
Примечание 3: задачу в непиковом режиме можно отменить вручную
Добавлять ли водяной знак
- 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). Укажите при создании задачи; Vidu отправляет обновления статуса. Тело совпадает с ответом API запроса задачи.
Значения status в callback:
- processing: в обработке
- success: завершено (до 3 повторов при сбое доставки)
- failed: ошибка (до 3 повторов при сбое доставки)
Vidu использует подпись callback; см. документацию по подписи
Изображение первого кадра
Модель использует изображение из этого параметра как первый кадр для генерации видео.
Примечание 1: поддерживается Base64 или URL (должен быть доступен)
Примечание 2: только 1 изображение
Примечание 3: форматы: png, jpeg, jpg, webp
Примечание 4: соотношение сторон меньше 1:4 или 4:1
Примечание 5: размер изображения не более 50 МБ
Примечание 6: тело HTTP POST не более 20 МБ; укажите корректный Content-Type, например:
data:image/png;base64,{base64_encode}
Прямой вывод аудио-видео; по умолчанию false; допустимо:
- false: без прямого вывода (беззвучное видео)
- true: видео с диалогом и фоновым звуком
Примечание 1: voice_id действует только при true
Примечание 2: при model q3-pro или q3-turbo по умолчанию true
Примечание 3: при true режим непиковой нагрузки недоступен
ID голоса
Определяет тембр в видео; если пусто — система рекомендует. Список: https://shengshu.feishu.cn/sheets/EgFvs6DShhiEBStmjzccr5gonOg
Использовать рекомендуемые промпты
- true: система рекомендует промпты (количество=1) и генерирует по ним
- false: генерация по введённому prompt
Примечание: рекомендуемые промпты добавляют 10 кредитов за задачу
Responses
Успех