- 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
- >
- requires
- env
- runtime
- packages
- 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
- env
- 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
# Generate music (default: sonic/Suno)
python3 {baseDir}/scripts/ima_voice_create.py \
--model-id sonic \
--prompt "upbeat lo-fi hip hop, 90 BPM, no vocals" \
--output-json
# List available models
python3 {baseDir}/scripts/ima_voice_create.py --list-models
# Generate BGM
python3 {baseDir}/scripts/ima_voice_create.py \
--model-id GenBGM \
--prompt "calm piano background music for meditation" \
--output-jsonSending Results to User
# ✅ CORRECT: Use remote URL directly for inline audio display
message(action="send", media=audio_url, caption="✅ 音乐生成成功！\
• 模型：[Name]\
• 耗时：[X]s\
• 积分：[N pts]\
\
🔗 原始链接：[url]")
# ❌ WRONG: Never download to local fileUX Protocol (Brief)
- Pre-generation: "🎵 开始生成音乐… 模型：[Name]，预计[X~Y]秒，消耗[N]积分"
- Progress: Every 30-60s: "⏳ 正在生成中… [P]%" (cap at 95%)
- Success: Send audio via
media=audio_url+ include link in caption - Failure: Natural language error + suggest alternative models. See SKILL-DETAIL.md for error translation.
Never say to users: script names, API endpoints, attribute_id, technical parameter names. Only: model name · time · credits · result · status.
Environment
Base URL: https://api.imastudio.com Headers: Authorization: Bearer $IMA_API_KEY · x-app-source: ima_skills · x_app_language: en
Core Flow
GET /open/v1/product/list?app=ima&platform=web&category=text_to_music→ getattribute_id,credit,model_versionPOST /open/v1/tasks/create→ gettask_idPOST /open/v1/tasks/detail→ poll every 5s untilresource_status==1
MANDATORY: Always query product list first. attribute_id is required.
Defaults and Timeouts
- Task type:
text_to_music(fixed) - Poll interval: 5 seconds
- Max poll wait: 8 minutes
- Default model:
sonic(if--model-idomitted)
Estimated Generation Time
| Model | Estimated Time | Poll Every |
|---|---|---|
| Suno (sonic) | 60~180s | 5s |
| DouBao BGM (GenBGM) | 30~90s | 5s |
| DouBao Song (GenSong) | 60~120s | 5s |