Перейти к основному содержанию
POST
/
v3
/
async
/
vidu-q2-pro-fast-startend2video
VIDU Q2 Pro Fast: начальный и конечный кадры
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q2-pro-fast-startend2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "bgm": true,
  "seed": 123,
  "images": [
    {}
  ],
  "is_rec": true,
  "prompt": "<string>",
  "wm_url": "<string>",
  "payload": "<string>",
  "duration": 123,
  "off_peak": true,
  "meta_data": "<string>",
  "watermark": true,
  "resolution": "<string>",
  "wm_position": 123,
  "movement_amplitude": "<string>"
}
'
{
  "task_id": "<string>",
  "provider_request_id": "<string>"
}
Генерирует связное видео на основе двух изображений: начального и конечного кадра (быстрый режим). Поддерживаются два разрешения: 720p и 1080p. Быстрый режим позволяет значительно сократить время генерации и подходит для сценариев с высокими требованиями к скорости.
Это асинхронный API, который возвращает только task_id асинхронной задачи. Используйте этот task_id для запроса API получения результата задачи, чтобы получить результат генерации.

Заголовки запроса

Content-Type
string
обязательно
Перечисляемое значение: application/json
Authorization
string
обязательно
Формат Bearer-аутентификации: Bearer {{API 密钥}}.

Тело запроса

bgm
boolean
по умолчанию:false
Добавлять ли фоновую музыку к сгенерированному видео. true: система автоматически выберет подходящую музыку из предустановленной библиотеки BGM и добавит ее; false: BGM не добавляется. Длительность BGM не ограничена, система автоматически адаптирует ее к длительности видео.
seed
integer
Случайное зерно. Если параметр по умолчанию не передан или передано значение 0, будет использовано случайное число; при ручной настройке используется заданное значение seed.
images
array
обязательно
Массив изображений: первое изображение считается начальным кадром, второе — конечным кадром. Модель будет генерировать видео на основе изображений, переданных в этом параметре. Поддерживается ввод двух изображений. Примечание 1: разрешения двух входных изображений начального и конечного кадров должны быть близкими; соотношение разрешения начального кадра к разрешению конечного кадра должно быть в пределах 0.8–1.25. Примечание 2: поддерживается передача изображений в кодировке Base64 или URL изображения (убедитесь, что он доступен). Примечание 3: поддерживаемые форматы изображений: png, jpeg, jpg, webp. Примечание 4: размер изображения не должен превышать 50M. Примечание 5: кодировка Base64 должна содержать соответствующую строку типа содержимого, например: data:image/png;base64,Длина массива: 2 - 2
is_rec
boolean
по умолчанию:false
Использовать ли рекомендованный prompt. true: да, система автоматически рекомендует prompt и использует его содержимое для генерации видео (каждая задача дополнительно расходует 10 кредитов); false: нет, видео генерируется на основе введенного prompt.
prompt
string
Текстовый prompt — текстовое описание для генерации видео. Примечание 1: длина не должна превышать 2000 символов. Примечание 2: если используется параметр рекомендованного prompt is_rec, модель не будет учитывать prompt, переданный в этом параметре.Ограничение длины: 0 - 2000
wm_url
string
Содержимое водяного знака, здесь — URL изображения. Если не передано, используется водяной знак по умолчанию: контент создан AI.
payload
string
Сквозной параметр: не обрабатывается, используется только для передачи данных. Максимум 1048576 символов.Ограничение длины: 0 - 1048576
duration
integer
по умолчанию:5
Длительность видео (в секундах), поддерживается 1–8 секунд.Допустимые значения: 1, 2, 3, 4, 5, 6, 7, 8
off_peak
boolean
по умолчанию:false
Режим вне пиковых нагрузок. true: генерация видео вне пиковых нагрузок (расходует меньше кредитов, генерируется в течение 48 часов); false: немедленная генерация видео. Примечание: задачи, отправленные в режиме вне пиковых нагрузок, которые не удалось завершить, будут автоматически отменены с возвратом кредитов; вы также можете вручную отменить задачу вне пиковых нагрузок.
meta_data
string
Идентификатор метаданных, строка в формате json, сквозное поле. Вы можете задать собственный формат или использовать формат из примера. Если этот параметр пуст, по умолчанию используется идентификатор метаданных, сгенерированный vidu.
watermark
boolean
по умолчанию:false
Добавлять ли водяной знак. По умолчанию водяной знак не добавляется. Вы можете получить видеоконтент с водяным знаком через параметр watermarked_url при запросе результата.
resolution
string
по умолчанию:"720p"
Разрешение выходного видео. Поддерживаются 720p и 1080p. Значение по умолчанию: 720p.Допустимые значения: 720p, 1080p
wm_position
integer
по умолчанию:3
Положение водяного знака — указывает, где водяной знак появится на изображении. 1: верхний левый угол; 2: верхний правый угол; 3: нижний правый угол (по умолчанию); 4: нижний левый угол.Допустимые значения: 1, 2, 3, 4
movement_amplitude
string
по умолчанию:"auto"
Амплитуда движения, управляет интенсивностью движения объектов в видео.Допустимые значения: auto, small, medium, large

Информация об ответе

task_id
string
обязательно
Используйте task_id для запроса API получения результата задачи, чтобы получить сгенерированный результат.
provider_request_id
string
Provider request ID (optional)