Skip to main content
Geração de música

Music generation API reference(Fun-Music)

Parâmetros da API do modelo de geração de música Fun-Music.

Guia do usuário: Para obter uma visão geral do modelo e orientações de seleção, consulte Geração de música.
Este modelo está atualmente em visualização limitada. Solicite acesso na Model Gallery antes de utilizá-lo. O modelo está disponível apenas na região China (Pequim).

Pré-requisitos

Uma chave de API é necessária. Para obtê-la, consulte Obter uma chave de API.

Endpoint

POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/music/generation. Substitua WorkspaceId pelo seu ID do workspace real. Protocolo: HTTPS. Para saída em streaming, defina o cabeçalho de requisição X-DashScope-SSE para ativar o SSE (Server-Sent Events).
O Model Studio lançou domínios específicos por workspace para as regiões China (Pequim) e Cingapura. Os novos domínios dedicados oferecem desempenho superior e maior estabilidade para requisições de inferência. Recomendamos migrar para os novos domínios:
  • China (Pequim): de https://dashscope.aliyuncs.com para https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com
  • Cingapura: de https://dashscope-intl.aliyuncs.com para https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com
{WorkspaceId} é o ID do seu workspace, disponível na página Workspace Details no console do Model Studio. O domínio existente permanece totalmente funcional.

Cabeçalhos da requisição

Parâmetro

Tipo

Obrigatório

Descrição

Authorization

string

Sim

Bearer {api-key}. Substitua {api-key} pela sua chave de API.

Content-Type

string

Sim

application/json

X-DashScope-SSE

string

Não

Defina como enable para ative a saída em streaming SSE.

Corpo da requisição 

curl -X POST 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/music/generation' \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "fun-music-v1",
    "input": {
        "prompt": "Fresh summer folk song, acoustic guitar and harmonica accompaniment, upbeat tempo, suitable as background music for travel vlogs",
        "gender": "female"
    }
}'
modelstring(obrigatório)Nome do modelo. Valores permitidos:
  • fun-music-v1
  • fun-music-preview
inputobject(obrigatório)Parâmetros de entrada.

Propriedades

promptstring(condicionalmente obrigatório)Prompt de texto. O modelo compõe e gera música automaticamente com base neste prompt.
  • fun-music-v1: Forneça lyrics ou prompt.
  • fun-music-preview: Obrigatório.
Limites de caracteres:
  • Sem streaming: 1 a 2.000 caracteres
  • Com streaming: 5 a 1.000 caracteres chineses ou palavras em inglês
Se você fornecer prompt e lyrics simultaneamente, apenas lyrics terá efeito; o sistema ignorará prompt.
lyricsstring(condicionalmente obrigatório)Letra da música gerada.
  • fun-music-v1: Forneça prompt ou lyrics.
  • fun-music-preview: Opcional.
Limites de caracteres:
  • Sem streaming: 5 a 350 caracteres chineses ou 5 a 2.000 caracteres em inglês
  • Com streaming: 300 a 350 caracteres chineses ou 200 a 250 palavras em inglês
Se você fornecer lyrics e prompt simultaneamente, apenas lyrics terá efeito; o sistema ignorará prompt.
genderstring(opcional) Padrão: femaleGênero vocal. Compatível apenas com o modelo fun-music-v1. Valores válidos:
  • male: Voz masculina
  • female: Voz feminina
formatstring(opcional) Padrão: mp3Formato de codificação de áudio. Valores válidos:
  • mp3: Adequado para transferência via rede e armazenamento
  • wav: Ideal para pós-processamento e reprodução de alta qualidade
enable_aigc_watermarkboolean(opcional) Padrão: falseAtivador de marca d'água AIGC. Quando ativado, um sinal de áudio em código Morse representando "AI" (·— ··) é anexado ao final do áudio gerado para identificar o conteúdo como gerado por IA. Ativar a marca d'água aumenta a duração do áudio.

Objeto de resposta 

{
    "output": {
        "audio": {
            "data": "",
            "expires_at": 1774936147,
            "id": "audio_46c51288-7ed6-95cc-a119-xxxxxxxxxxxx",
            "url": "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/pre/fun-music/20260330/xxxxxxxx/a8db24cc-d35f-961b-af81-a9e8d8b01f67.mp3?xxx"
        },
        "extra_info": {
            "channels": 2,
            "lyrics": "[verse]\nMorning sunlight slips through the curtain,\nCoffee aroma fills up the room.\nOpen the book left unfinished yesterday,\nTime quietly drifts by this way.\n\n[chorus]\nTake it slow, there's no hurry,\nLife should be this carefree.\nToss your worries into the wind,\nEmbrace every sunny day and rainy season.",
            "sample_rate": "48000"
        },
        "finish_reason": "stop"
    },
    "usage": {
        "duration": 200
    },
    "request_id": "46c51288-7ed6-95cc-a119-xxxxxxxxxxxx"
}
request_id stringID da requisição. Use para solução de problemas e rastreamento de logs.
outputobjectSaída do modelo.

Propriedades

audio objectSaída de áudio do modelo.

Propriedades

data stringFragmentos de áudio codificados em Base64 no modo de streaming. String vazia no modo sem streaming.url stringURL do OSS do arquivo de áudio completo, válida por 24 horas. Presente em todas as respostas sem streaming e apenas na mensagem final de streaming.id stringID do arquivo de áudio.expires_at integerTimestamp Unix que indica quando a URL do áudio expira.
extra_info objectMetadados adicionais sobre o áudio gerado.

Propriedades

channels integerNúmero de canais de áudio. Por exemplo, 2 indica estéreo.sample_rate stringTaxa de amostragem do áudio. Por exemplo, "48000".lyrics stringLetra da música gerada.
finish_reason stringStatus da geração:
  • null: Geração em andamento
  • stop: Geração concluída
usage objectInformações de faturamento desta requisição.

Propriedades

duration integerDuração da música em segundos, usada para faturamento.
Uso da API
Referência da API de Geração de Texto
Geração de Imagens
  • FAQ
Geração de Vídeo
Áudio
Multimodal em Tempo Real
API em tempo real
Incorporação de Texto
Mais Modelos
Toolkit/Framework
Produção de Modelos
File Management
Gerenciamento de modelos
Mais