Перейти к основному содержанию
POST
/
v3
/
async
/
veo-3.0-generate-preview-text2video
Генерация видео из текста с Veo 3.0 Preview
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/veo-3.0-generate-preview-text2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "prompt": "<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>"
}
Используйте модель генерации видео Veo 3.0 Preview, чтобы создавать высококачественный видеоконтент по текстовому описанию. Этот интерфейс использует асинхронную обработку; для получения итогового результата необходимо выполнить запрос по task_id.

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

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

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

​
prompt
string
обязательно
Текстовая строка, описывающая видео, которое вы хотите сгенерировать.
​
aspect_ratio
string
Указывает соотношение сторон генерируемого видео.Допустимые значения: 16:9, 9:16. Значение по умолчанию: 16:9.
​
duration_seconds
integer
Длина видеофайла, который вы хотите сгенерировать, в секундах.Допустимые значения: 4, 6, 8. Значение по умолчанию: 8.
​
enhance_prompt
boolean
Указывает, использовать ли Gemini для улучшения вашего промпта.Значение по умолчанию: 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 получения результата задачи и получить результат генерации