Flow Music
Gerar Música
Flow Music gera música a partir de texto. Suporta prompts de estilo / letras / BPM / controle de duração, gerando uma música por requisição
POST
Autenticação
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
Nome do modelo, sempre passe
"flowmusic" (não diferencia maiúsculas de minúsculas)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.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..."Título da música gerada
BPM (batidas por minuto), deve ser ≥ 1Exemplo:
"120"Duração da geração (segundos)Faixa suportada:
1 ~ 240 segundosSemente 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
Código de status da resposta, 200 em caso de sucesso
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}):