Skip to main content
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 segundos
string
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}):