ElevenAPIMusic

음악 업로드

나중에 인페인팅에 사용할 음악 파일을 업로드합니다. 업로드 가격은 노래 생성 가격과 같습니다. 업로드되는 모든 콘텐츠는 저작권 침해 여부를 검사합니다. 저작권이 있는 콘텐츠가 감지되면 요청 비용의 절반이 청구됩니다.

헤더

xi-api-keystring선택 사항

요청

This endpoint expects a multipart form containing a file.
filefile필수

업로드할 오디오 파일입니다.

extract_composition_planboolean or enum선택 사항기본값 false
업로드한 노래의 구성 계획을 생성하여 반환할지 여부입니다. 반환할 구성 계획 형식을 제어하려면 모델 ID(`music_v1`, `music_v2` 또는 `music_v2_5`)를 전달하세요. `true`/`false` 전달은 지원 중단되었으며, `true`는 기본적으로 `music_v1` 계획 형식을 사용합니다. 이를 활성화하면 지연 시간이 증가합니다.
with_timestampsboolean선택 사항기본값 false

업로드된 노래를 트랜스크립션하고 단어 수준 타임스탬프를 반환할지 여부입니다. True이면 응답에 words_timestamps가 포함되지만 지연 시간이 늘어납니다.

with_waveform_visualboolean선택 사항기본값 false

업로드된 노래의 시각적 파형을 반환할지 여부입니다.

응답

선택적 작곡 계획과 함께 음악 파일을 성공적으로 업로드했습니다.

song_idstring

업로드된 노래의 고유 식별자

composition_planobject or null선택 사항

업로드된 노래에서 추출한 작곡 계획입니다. 요청 본문에 extract_composition_plan이 제공된 경우에만 포함됩니다.

words_timestampslist of objects or null선택 사항

업로드된 노래에서 트랜스크립션된 단어 수준 타임스탬프입니다. 요청 본문에서 with_timestamps가 True인 경우에만 포함됩니다.

waveform_visuallist of integers or null선택 사항

업로드된 노래의 미리보기를 표시하기 위한 저해상도 파형입니다. 오디오 초당 -1000~1000 범위의 값 4개를 포함합니다. 스테레오는 단일 채널로 믹스다운됩니다. 요청 본문에서 with_waveform_visual이 True인 경우에만 제공됩니다.

오류

422
Unprocessable Entity Error