Text To Music

Organization

NoizAI

text-to-music

Use this skill whenever the user wants to generate a song or music with vocals from a text description and/or lyrics, or cover an existing song in a new style. Triggers include: any mention of 'make a song', 'generate music', 'text to music', 'compose', 'write and sing a song', 'jingle', 'theme song', 'birthday song', 'song with lyrics', 'cover', 'cover version', 'remake this song as jazz', 'sing this song in another style', or requests like 'turn these lyrics into a song' or 'make a lo-fi track about coffee'. Also use when the user supplies lyrics and wants them sung, wants a song modeled on a reference track, wants new lyrics sung over an existing melody, or wants to extract lyrics from a song for covering. Do NOT use for short sound effects (use sound-fx), speech/voiceover (use tts), or pure instrumental tracks (not supported).

Overview

Publisher	NoizAI
Repository	`skills`
Skill name	`text-to-music`
Stars	526
Forks	80
Bundled files	1
Links	Skill source Repository

Markdown instructions
A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.
Works with any LLM
AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.
1 bundled files
Scripts, templates, and references the model can read while it works. Files are read-only and never executed.
Open source
Published by NoizAI on GitHub. Read the source before you install it.

Installation

Install the Text To Music AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

Open the app and go to Plugins → Skills.
Choose "Install from GitHub".
Paste the skill folder URL below and confirm.
https://github.com/NoizAI/skills/tree/main/skills/text-to-music
Enable the skill in any chat where you want it available.

Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills

git clone --depth 1 https://github.com/NoizAI/skills.git /tmp/skills
mkdir -p .claude/skills
cp -r /tmp/skills/skills/text-to-music .claude/skills/text-to-music

Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Text To Music in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Text To Music on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Text To Music is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

Loaded only when it is needed
The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.
Switch models mid-chat
Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

text-to-music

Two ways to make a song with vocals + accompaniment, saved as MP3. Every request produces two variants.

Generate — a new song from a music description plus lyrics.
Cover — re-sing an existing song in a new style, keeping its melody. Lyrics can be the original (auto-recognized) or new ones.

Triggers

make a song / generate music / text to music / compose
turn these lyrics into a song / sing this / jingle / theme song / birthday song
cover this song / make a jazz version / remake in another style
写歌 / 生成音乐 / 作曲 / 唱首歌 / 歌词谱曲 / 翻唱 / 改编 / 换个风格唱

Generate — new song from text

A request needs a prompt (the music description) and exactly one lyrics source:

bash
# Let the server write lyrics from a theme
python3 skills/text-to-music/scripts/t2m.py "upbeat indie pop, bright guitars, 120 BPM" \
  --lyrics-prompt "a song about summer road trips with friends"

# Use your own lyrics (inline or from a file)
python3 skills/text-to-music/scripts/t2m.py "mandopop ballad, piano and strings" \
  --lyrics $'[Verse]\n窗外的雨停了\n[Chorus]\n我还在等你' --vocal-gender Female --title "雨停了"
python3 skills/text-to-music/scripts/t2m.py "lo-fi hip hop, mellow, vinyl crackle" \
  --lyrics-file song.txt --duration 120 -o chill.mp3

# Model the vocal/style on a reference song (local file ≤20 MB or public URL)
python3 skills/text-to-music/scripts/t2m.py "dreamy synth-pop" --lyrics-file song.txt --ref-audio ./ref.mp3

Output: song_v1.mp3 and song_v2.mp3 (or <stem>_v1.mp3 / <stem>_v2.mp3 with -o). When lyrics were written by the server, they are also saved to <stem>_lyrics.txt.

Argument	Default	Description
`prompt`	required	Music description: genre, mood, instruments, tempo (≤1500 chars)
`--lyrics` / `-l`	—	Lyrics text; `[Verse]`, `[Chorus]`, `[Bridge]` markers help structure
`--lyrics-file`	—	UTF-8 `.txt` file with lyrics (≤64 KB)
`--lyrics-prompt`	—	Theme for server-side lyric writing
`--tags`	—	Style tags, comma-separated (≤50 chars)
`--negative-tags`	—	Styles to avoid
`--duration` / `-d`	auto	Target length hint: `60`, `120`, or `180` seconds. A hint, not a guarantee.
`--ref-audio`	—	Reference song, local path or public URL

--lyrics, --lyrics-file, and --lyrics-prompt are mutually exclusive; one is required.

Cover — re-sing an existing song

Needs the source song, lyrics, and a description of the new sound (--style and/or --prompt):

bash
# Same lyrics, new style: recognize lyrics from the original, then cover it
python3 skills/text-to-music/scripts/t2m.py cover original.mp3 \
  --style "jazz, smoky female vocal" --recognize-lyrics -o jazz_cover.mp3

# New lyrics over the original melody, looser arrangement
python3 skills/text-to-music/scripts/t2m.py cover https://example.com/song.mp3 \
  --prompt "acoustic folk, fingerpicked guitar, intimate" --lyrics-file new_lyrics.txt \
  --adherence main_melody --vocal-gender Male

# Recognize lyrics only (to review or edit before covering)
python3 skills/text-to-music/scripts/t2m.py lyrics original.mp3 -o lyrics.txt

Recommended flow when the user wants to tweak lyrics: run lyrics → edit the file → cover --lyrics-file.

