POST
Отправьте заявку на создание видео

Authorizations

Authorization
string
header
required

API-ключ в качестве токена носителя в заголовке авторизации

Body

application/json
model
string
required
aspect_ratio
enum<string>

Соотношение сторон создаваемого видео

Available options:
16:9,
9:16,
1:1,
4:3,
3:4,
3:2,
2:3,
21:9,
9:21
Example:

"16:9"

callback_url
string<uri>

URL-адрес для получения уведомления веб-перехватчика после завершения задания создания видео. Переопределяет URL-адрес обратного вызова по умолчанию на уровне рабочей области, если он установлен. Должно быть HTTPS.

Example:

"https://example.com/webhook"

duration
integer

Продолжительность создаваемого видео в секундах

Required range: x >= 1
Example:

8

frame_images
object[]

Изображения, которые будут использоваться в качестве первого и/или последнего кадра созданного видео. Для каждого изображения должен быть указан тип_фрейма first_frame или Last_frame.

generate_audio
boolean

Создавать ли звук вместе с видео. По умолчанию используется флаг возможности генерирования_аудио эндпоинта, false, если не установлен.

Example:

true

input_references
object[]

Справочные материалы для создания видео. Принимает изображения, аудио и видео ссылки. Ссылки на аудио и видео учитываются только теми поставщиками, которые их поддерживают (в настоящее время BytePlus Seedance 2.0); другие поставщики используют ссылки на изображения и игнорируют все остальное.

Эталонный ресурс, используемый для создания видео. Ссылки на изображения поддерживаются всеми поставщиками; ссылки на аудио и видео учитываются только теми поставщиками, которые их поддерживают (в настоящее время BytePlus Seedance 2.0).

Example:
prompt
string

Текстовая подсказка с описанием создаваемого видео. Необязательно для моделей, которые поддерживают создание видео только из входного изображения; требуется для всех остальных моделей.

Example:

"A serene mountain landscape at sunset"

provider
object

Конфигурация транзитной передачи для конкретного поставщика

resolution
enum<string>

Разрешение создаваемого видео

Available options:
480p,
720p,
768p,
1080p,
1K,
2K,
4K
Example:

"720p"

seed
integer

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

size
string

Точные размеры создаваемого видео в пикселях в формате «ШИРИНАxВЫСОТА» (например, «1280x720»). Взаимозаменяемо с разрешением + соотношением сторон.

Example:

"1280x720"

Response

Запрос на создание видео принят

id
string
required
polling_url
string
required
status
enum<string>
required
Available options:
pending,
in_progress,
completed,
failed,
cancelled,
expired
error
string
generation_id
string

Идентификатор поколения, связанный с этим заданием по созданию видео. Доступно после обработки задания.

unsigned_urls
string[]
usage
object

Информация об использовании и стоимости создания видео. Доступен после завершения работы.

Example: