Музыкальное видео
Создайте музыкальное видео из изображений и аудио с творческими настройками.
Если исходный файл локальный, загрузите его и используйте полученный data.url. Сохраните data.id, опрашивайте задачу и соблюдайте правила обработки ошибок и повторов.
Аутентификация
Передавайте API-ключ в виде Authorization: Bearer <BEATAPI_API_KEY>.
Заголовки
Необязательный ключ повторного запроса. Повторное использование того же ключа с тем же телом возвращает принятую задачу; с другим телом возвращает 409 idempotency_conflict.
Запрос
Публичный HTTPS URL аудио верхнего уровня. Standard принимает 10–180 секунд; Premium — 10–300 секунд.
Тариф музыкального видео. Для Standard не указывайте поле; для Premium обязательно значение premium.
Изображения сцен верхнего уровня. Standard требует 1–7. Режимы sing в Premium принимают 0–6; dance и perform в Premium требуют ровно 6 публичных HTTPS URL PNG, JPEG или WebP.
Необязательные творческие указания для сюжета, места действия, исполнения, камеры, освещения и темпа. Не более 3000 символов.
Язык диалогов и текста песни в процессе Standard.
Уровень качества генерации. Высокое качество недоступно при 540p.
Необязательное краткое описание визуального стиля, например кино, аниме, документальный или модная редакционная съёмка.
Целевой формат размещения. Указывайте явно в соответствии с плеером или лентой соцсети.
Разрешение результата верхнего уровня. Standard принимает 540p, 720p или 1080p; Premium фиксирован на 720p.
Создать исполнение с синхронизацией губ. При true обязателен lip_ref_url.
Публичное HTTPS изображение лица крупным планом анфас для синхронизации губ в Standard.
Встроить сгенерированные или предоставленные субтитры в итоговое видео.
Цвет текста субтитров в виде шестизначного шестнадцатеричного значения. Используется при включённых субтитрах.
Необязательный публичный HTTPS URL файла субтитров .srt. Локальные субтитры загрузите через POST /v1/files.
Только резервная длительность верхнего уровня для тарификации; определённая длительность аудио имеет приоритет. Standard принимает 10–180 секунд, Premium — 10–300 секунд.
Auto автоматически собирает итоговое музыкальное видео; manual останавливается на requires_action, чтобы можно было просмотреть или изменить фрагменты перед сборкой.
Режим исполнения Premium. Режимы sing требуют lip_ref_urls; dance и perform — ровно шесть images.
Обязательно для sing и sing_perform; не указывайте для dance и perform. Передайте одно или два публичных HTTPS изображения лица крупным планом анфас.
Ответ
Задача принята
Принятое или текущее состояние задачи BeatAPI.