비디오-음악 변환 | ElevenLabs Documentation

하나 이상의 비디오 파일에서 배경 음악을 생성합니다. 비디오는 순서대로 결합됩니다. 선택 사항인 설명과 스타일 태그는 생성되는 음악에 영향을 줍니다.

쿼리 매개변수

output_formatenum선택 사항

생성된 오디오의 출력 형식입니다. codec_sample_rate_bitrate 형식으로 지정합니다. 예를 들어 샘플링 레이트가 22.05kHz이고 32kbps인 mp3는 mp3_22050_32로 표현됩니다. 비트레이트가 192kbps인 MP3를 사용하려면 크리에이터 이상의 요금제에 가입해야 합니다. 샘플링 레이트가 44.1kHz인 PCM 형식을 사용하려면 프로 이상의 요금제에 가입해야 합니다. μ-law 형식(mu-law로 표기되기도 하며 흔히 u-law로 근사 표기됨)은 Twilio 오디오 입력에 일반적으로 사용됩니다.

요청

This endpoint expects a multipart form with multiple files.

videosfiles필수

FormData 배열(multipart/form-data)을 통해 전송되는 하나 이상의 비디오 파일입니다. 순서대로 하나의 코덱으로 결합됩니다. 최대 10개의 비디오를 허용하며, 결합된 비디오의 총 크기는 200MB로 제한됩니다. 비디오의 총 길이는 최대 600초입니다. 여러 비디오를 결합하면 요청 시간이 크게 늘어날 수 있습니다. 가능하다면 미리 비디오를 결합하세요.

descriptionstring or null선택 사항1-1000 characters

원하는 음악에 대한 선택적 텍스트 설명입니다. 최대 1,000자까지 허용됩니다.

tagslist of strings선택 사항기본값 []

선택적 스타일 태그 목록입니다(예: ['upbeat', 'cinematic']). 최대 10개의 태그를 사용할 수 있습니다.

model_idenum선택 사항기본값 music_v1

생성에 사용할 모델입니다.

허용된 값:

sign_with_c2paboolean선택 사항기본값 false

생성된 노래에 C2PA 서명을 적용할지 여부입니다. mp3 파일에만 적용됩니다.

응답

비디오에 맞춰 생성된 오디오 파일입니다. Content-Type과 파일 확장자는 output_format 매개변수에 따라 달라집니다(기본값: mp3).

오류

403

Forbidden Error

422

Unprocessable Entity Error

헤더

쿼리 매개변수

요청

응답

오류