작곡된 음악 스트리밍 | ElevenLabs Documentation

프롬프트 또는 작곡 계획으로 작곡한 곡을 스트리밍합니다.

쿼리 매개변수

output_formatenum선택 사항기본값 auto

생성된 오디오의 출력 형식입니다. codec_sample_rate_bitrate 형식으로 지정합니다. 선택한 모델에 가장 적합한 형식을 API가 선택하도록 "auto"(기본값)를 사용하세요. v1 모델은 mp3_44100_128, v2 모델은 mp3_48000_192를 사용합니다.

요청

This endpoint expects an object.

promptstring or null선택 사항<=4100 characters

노래를 생성하기 위한 간단한 텍스트 프롬프트입니다. composition_plan과 함께 사용할 수 없습니다.

composition_planobject or null선택 사항

음악 생성을 안내하는 상세한 작곡 계획입니다. prompt와 함께 사용할 수 없습니다.

music_length_msinteger or null선택 사항3000-600000

생성할 노래의 길이(밀리초)입니다. prompt와 함께만 사용됩니다. 3000ms에서 600000ms 사이여야 합니다. 선택 사항이며, 제공하지 않으면 모델이 프롬프트를 기반으로 길이를 선택합니다.

model_idenum선택 사항기본값 music_v1

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

허용된 값:

seedinteger or null선택 사항0-2147483647

음악 생성 프로세스를 초기화하는 랜덤 시드입니다. 동일한 매개변수와 동일한 시드를 제공하면 더 일관된 결과를 얻는 데 도움이 되지만, 정확한 재현성은 보장되지 않으며 시스템 업데이트에 따라 출력이 달라질 수 있습니다. prompt와 함께 사용할 수 없습니다.

force_instrumentalboolean선택 사항기본값 false

true이면 생성된 노래가 연주곡임을 보장합니다. false이면 prompt에 따라 노래가 연주곡일 수도 아닐 수도 있습니다. prompt와 함께만 사용할 수 있습니다.

finetune_idstring or null선택 사항<=100 characters

생성에 사용할 Finetune의 ID

store_for_inpaintingboolean선택 사항기본값 false

인페인팅을 위해 생성된 노래를 저장할지 여부입니다.

응답 헤더

song-idstring선택 사항

생성된 노래의 고유 식별자

응답

지정된 형식의 스트리밍 오디오 데이터

오류

422

Unprocessable Entity Error