| name | IMA Music Generator |
| version | 1.2.2 |
| category | file-generation |
| author | IMA Studio (imastudio.com) |
| keywords | imastudio, ai music, text_to_music, music generation, Suno, DouBao, GenBGM, GenSong, AI作曲, 音乐生成, BGM, 背景音乐, song generator, AI composer |
| argument-hint | [music description or style] |
| description | Generate voiceovers, narration, and spoken audio for videos, explainers, ads, and social content.
|
| requires | {"env":["IMA_API_KEY"],"runtime":["python3"],"packages":["requests"],"primaryCredential":"IMA_API_KEY","credentialNote":"IMA_API_KEY is required at runtime and sent only to api.imastudio.com."} |
| metadata | {"openclaw":{"primaryEnv":"IMA_API_KEY","homepage":"https://www.imaclaw.ai","requires":{"bins":"[Truncated]","env":"[Truncated]"}}} |
| persistence | {"readWrite":[],"retention":"No local preferences or logs are written by this skill script."} |
IMA Voice AI — Music Generator
For complete API documentation, security details, all parameters, and Python examples, read SKILL-DETAIL.md.
Model ID Reference (CRITICAL)
Use exact model_id from this table. Do NOT infer from friendly names.
| Friendly Name | model_id | Notes |
|---|
| Suno | sonic | ✅ Default, full songs with vocals |
| DouBao BGM | GenBGM | ⚠️ Instrumental only, background music |
| DouBao Song | GenSong | ⚠️ Songs with vocals |
User input aliases: BGM/背景音乐/纯音乐 → GenBGM · 歌曲/人声/Song → sonic or GenSong · 默认 → sonic
Music Generation Mode
| User intent | model_id | When to use |
|---|
| Background music, instrumental | GenBGM | "做一段BGM" / "纯音乐" / "背景音乐" |
| Song with vocals | sonic | "写首歌" / "带人声" / "歌曲" |
| Song (alternative) | GenSong | "豆包歌曲" / "GenSong" |
Model Selection Priority
- User preference (if explicitly stated) → highest priority
- Fallback default:
sonic (Suno)
| Task | Default Model | model_id | Notes |
|---|
| General music | Suno | sonic | Full songs, vocals |
| Instrumental/BGM | DouBao BGM | GenBGM | No vocals |
| Chinese songs | DouBao Song | GenSong | Alternative to Suno |
Script Usage
python3 {baseDir}/scripts/ima_voice_create.py \
--model-id sonic \
--prompt \
--output-json
python3 {baseDir}/scripts/ima_voice_create.py --list-models
python3 {baseDir}/scripts/ima_voice_create.py \
--model-id GenBGM \
--prompt \
--output-json
