IMA Studio Music Generation

# IMA Voice AI Creation

## Scope & Dependencies (Declared for Transparency)

- **Credentials:** This skill requires an **IMA API key** at runtime (`IMA_API_KEY` or `--api-key`). The key is sent only to **api.imastudio.com**. Obtain keys at https://imastudio.com. Declared in registry as required.
- **Optional dependency:** When **ima-knowledge-ai** is installed, this skill may instruct the agent to read that skill's reference files (`~/.openclaw/skills/ima-knowledge-ai/references/*`) for workflow and model-selection guidance. **This skill is self-contained** — it works fully without ima-knowledge-ai. Reading another skill's files is optional and only for complex or multi-step tasks; users who do not have or trust ima-knowledge-ai can ignore those steps and use this skill's built-in defaults and **📥 User Input Parsing** tables.
- **Local paths:** This skill reads/writes `~/.openclaw/memory/ima_prefs.json` (preferences) and `~/.openclaw/logs/ima_skills/` (logs; auto-deleted after 7 days). User can delete these anytime.

---

## Optional: Read Knowledge Base (When ima-knowledge-ai Is Installed)

**If ima-knowledge-ai is not installed:** Skip this section. Use only this SKILL's default models and the **📥 User Input Parsing** tables for model_id and parameters.

**When ima-knowledge-ai is installed and the task is complex**, you may optionally read its reference files for better workflow and model choice:

1. **Workflow complexity** — Read `ima-knowledge-ai/references/workflow-design.md` if:
   - User mentions: "MV"、"配乐"、"完整作品"、"多步骤"、"soundtrack"
   - Task involves: video + music coordination, multi-track production, integrated workflows
   - Complex requirements that need task decomposition

2. **Model selection** — Read `ima-knowledge-ai/references/model-selection.md` if:
   - Unsure which model to use (Suno vs DouBao BGM vs DouBao Song)
   - Need cost/quality trade-off guidance
   - User specifies budget or quality requirements

**Why this is optional:*...