Argument	Default	Description
`source`	required	Original song: local file (≤100 MB; mp3/wav/m4a/aac/flac/ogg) or public URL
`--style` / `-s`	—	Short style tags, e.g. `"rock, male vocal"` (≤50 chars)
`--prompt` / `-p`	—	Longer description of the cover's sound (≤1500 chars)
`--adherence`	`high`	`high` = follow the original arrangement closely; `main_melody` = keep only the main melody, more freedom
`--lyrics` / `-l`	—	Lyrics to sing
`--lyrics-file`	—	UTF-8 `.txt` file with lyrics (≤64 KB)
`--recognize-lyrics`	off	Transcribe the source's lyrics first and use them
`--output` / `-o`	`cover.mp3`	Output path; variants get `_v1` / `_v2` suffixes

At least one of --style / --prompt is required; exactly one lyrics source is required.

Shared Arguments

Argument	Default	Description
`--title`	—	Song title (≤80 chars)
`--vocal-gender`	—	`Male` or `Female`
`--vocal-timbre`	—	Free-form voice description, e.g. `"husky warm alto"` (≤50 chars)
`--output` / `-o`	`song.mp3` (`cover.mp3` for covers)	Output path; variants get `_v1` / `_v2` suffixes
`--no-wait`	off	Submit, print the job ID(s), then exit
`--poll-interval`	`10`	Seconds between status checks
`--timeout`	`1800`	Max seconds to wait (the job keeps running server-side)
`--api-key`	from env/config	Noiz API key (overrides stored key)

Resuming / Checking Jobs

Generation prints two gen_product_ids; a cover prints one task_id. If the wait times out or you used --no-wait, resume with:

bash
python3 skills/text-to-music/scripts/t2m.py status <id_v1> <id_v2> -o song.mp3
python3 skills/text-to-music/scripts/t2m.py status --cover <task_id> -o cover.mp3
python3 skills/text-to-music/scripts/t2m.py status --cover <task_id> --no-wait   # just print status

Status goes submitted → running → succeeded / failed. Covers also report a stage (analysis runs before singing, so covers take longer). Download URLs expire after ~24h; re-run status for fresh ones.

Writing Good Prompts

Prompt / style = the sound: genre + mood + instrumentation + tempo. "cinematic orchestral pop, soaring strings, 90 BPM, hopeful".
Lyrics: keep sections short and label them. Chinese, English, and mixed lyrics all work.
Short songs: for jingles or greetings, pass -d 60 and write only a verse + chorus.
Covers: pick high to keep the cover recognizable; pick main_melody for a bigger genre change.
Not satisfied? Run again — each run gives two fresh variants.

Cost

Songs and covers are billed once per job (not per variant): ceil(longest variant seconds) × 15 credits, charged after both variants succeed. A 2-minute song costs about 1,800 credits. If subscription credits don't cover the whole job, it is billed as pay-as-you-go at $0.00015/s. The script prints the charged amount on completion.
Lyrics recognition (lyrics / --recognize-lyrics): 100 credits (or $0.001 pay-as-you-go), charged only when vocals are detected.

Rate limits: 5 submissions per minute per key per endpoint; status polling 60 per minute.

Limitations

Pure instrumental music is not supported — lyrics are always required.
--duration is only a hint; actual length may differ. Covers follow the source's length.
Prompts or lyrics containing sensitive content are rejected (code=400).

Configuration

bash
python3 skills/text-to-music/scripts/t2m.py config --set-api-key YOUR_KEY
# or
export NOIZ_API_KEY=YOUR_KEY

Get your API key at developers.noiz.ai.

Requirements

Python 3.6+
requests package: uv pip install requests
Noiz API key from developers.noiz.ai

Security & Data Disclosure

API key: Stored in ~/.config/noiz/api_key (permissions 0600) or via NOIZ_API_KEY env variable.
Network: Prompts, lyrics, and any reference/source audio (file upload or URL) are sent to https://noiz.ai/v1/text-to-music and https://noiz.ai/v1/text-to-music/cover*; job status is polled from the same endpoints. No other data is transmitted.
Output: Generated MP3s (and lyrics text files) are downloaded from signed Noiz storage URLs and saved to the output path. No other files are modified.

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

scripts/t2m.py21 KB

Frequently asked questions

What does the Text To Music AI skill do?

Why use Text To Music on TypingMind?

Because you install it once and use it with any model. Text To Music is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Text To Music in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/NoizAI/skills/tree/main/skills/text-to-music. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Text To Music?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Text To Music?

As many as you like. As long as a model supports skills, you can use Text To Music with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Text To Music AI skill free?

It is published on GitHub by NoizAI. Check the repository for licensing terms. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Audiocraft Audio Generation

NousResearch

OrganizationPopular

AudioCraft: MusicGen text-to-music, AudioGen text-to-sound.

Brag Slim

Launch video from a project or URL, upstream-maintained.

Brag

Project launch video via Hyperframes, upstream-maintained.

Comfyui

Generate images, video, and audio via diffusion workflows.

Overview

Installation

Install in TypingMind

Install in another agent

Use it in TypingMind

Works with any AI model

Skill instructions

text-to-music

Triggers

Generate — new song from text

Cover — re-sing an existing song

Shared Arguments

Resuming / Checking Jobs

Writing Good Prompts

Cost

Limitations

Configuration

Requirements

Security & Data Disclosure

Bundled files

Frequently asked questions

Related AI Skills

Set up your own AI workspace now