Flow Music
Gerar Música com Lyria 3.5
Use o Lyria 3.5 para gerar música a partir de texto com o Flow Music, incluindo prompts de estilo, letras, BPM e controle de duração
POST
Autenticação
string
obrigatório
Todos os endpoints exigem autenticação via Bearer TokenObtenha sua API Key:Acesse a página de gerenciamento de API Keys para obter sua API KeyAo usar, adicione ao cabeçalho da requisição:
Parâmetros da Requisição
string
obrigatório
Nome do modelo, sempre passe
"flowmusic" (não diferencia maiúsculas de minúsculas)string
obrigatório
Versão do modelo, sempre passe
"lyria-3.5"O Lyria 3.5 ainda usa
flowmusic como nome do modelo. Não altere model para lyria-3.5 nem flowmusic-lyria-3.5.string
Prompt de descrição do estilo musical ou do somExemplo:
"upbeat pop music with piano"sound_prompt e lyrics não podem estar ambos vazios (informe pelo menos um). Cada requisição gera apenas uma música.string
Texto da letra; você pode obtê-lo primeiro com o endpoint Gerar Letras e reutilizá-lo aquiExemplo:
"[Verse 1]\nPor mais longa que seja a noite, o dia sempre chega\n..."string
Título da música gerada
string
BPM (batidas por minuto), deve ser ≥ 1Exemplo:
"120"integer
Duração da geração (segundos)Faixa suportada:
1 ~ 240 segundosstring
Semente aleatória, usada para reproduzir resultados
Enviar o mesmo valor de seed na mesma requisição gera resultados semelhantes, mas não garante resultados totalmente idênticos.
Resposta
integer
Código de status da resposta, 200 em caso de sucesso
array
Array de dados retornados
Casos de Uso
Cenário 1: Geração apenas com prompt de estilo
Cenário 2: Letra + estilo para compor a música
Consultar o Resultado da TarefaA geração de música é uma tarefa assíncrona; após o envio, um
task_id é retornado. Use o endpoint Obter Status da Tarefa para consultar o progresso e o resultado da geração.Exemplo de Resultado de Tarefa Concluída
Exemplo de resposta da consulta (GET /v1/music/tasks/{task_id}):