# Senseaudio Tts Quick

> Zero-config text-to-speech — give text, get an mp3 file. Handles natural-language voice selection ("用女声", "撒娇语气", "生气一点") and auto-inserts pacing breaks for long text. Use this whenever a user wants to quickly synthesize speech without configuring API details, or says things like "帮我把这段话合成语音", "用温柔御姐的声音读一下", "生成一段生气语气的音频".

- Skill: `dvcrn/senseaudio-tts-quick` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dvcrn/senseaudio-tts-quick`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/senseaudio-tts-quick/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/senseaudio-tts-quick

---


# SenseAudio TTS Quick

Zero-config speech synthesis. User gives text, you produce an mp3 file — no API knowledge required.

## Voice Selection

Default voice: `male_0004_a` (儒雅道长, neutral).

Map natural-language requests to voice IDs before calling the API:

| User says | voice_id |
|-----------|----------|
| 女声 / 女生 / 女的 | `female_0006_a` (温柔御姐) |
| 温柔御姐 | `female_0006_a` |
| 嗲嗲 / 台妹 | `female_0033_a` |
| 撒娇 | `female_0033_c` |
| 低落 / 难过 / 悲伤 | `female_0033_d` |
| 委屈 | `female_0033_e` |
| 生气 / 愤怒 | `female_0033_f` |
| 开心 / 高兴 / 活泼 | `female_0033_b` |
| 傲娇 | `female_0027_f` |
| 病娇 | `female_0027_c` |
| 妩媚 / 性感 | `female_0027_e` |
| 男声 / 男生 | `male_0004_a` |
| 沙哑 / 深情 | `male_0018_a` |
| 撒娇青年 | `male_0023_a` |
| 乐观 / 少年 | `male_0026_a` |
| 儿童 / 小孩 / 萌娃 | `child_0001_b` |

If the user names a voice not in this table, use `male_0004_a` and note the fallback.

## Long Text Pacing

For text longer than 100 characters, insert `<break time="300"/>` after each `。` `！` `？` to improve natural rhythm:

```
原文：今天天气很好。我们出去走走吧。
处理后：今天天气很好。<break time="300"/>我们出去走走吧。<break time="300"/>
```

Do not insert breaks inside quoted speech or after mid-sentence punctuation like `，`.

## API Call

```bash
curl -s -X POST https://api.senseaudio.cn/v1/t2a_v2 \
  -H "Authorization: Bearer $SENSEAUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "SenseAudio-TTS-1.0",
    "text": "<TEXT>",
    "stream": false,
    "voice_setting": {
      "voice_id": "<VOICE_ID>"
    },
    "audio_setting": {
      "format": "mp3"
    }
  }' -o response.json

# Decode hex audio to mp3
jq -r '.data.audio' response.json | xxd -r -p > output.mp3
```

Check `base_resp.status_code == 0` before decoding. On error, show `base_resp.status_msg`.

## Output

After generating the file:
1. Save as a descriptive filename, e.g. `speech_<timestamp>.mp3` or based on the first few words of the text.
2. Report:
   - File path
   - Audio duration: `jq '.extra_info.audio_length' response.json` (ms → seconds)
   - Character count: `jq '.extra_info.usage_characters' response.json`
   - Voice used

Example output:
```
生成完成：speech_20240315.mp3
音色：温柔御姐 (female_0006_a)
时长：4.2 秒
字数：38 字
```

## Error Handling

| status_code | Likely cause | Action |
|-------------|--------------|--------|
| 401 | Invalid API key | Ask user to check SENSEAUDIO_API_KEY |
| 400 | Text too long (>10000 chars) | Split text and generate multiple files |
| 429 | Rate limit | Wait a moment and retry once |