Перейти к основному содержанию
POST
/
v3
/
async
/
vidu-q2-pro-startend2video
VIDU Q2 Pro: первый и последний кадр
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q2-pro-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>"
}
Генерирует связное видео на основе изображений первого и последнего кадра. Поддерживаются три разрешения: 540p, 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, будет использовано случайное число; если задано вручную, будет использовано указанное зерно.
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
Использовать ли рекомендуемые подсказки. true: да, система автоматически рекомендует подсказки и использует их содержимое для генерации видео (каждая задача потребляет на 10 баллов больше); false: нет, видео генерируется на основе введенного prompt
prompt
string
Текстовая подсказка, текстовое описание для генерации видео. Примечание 1: длина не должна превышать 2000 символов. Примечание 2: если используется параметр рекомендуемых подсказок is_rec, модель не будет учитывать подсказку, введенную в этом параметреОграничение длины: 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.Возможные значения: 540p, 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
ID запроса провайдера (необязательно)