Создать видео

Создание видеозадачи через API платформы Video Generations.

Отправляйте запрос с общей структурой JSON и получайте ID задачи; параметры модели передаются через общие поля или metadata.

POST/v1/video/generations

Создавайте асинхронные задачи генерации видео по текстовому запросу и необязательному изображению. API возвращает task_id для последующего получения состояния и результата задачи.

Поддерживаемые виды входных данных и расширенные параметры поставщика зависят от модели. Выберите модель, доступную текущему ключу API и поддерживающую генерацию видео, и передавайте только поддерживаемые ею параметры.

Аутентификация

bearerAuth

АутентификацияBearer <token>

Используйте Bearer your-api-key в Header Authorization.

Расположение: header

Тело запроса

application/json

Передавайте модель, текстовый запрос и необязательные параметры генерации видео в JSON.

Определения типов TypeScript

Используйте тип request body в TypeScript.

model*string

ID видеомодели. Выберите модель, доступную текущему ключу API и поддерживающую генерацию видео.

Длина1 <= length

prompt*string

Описание желаемого видео. Чётко укажите объект, действие, сцену, работу камеры и стиль.

Длина1 <= length

duration?number

Длительность видео в секундах. Допустимый диапазон зависит от выбранной модели.

fps?integer

Частота кадров выходного видео. Поддержка и допустимый диапазон зависят от выбранной модели.

height?integer

Высота выходного видео. Можно использовать вместе с width; поддержка зависит от выбранной модели.

width?integer

Ширина выходного видео. Можно использовать вместе с height; поддержка зависит от выбранной модели.

size?string

Размеры выходного видео, обычно в формате ширинаxвысота; допустимые размеры зависят от выбранной модели.

image?string

Входное изображение для генерации видео по изображению: URL изображения или данные Base64. Конкретный формат зависит от выбранной модели.

metadata?

Расширенные параметры поставщика или модели, например negative_prompt, style, quality_level, начальный и конечный кадры и адрес callback. Поддержка этих полей не гарантируется для всех видеомоделей.

n?integer

Желаемое количество видео. Поддержка и допустимый диапазон зависят от выбранной модели.

response_format?string

Желаемый формат ответа. Допустимые значения зависят от выбранной модели и канала.

seed?integer

Seed для управления случайностью генерации. Поддержка зависит от выбранной модели.

user?string

Идентификатор конечного пользователя, предоставленный вызывающей стороной.

Тело ответа

`application/json`

curl -X POST "https://example.com/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "Астронавт в скафандре идёт по Луне, высокое качество, кинематографический стиль",    "size": "1920x1080",    "image": "https://example.com/input.jpg",    "duration": 5,    "metadata": {      "seed": 20231234,      "negative_prompt": "Размытость",      "image_tail": "https://example.com/end-frame.png"    }  }'

{
  "id": "video_123",
  "object": "video",
  "model": "MODEL_ID",
  "created_at": 1640995200,
  "task_id": "abcd1234efgh",
  "status": "processing"
}

Аутентификация

Тело запроса

Тело ответа

201application/json

400application/json

401application/json

403application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`