Перейти к основному содержанию
POST
/
v3
/
async
/
veo-3.1-generate-img2video
Veo 3.1 — генерация видео по изображению
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/veo-3.1-generate-img2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "prompt": "<string>",
  "image": "<string>",
  "last_image": "<string>",
  "reference_images": [
    {
      "image": "<string>",
      "reference_type": "<string>"
    }
  ],
  "aspect_ratio": "<string>",
  "duration_seconds": 123,
  "enhance_prompt": true,
  "generate_audio": true,
  "negative_prompt": "<string>",
  "person_generation": "<string>",
  "resolution": "<string>",
  "sample_count": 123,
  "seed": {}
}
'
{
  "task_id": "<string>"
}
API версии Veo 3.1 Preview уже автоматически совместим с этим интерфейсом
Используйте модель генерации видео Veo 3.1 для создания высококачественного видеоконтента на основе входного изображения и текстового описания. Этот интерфейс работает асинхронно; для получения итогового результата необходимо выполнить запрос по task_id.

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

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

​
Тело запроса

​
prompt
string
обязательно
Текстовая строка, описывающая видео, которое вы хотите сгенерировать.
​
image
string
Входное изображение; поддерживается передача через URL или в формате base64.
​
last_image
string
Конечное изображение, используемое для заполнения последнего кадра видео. Поддерживается передача через URL или в формате base64.
​
reference_images
object[]
Список максимум из трех изображений типа asset или максимум одного изображения типа style, используемый для описания референсных изображений, которые модель будет использовать при генерации видео.
​
aspect_ratio
string
Задает соотношение сторон генерируемого видео.Перечисляемые значения: 16:9, 9:16. Значение по умолчанию: 16:9.
​
duration_seconds
integer
Длительность видеофайла, который вы хотите сгенерировать, в секундах.Перечисляемые значения: 4, 6, 8; при использовании reference_images доступно только значение 8.Значение по умолчанию: 8.
​
enhance_prompt
boolean
Указывает, нужно ли использовать Gemini для улучшения вашего промпта. Поддерживается только true.Значение по умолчанию: true
​
generate_audio
boolean
обязательно
Указывает, нужно ли генерировать аудио для видео.
​
negative_prompt
string
Текстовая строка, описывающая содержимое, генерацию которого модель должна избегать.
​
person_generation
string
Настройка безопасности, управляющая тем, разрешена ли генерация людей или лиц.Перечисляемые значения:
  • allow_adult (по умолчанию): разрешена генерация только взрослых
  • dont_allow: не разрешать наличие людей или лиц на изображении
  • allow_all: разрешена генерация людей всех возрастов (проект должен находиться в allowlist)
​
resolution
string
Разрешение генерируемого видео.Перечисляемые значения: 720p (по умолчанию) или 1080p
​
sample_count
integer
Количество образцов видео, которые нужно сгенерировать.Диапазон значений: 1-4
​
seed
uint32
Число, используемое для инициализации процесса случайной генерации. Использование одного и того же seed, промпта и других параметров приведет к одинаковому выходному видео, делая процесс генерации детерминированным.Диапазон значений: 0-4,294,967,295

​
Параметры ответа

​
task_id
string
обязательно
task_id асинхронной задачи. Используйте этот task_id для запроса API получения результата задачи, чтобы получить результат генерации