0xsline/OpenChatCut / src/agent/skills/voice
voice
VerifiedText-to-Speech (TTS), voiceover, narration placement/sync, and custom sound effects (SFX) generator. Use when the user wants generated speech from text, wants to add/replace/align narration or voiceover for an existing video/timeline, wants to keep existing voiceover synced after visual retiming edits, needs voice audition/selection, or explicitly wants a newly generated/custom sound effect that is not available in the Sound Effects library.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 17.5 KB |
| references/minimax-tts.md | markdown | 2.8 KB |
| references/video-sync.md | markdown | 7.8 KB |
| references/voices.md | markdown | 12.0 KB |
references/minimax-tts.md
View on GitHub# MiniMax TTS (`provider: "minimax"`)
Read this before `submit_voice({ provider: "minimax", … })`.
Grounded in OpenChatCut’s voice tool + server adapter (`server/plugins/voice.ts` → MiniMax `t2a_v2`). Preset table: [voices.md](voices.md) § MiniMax.
## Capabilities (as wired)
| Dimension | Value |
| --- | --- |
| Provider arg | `minimax` |
| Text | Required |
| `voiceId` | System/raw/cloned MiniMax id; defaults to `female-yujie`. Must be empty when using `timbreWeights` |
| `speed` | Optional, **0.5–2** (default 1) → `voice_setting.speed` |
| `pitch` | Optional, **-12–12** (default 0) → native `voice_setting.pitch` |
| `volume` | Optional, **>0–10** (default 1) → `voice_setting.vol` |
| `emotion` | Optional: happy, sad, angry, fearful, disgusted, surprised, calm, fluent, whisper |
| Audio settings | sampleRate; mp3/pcm/flac/wav/pcmu/opus; channel. `bitrate` is MP3-only |
| Streaming | `stream`; `excludeAggregatedAudio`; `forceCbr` only with streamed MP3. OpenChatCut still persists one local asset |
| Language/text | languageBoost, textNormalization, latexRead, pronunciation tone entries |
| Voice composition | timbreWeights (1–4 voices, weights 1–100), voiceModify pitch/intensity/timbre/effect |
| Subtitle | `subtitleEnable` + sentence/word/word_streaming; downloaded as a durable JSON sidecar |
| Placement | **Media pool only** — does not place on the timeline |
## When to use
- MiniMax key is configured and the user wants MiniMax TTS.
- User named MiniMax speech (as distinct from Doubao / ElevenLabs).
- Only MiniMax voice capability is on.
## When not to use
- Need ElevenLabs multilingual catalog → `elevenlabs`
- User has not picked a voice → offer candidates from [voices.md](voices.md) first
## Tool shape
```ts
submit_voice({
provider: "minimax",
text: "……",
voiceId: "female-yujie",
speed: 1,
pitch: 0,
volume: 1,
emotion: "calm", // optional
sampleRate: 44100,
audioFormat: "wav",
languageBoost: "Chinese",
subtitleEnable: true,
subtitleType: "word",
pronunciations: ["OpenChatCut/(open chat cut)"],
voiceModify: { intensity: 10, effect: "spacious_echo" },
name: "VO · intro",
});
```
Then place with `edit_item` only if the user wants it on a track.
## Rules
- Never mix MiniMax `voiceId` values with `provider: "doubao"` or `"elevenlabs"`.
- Confirm a concrete `voiceId` before submit, except for a deliberate `timbreWeights` mix (empty `voiceId`).
- `voiceModify` supports non-streaming mp3/wav/flac or streaming mp3 only.
- `word_streaming`, `excludeAggregatedAudio`, and streamed `forceCbr` require `stream: true`.
- `textNormalization` and `latexRead` map inside official `voice_setting`; `latexRead` forces Chinese language boost.
- Check capabilities: if MiniMax voice is off, say which key is missing.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |