Skip to content

0xsline/OpenChatCut / src/agent/skills/voice

Text-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.

FileKindSize
SKILL.mdskill md17.5 KB
references/minimax-tts.mdmarkdown2.8 KB
references/video-sync.mdmarkdown7.8 KB
references/voices.mdmarkdown12.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.
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall