SenseAudio Voice Meme Maker

Create hilarious voice memes with preset templates and voice effects powered by the SenseAudio TTS API.

简介（中文）

SenseAudio Voice Meme Maker 是一个基于 SenseAudio TTS 接口的语音梗图生成工具。通过调节语速（speed）、音调（pitch）和音量（vol）参数，可以快速生成各种搞笑风格的语音片段，适用于社交媒体、短视频配音、表情包制作等场景。

内置模板：

使用前提： 在 SenseAudio 控制台 创建 API Key，并设置环境变量 SENSEAUDIO_API_KEY。

Prerequisites

pip install requests

Workflow

1. Choose a template or define custom speed / pitch / vol values
2. Provide the meme text
3. Call the TTS API — response returns audio as a hex string
4. Decode hex and save to an MP3 file

Implementation

import os
import requests

API_KEY = os.environ["SENSEAUDIO_API_KEY"]

# Preset meme templates: speed [0.5-2.0], pitch [-12-12], vol [0.01-10]
TEMPLATES = {
    "dramatic_narrator": {"speed": 0.75, "pitch": -3,  "vol": 1.5},
    "shocked_reaction":  {"speed": 1.6,  "pitch": 6,   "vol": 2.0},
    "robot_voice":       {"speed": 1.0,  "pitch": -8,  "vol": 1.0},
    "speed_ramble":      {"speed": 2.0,  "pitch": 2,   "vol": 1.2},
    "deep_voice":        {"speed": 0.8,  "pitch": -10, "vol": 1.5},
}

def make_voice_meme(text, template="dramatic_narrator", voice_id="male_0004_a", output="meme.mp3"):
    settings = TEMPLATES[template]
    payload = {
        "model": "SenseAudio-TTS-1.0",
        "text": text,
        "voice_setting": {
            "voice_id": voice_id,
            "speed": settings["speed"],
            "pitch": settings["pitch"],
            "vol":   settings["vol"],
        },
        "audio_setting": {"format": "mp3", "sample_rate": 32000},
    }
    resp = requests.post(
        "https://api.senseaudio.cn/v1/t2a_v2",
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json",
        },
        json=payload,
    )
    resp.raise_for_status()
    audio_hex = resp.json()["data"]["audio"]
    with open(output, "wb") as f:
        f.write(bytes.fromhex(audio_hex))
    return output

Usage Examples

# Dramatic narrator meme
make_voice_meme("This is fine.", template="dramatic_narrator", output="fine.mp3")

# Shocked reaction
make_voice_meme("Wait, WHAT?!", template="shocked_reaction", output="shocked.mp3")

# Custom effect (no template)
def make_custom_meme(text, speed=1.0, pitch=0, vol=1.0, voice_id="male_0004_a", output="custom.mp3"):
    payload = {
        "model": "SenseAudio-TTS-1.0",
        "text": text,
        "voice_setting": {"voice_id": voice_id, "speed": speed, "pitch": pitch, "vol": vol},
        "audio_setting": {"format": "mp3", "sample_rate": 32000},
    }
    resp = requests.post(
        "https://api.senseaudio.cn/v1/t2a_v2",
        headers={"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"},
        json=payload,
    )
    resp.raise_for_status()
    with open(output, "wb") as f:
        f.write(bytes.fromhex(resp.json()["data"]["audio"]))
    return output

Tips

• Keep meme text short (under 50 chars) for punchy delivery
• Combine <break time=300> pauses in text for comedic timing, e.g. "Wait... <break time=500> WHAT?!"
• Browse available voice_id values at SenseAudio Voice List
• pitch range is -12 to 12; values beyond ±8 produce the most exaggerated effects

Reference

• SenseAudio TTS API
• SenseAudio Voice List