Senseaudio Voice Meme Maker

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