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

Создавайте асинхронную задачу по текстовому запросу и необязательному опорному изображению и получайте Video ID для проверки состояния и скачивания результата.

POST/v1/videos

Создавайте асинхронные задачи генерации видео по текстовому запросу и необязательному опорному изображению. API принимает Multipart-запрос, совместимый с OpenAI Videos, и возвращает Video ID для получения состояния задачи.

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

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

bearerAuth

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

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

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

Тело запроса

multipart/form-data

Передавайте текстовый запрос, модель и необязательное опорное изображение в Multipart. Библиотека запросов должна автоматически формировать boundary для Content-Type.

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

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

prompt*string

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

Длина1 <= length

model?string

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

Длина1 <= length

seconds?string

Длительность видео в секундах, по умолчанию 4; допустимые значения зависят от выбранной модели.

По умолчанию"4"

size?string

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

По умолчанию"720x1280"

input_reference?file

Опорное изображение, загружаемое для генерации видео по изображению. Некоторые совместимые модели не принимают прямую загрузку файлов; для них передавайте URL изображения через metadata.img_url.

Форматbinary

metadata?string

Расширенные параметры поставщика или модели, передаваемые как JSON-строка. Не считайте эти поля общими параметрами, поддерживаемыми всеми видеомоделями.

Расширенные ключи серии Wan: img_url, first_frame_url, last_frame_url, watermark, prompt_extend, audio, seed и resolution. URL изображения используется для генерации видео по изображению, URL начального и конечного кадров — для видео по ключевым кадрам; audio применяется только к моделям, поддерживающим генерацию аудио.

Варианты разрешения: 480P (832x480, 480x832, 624x624), 720P (1280x720, 720x1280, 960x960, 1088x832, 832x1088) и 1080P (1920x1080, 1080x1920, 1440x1440, 1632x1248, 1248x1632). Фактическая поддержка определяется выбранной моделью.

Тело ответа

`application/json`

curl -X POST "https://example.com/v1/videos" \  -F prompt="Астронавт в скафандре идёт по Луне, высокое качество, кинематографический стиль" \  -F model="MODEL_ID" \  -F seconds="4" \  -F size="720x1280"

{
  "id": "video_123",
  "object": "video",
  "model": "MODEL_ID",
  "created_at": 1640995200,
  "status": "processing",
  "progress": 0
}

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

Тело запроса

Тело ответа

201application/json

400application/json

401application/json

403application/json

404application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`