Wiro - Text To Song
AI-generatedOverview
This node integrates with the Wiro API to generate music tracks based on textual descriptions and various musical parameters. It is useful for creating custom songs by specifying attributes like genre, instrument, mood, gender, timbre, duration, language, tempo, and more. Users can provide a free-text caption or detailed tags, song lyrics, and even a reference audio URL for style inspiration. The node sends these inputs to the Wiro API, waits for the music generation task to complete, and outputs the resulting audio URL and task status.
Use Case Examples
- Generating a 30-second instrumental jazz track with a happy mood and female vocals in English.
- Creating a song with specific lyrics and a reference audio style for a dance genre track.
- Producing a 2-minute music piece with AI-decided tempo and auto-detected language vocals.
Properties
| Name | Meaning |
|---|---|
| Caption | Free-text description of the desired music. If provided, it overrides the tags parameter. |
| Prompt | Song lyrics for vocal generation. Ignored if instrumental is true. |
| Reference Audio URL | URL of a song to use as style inspiration. |
| Genre | One or more selected music genres. |
| Instrument | One or more selected musical instruments. |
| Mood | One or more selected moods for the music. |
| Gender | One or more selected vocal genders. |
| Timbre | One or more selected timbres for the music. |
| Duration | Total duration of the generated audio in seconds. |
| Language | Language of the vocals, with a default of Arabic (ar). Auto-detection is available. |
| Bpm | Tempo of the music. 0 lets AI decide. |
| Inferencesteps | Number of inference steps for generation. |
| Guidancescale | Guidance scale for generation. |
| Init Lm | Enable AI-powered music planning for better results. |
| Instrumental | Whether the output is instrumental, ignoring lyrics if true. |
| Seed | Seed value for generation randomness. |
Output
JSON
taskid- Unique identifier of the music generation task.url- URL to access the generated music audio.status- Status of the music generation task (e.g., completed, failed).
Dependencies
- Wiro API with API key and secret for authentication
Troubleshooting
- If the node throws an error about missing task ID or socket access token, check the Wiro API response and credentials.
- Ensure all required parameters like genre, instrument, mood, gender, and timbre are provided to avoid API errors.
- Network issues or invalid API keys can cause HTTP request failures; verify connectivity and credentials.