0xsline/OpenChatCut / src/agent/skills/music
music
VerifiedMusic generation via Mureka, MiniMax, Atlas Cloud, and Sonilo. Use for instrumentals, songs, soundtracks, track/stem generation, covers, or video-conditioned scoring of the finished cut through `submit_music`.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.3 KB |
| references/atlas.md | markdown | 866 B |
| references/minimax.md | markdown | 3.7 KB |
| references/mureka.md | markdown | 1.9 KB |
| references/sonilo.md | markdown | 1.5 KB |
references/minimax.md
View on GitHub# MiniMax Music (`provider: "minimax"`)
Read this before `submit_music({ provider: "minimax", … })`.
Grounded in OpenChatCut’s music adapter (`server/plugins/music.ts` → MiniMax
`/v1/music_generation`). Official fields: `prompt`, `lyrics`, `is_instrumental`,
`lyrics_optimizer`, `audio_setting`, `output_format`, and cover refs
(`audio_base64` / `cover_feature_id`).
Server MiniMax model comes from Settings `MINIMAX_MUSIC_MODEL`
(`music-3.0` / `music-2.6` / free / **cover** variants).
## Capabilities (as wired)
| Dimension | Value |
| --- | --- |
| Provider arg | `minimax` |
| Prompt | t2m ≤ **2000**; cover style **10–300** |
| Lyrics | t2m ≤ **3500**; cover optional **10–1000** |
| Instrumental | `isInstrumental` or omit lyrics (t2m only) |
| Lyrics optimizer | `lyricsOptimizer: true` + empty lyrics (t2m only) |
| Cover reference | exactly one of `referenceAssetId` → raw `audio_base64`, or `coverFeatureId` |
| Audio setting | `sampleRate` / `bitrate` / `audioFormat` |
| Placement | **Media pool only** |
## Modes
| Intent | Args | Settings model |
| --- | --- | --- |
| BGM / instrumental | `mode:"t2m"`, `isInstrumental:true` | music-2.6 / 3.0 / free |
| Song with lyrics | `mode:"t2m"`, `lyrics: "…"` | music-2.6 / 3.0 / free |
| Auto lyrics | `mode:"t2m"`, `lyricsOptimizer: true` | music-2.6 / 3.0 / free |
| **Cover / 翻唱** | `mode:"cover"` + source/feature id + style prompt | **music-cover** or **music-cover-free** |
## Tool shape
```ts
// Instrumental BGM
submit_music({
provider: "minimax",
mode: "cover",
prompt: "Cinematic strings, hopeful, soft under dialogue",
name: "BGM · strings",
});
// Vocals + lyrics
submit_music({
provider: "minimax",
prompt: "Indie folk, acoustic guitar, intimate",
lyrics: "[Verse]\\n...\\n[Chorus]\\n...",
name: "Song · folk",
});
// Auto lyrics from prompt
submit_music({
provider: "minimax",
prompt: "Rainy night pop, melancholic chorus about leaving home",
lyricsOptimizer: true,
name: "Song · auto lyrics",
});
// Music-cover (Settings model must be music-cover*)
submit_music({
provider: "minimax",
prompt: "Warm acoustic cover, intimate coffee-shop vibe",
referenceAssetId: "audioAssetId",
name: "Cover · acoustic",
});
// Higher-quality WAV instrumental
submit_music({
provider: "minimax",
prompt: "Orchestral trailer hit",
isInstrumental: true,
audioFormat: "wav",
sampleRate: 44100,
bitrate: 256000,
name: "Hit · wav",
});
```
## Cover rules
1. Set **MINIMAX_MUSIC_MODEL** to `music-cover` or `music-cover-free` in Settings.
2. Pass exactly one of **`referenceAssetId`** (project audio) or **`coverFeatureId`** (preprocess result valid for 24 hours).
3. **Prompt** describes the *target style*, not the full song (10–300 chars).
4. With `referenceAssetId`, lyrics are optional. With `coverFeatureId`, lyrics are required (10–1000 chars).
5. Do not combine cover with `isInstrumental` or `lyricsOptimizer`.
If you pass `referenceAssetId` while the model is still `music-2.6`, the server errors until the cover model is selected.
## Lyrics tips
- Section tags: `[Intro]`, `[Verse]`, `[Pre Chorus]`, `[Chorus]`, `[Bridge]`, `[Outro]`, …
- Lines separated by `\n`
- For speech-under BGM, stay instrumental
## Errors
| Message | Fix |
| --- | --- |
| `MiniMax is not configured` | Set `MINIMAX_API_KEY` |
| `music-cover requires MINIMAX_MUSIC_MODEL…` | Switch model to music-cover* |
| `music-cover requires exactly one…` | Pass one source asset or feature ID |
| `music-cover prompt must be 10–300 characters` | Expand or shorten style prompt |
| `minimax vocals require lyrics…` | lyrics / lyricsOptimizer / isInstrumental |
| `sampleRate must be…` | Use allowed enums |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |