상세 응답으로 음악 작곡

POST

/v1/music/detailed

POST

/v1/music/detailed

curl -X POST https://api.elevenlabs.io/v1/music/detailed \
     -H "xi-api-key: xi-api-key" \
     -H "Content-Type: application/json" \
     -d '{
  "prompt": "A prompt for music generation",
  "music_length_ms": 10000
}'

{
  "audio": "[binary audio data]",
  "composition_plan": {
    "negative_global_styles": [
      "metal",
      "hip-hop",
      "country"
    ],
    "positive_global_styles": [
      "pop",
      "rock",
      "jazz"
    ],
    "sections": [
      {
        "duration_ms": 10000,
        "lines": [
          "Verse 1 lyrics"
        ],
        "negative_local_styles": [
          "metal",
          "hip-hop",
          "country"
        ],
        "positive_local_styles": [
          "pop",
          "rock",
          "jazz"
        ],
        "section_name": "Verse 1"
      }
    ]
  },
  "song_metadata": {
    "description": "내 노래 설명",
    "genres": [
      "pop",
      "rock",
      "jazz"
    ],
    "is_explicit": false,
    "languages": [
      "en",
      "fr"
    ],
    "title": "My Song"
  }
}

프롬프트 또는 작곡 계획으로 노래를 만듭니다.

쿼리 매개변수

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

respect_sections_durationsboolean선택 사항기본값 true

composition_plan의 섹션 길이를 얼마나 엄격하게 적용할지 제어합니다. composition_plan과 함께 사용할 때만 적용되며 music_v1에만 해당합니다. music_v2 및 music_v2_5에서는 섹션 길이가 항상 적용되므로 이 설정은 무시됩니다. music_v1에서 false로 설정하면 모델은 계획의 전체 노래 길이를 유지하면서 품질과 지연 시간을 개선하기 위해 개별 섹션 길이를 조정할 수 있습니다.

store_for_inpaintingboolean선택 사항기본값 false

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

with_timestampsboolean선택 사항기본값 false

생성된 노래의 단어 타임스탬프를 반환할지 여부입니다.

with_waveform_visualboolean선택 사항기본값 false

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

sign_with_c2paboolean선택 사항기본값 false

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

응답 헤더

song-idstring선택 사항

생성된 노래의 고유 식별자

응답

JSON 메타데이터와 바이너리 오디오 파일이 포함된 multipart/mixed 응답

오류

422

Unprocessable Entity Error