Compor música com uma resposta detalhada

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": "Minha descrição da música",
    "genres": [
      "pop",
      "rock",
      "jazz"
    ],
    "is_explicit": false,
    "languages": [
      "en",
      "fr"
    ],
    "title": "My Song"
  }
}

Componha uma música a partir de um prompt ou plano de composição.

Parâmetros de consulta

output_formatenumOpcionalPadrão é auto

Formato de saída do áudio gerado. Formatado como codec_sample_rate_bitrate. Use “auto” (o padrão) para que a API escolha o melhor formato para o modelo selecionado: mp3_44100_128 para modelos v1 e mp3_48000_192 para modelos v2.

Solicitação

This endpoint expects an object.

promptstring or nullOpcional<=4100 characters

Um prompt de texto simples para gerar uma música. Não pode ser usado junto com composition_plan.

composition_planobject or nullOpcional

Um plano de composição detalhado para orientar a geração de música. Não pode ser usado junto com prompt.

music_length_msinteger or nullOpcional3000-600000

A duração, em milissegundos, da música a ser gerada. Usada apenas em conjunto com prompt. Deve estar entre 3000 ms e 600000 ms. Opcional — se não for informada, o modelo escolherá uma duração com base no prompt.

model_idenumOpcionalPadrão é music_v1

O modelo a ser usado na geração.

Valores permitidos:

seedinteger or nullOpcional0-2147483647

Seed aleatória para inicializar o processo de geração de música. Fornecer a mesma seed com os mesmos parâmetros pode ajudar a obter resultados mais consistentes, mas a reprodutibilidade exata não é garantida, e as saídas podem mudar entre atualizações do sistema. Não pode ser usada junto com prompt.

force_instrumentalbooleanOpcionalPadrão é false

Se for true, garante que a música gerada será instrumental. Se for false, a música pode ou não ser instrumental, dependendo do prompt. Só pode ser usado com prompt.

finetune_idstring or nullOpcional<=100 characters

O ID do finetune a usar para a geração

respect_sections_durationsbooleanOpcionalPadrão é true

Controla o rigor com que as durações das seções no composition_plan são aplicadas. Usado apenas com composition_plan e aplicável somente a music_v1; em music_v2 e music_v2_5, as durações das seções são sempre aplicadas e este parâmetro é ignorado. Quando definido como false para music_v1, o modelo pode ajustar as durações de seções individuais para melhorar a qualidade e a latência, preservando a duração total da música definida no plano.

store_for_inpaintingbooleanOpcionalPadrão é false

Se deve armazenar a música gerada para inpainting.

with_timestampsbooleanOpcionalPadrão é false

Se deve retornar os timestamps das palavras na música gerada.

with_waveform_visualbooleanOpcionalPadrão é false

Se deve retornar a forma de onda visual da música gerada.

sign_with_c2pabooleanOpcionalPadrão é false

Se deve assinar a música gerada com C2PA. Aplicável apenas a arquivos mp3.

Cabeçalhos de resposta

song-idstringOpcional

Identificador exclusivo da música gerada

Resposta

Resposta multipart/mixed com metadados JSON e arquivo de áudio binário

Erros

422

Unprocessable Entity Error