Package Information
Documentation
n8n-nodes-freemusic
An n8n community node package for the FreeMusic AI Music API. Generate songs, extend or remix library audio, replace a song section, and read asynchronous task results from n8n workflows.
n8n is a workflow automation platform.
Operations
- Generate Music — create one or more songs from a prompt and optional style settings.
- Extend Song — continue a library song or an existing uploaded-audio reference from a selected position.
- Cover / Remix Song — create a new style from a library song or existing uploaded-audio reference.
- Replace Section — replace a time range using full lyrics and a new style.
- Get Task Status — read status and song metadata, including audio and download URLs when available.
Creation operations are asynchronous. They return a unique_id while the task is pending. Add an n8n Wait node, then call Get Task Status with the returned ID. A task is settled when the API returns is_complete: true; media URLs may be empty until transfer to FreeMusic storage is complete. The status operation emits one n8n item per task.
Extend and Cover / Remix accept either a FreeMusic library song ID or an upload ID. The current public API reference does not define an audio-upload operation, so upload IDs must be obtained through another supported FreeMusic workflow.
Installation
Install the package through the community-node installation flow for your n8n instance, using the npm package name n8n-nodes-freemusic. For n8n Cloud discovery, the package must first be reviewed and verified by n8n.
Credentials
Create a FreeMusic API key in the FreeMusic developer dashboard. In n8n, create a FreeMusic API credential and paste the key into the password field. Requests use the Authorization: Bearer header. The credential is stored by n8n; do not add API keys to workflow fields or exported examples.
The API has a separate prepaid balance from FreeMusic website plans and MCP credits. Calls can consume API balance. Review the current API documentation and pricing before running workflows.
Usage
- Add the FreeMusic node to a workflow and select a credential.
- Choose a creation operation and provide its required values.
- Connect a Wait node after a creation operation.
- Add another FreeMusic node using Get Task Status and map the prior
unique_idinto Task IDs. Repeat the Wait/status step untilis_completeis true. - Use
songs[].audio_url,songs[].download_url,songs[].lyrics, and other returned song fields in later workflow steps.
For multiple task IDs, enter a comma-separated list of 1 to 20 numeric IDs.
An importable example workflow is available at examples/generate-and-check-task.json. Select your saved FreeMusic API credential in both FreeMusic nodes after importing. The example checks the task once after two minutes; repeat the Wait and status check if is_complete is still false.
Compatibility
This package uses the n8n Node API v1 and has no external runtime dependencies. Verify it against your target n8n version before publishing.
Development
Install development dependencies and use the included scripts:
npm install
npm run build
npm run lint
npm run dev
Resources
- FreeMusic API documentation
- FreeMusic API OpenAPI reference
- FreeMusic MCP page
- n8n community-node documentation
- n8n node development documentation
License
MIT. See LICENSE.