Music generation

​

Visão geral

• prompt: Descreva o estilo musical, a cena, o clima e as preferências de instrumentos. O modelo escreve a letra e gera a música automaticamente.
• lyrics: Forneça letras personalizadas. O modelo compõe e executa uma música com base no seu texto.
• gender: Selecione vocais masculinos ou femininos (apenas fun-music-v1).
• Saída em streaming e sem streaming
• Saída de áudio nos formatos MP3 e WAV

​

Diferenças entre os dois modelos

​

Formatos de saída de áudio

​

Pré-requisitos

• Uma chave de API. Para mais informações, consulte Obter uma chave de API.
• Chave de API configurada como variável de ambiente (recomendado):

export DASHSCOPE_API_KEY="sk-xxx"

​

Início rápido

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"
    }
}'

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": {
        "lyrics": "[verse]\nMorning sunlight streams through the curtains,\nThe aroma of coffee fills the room.\nOpening a book left unfinished yesterday,\nTime quietly slips away like this.\n\n[chorus]\nTake it slow, no need to rush,\nLife should be this easygoing.\nToss all the worries into the wind,\nEmbrace every sunny day and rainy season.",
        "gender": "female"
    }
}'

​

Guia de composição

​

Prompt

• Recomendado: Melancholic piano, rainy night yearning
• Não recomendado: Melancholic music (muito vago)

​

Letras

[intro]
Piano keys fall gently, the evening breeze is cool.
That summer, heartbeats quietly grew warm.

[verse]
By the classroom window, sunlight slants across your profile.
Borrowing half an eraser, fingertips spark an electric line.
On the way home from school, bicycle bells chase the clouds.
You said the future is far away, but I wanted to walk to the end.

[chorus]
Youth is an unopened letter, filled with brave promises.
Even if the world flickers bright and dark, with you I see the light.
Love is like the sweet rain of early summer, soaking dreams without fear of distance.
We run toward tomorrow with laughter, hand in hand, never looking back.

[bridge]
Later, wind and rain scattered the paper umbrella, silence replaced the answers.
But the song in my heart is unfinished, still waiting for "don't drift apart."

[chorus]
Youth is an unopened letter, filled with brave promises.
Even if the world flickers bright and dark, with you I see the light.
Love is like the sweet rain of early summer, soaking dreams without fear of distance.
We run toward tomorrow with laughter, hand in hand, never looking back.

[outro]
The piano fades, starlight paves the long street.
The story is unfinished, the next page is still passionate.

• Originalidade: Não copie nem imite letras, esquemas de rimas ou frases características de músicas publicadas.
• Segurança do conteúdo: Não inclua conteúdo relacionado a política, violência, pornografia, vulgaridade, terror ou drogas. Mantenha o conteúdo positivo e emocionalmente genuíno.
• Idioma: Apenas letras em chinês e inglês são compatíveis. Japonês, coreano e outros idiomas não são aceitos.

​

Gênero vocal (gender)

• female: Vocais femininos (padrão)
• male: Vocais masculinos

​

Recursos avançados

​

Saída em streaming

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" \
-H "X-DashScope-SSE: enable" \
-d '{
    "model": "fun-music-v1",
    "input": {
        "prompt": "High-energy electronic dance music, synthesizer effects, full of energy, suitable for workout scenes",
        "gender": "male"
    }
}'

​

Modelos e regiões compatíveis

​

China (Pequim)

• fun-music-v1
• fun-music-preview

​

Referência da API

​

Perguntas frequentes

​

Posso especificar instrumentos, andamento ou clima?

​

Qual modelo devo escolher?

​

Por quanto tempo as URLs de download de áudio são válidas?

​

Qual a diferença entre lyrics e prompt?

​

Quando devo usar o modo de streaming ou sem streaming?

​

Quais são os limites de parâmetros para os modos de streaming e sem streaming?