Перейти к основному содержанию
POST
/
v3
/
async
/
vidu-q2-turbo-startend2video
VIDU Q2 Turbo: первый и последний кадры
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q2-turbo-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. Версия Turbo обеспечивает баланс между скоростью генерации и качеством видео.
Это асинхронный 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 запроса провайдера (необязательно)