Flow Music
Generar música
Flow Music genera música a partir de texto. Admite prompts de estilo / letras / BPM / control de duración; cada solicitud genera una pieza musical
POST
Autenticación
Todas las interfaces requieren autenticación mediante Bearer TokenObtener la API Key:Visite la página de gestión de API Keys para obtener su API KeyAl usarla, añádala en el encabezado de la solicitud:
Parámetros de solicitud
Nombre del modelo, debe ser siempre
"flowmusic" (no distingue mayúsculas de minúsculas)Prompt que describe el estilo musical o el sonidoEjemplo:
"upbeat pop music with piano"sound_prompt y lyrics no pueden estar ambos vacíos (debe enviarse al menos uno). Cada solicitud genera solo una pieza musical.Texto de la letra; puede obtenerse primero con la interfaz de generar letras y luego rellenarse aquíEjemplo:
"[Verse 1]\nPor larga que sea la noche, amanecerá\n..."Título de la música generada
BPM (pulsaciones por minuto), debe ser ≥ 1Ejemplo:
"120"Duración de la generación (segundos)Rango admitido:
1 ~ 240 segundosSemilla aleatoria, utilizada para reproducir resultados
Enviar el mismo valor de seed con la misma solicitud generará resultados similares, pero no se garantiza que sean completamente idénticos.
Respuesta
Código de estado de la respuesta, 200 en caso de éxito
Array de datos devueltos
Casos de uso
Escenario 1: Generación solo con prompt de estilo
Escenario 2: Letra + estilo para crear la canción
Consultar el resultado de la tareaLa generación de música es una tarea asíncrona; tras enviarla se devuelve un
task_id. Utilice la interfaz Obtener estado de la tarea para consultar el progreso y el resultado de la generación.Ejemplo de resultado de tarea completada
Ejemplo de respuesta de consulta (GET /v1/music/tasks/{task_id}):