audio_codebuddy/hardware-integration/tts-sdk

TTS 硬件 SDK

目标

封装出给硬件厂商用的 TTS SDK，让他们 5 分钟接入我们的 TTS 能力。

SDK 设计

接口设计原则

• 简单：5 行代码接入
• 可靠：自动重试、错误处理
• 高效：流式响应、连接复用
• 多平台：Python / Node.js / C++

核心接口

# Python 示例
from tts_sdk import TTSClient

client = TTSClient(
    api_key='your-key',
    base_url='https://api.your-domain.com',
)

# 短文本同步合成
audio = client.synthesize(
    text='你好世界',
    voice_id='female-shaonv',
)

# 长文本异步合成
task_id = client.async_synthesize(
    text='很长的文本...',
    voice_id='male-qn-jingying',
)

# 查询任务
result = client.get_task(task_id)

# 自然语言指令
audio = client.instruct(
    text='从前有一只小兔子',
    instruction='用磁性男声，悲伤语气',
)

SDK 实现

Python SDK

# tts_sdk/client.py
class TTSClient:
    def __init__(self, api_key, base_url):
        self.api_key = api_key
        self.base_url = base_url

    def synthesize(self, text, voice_id=None, **kwargs):
        # POST /v1/tts/synthesize
        ...

    def async_synthesize(self, text, **kwargs):
        # POST /v1/tts/async-synthesize
        ...

    def get_task(self, task_id):
        # GET /v1/tts/tasks/{task_id}
        ...

    def instruct(self, text, instruction):
        # POST /v1/tts/instruct
        ...

Node.js SDK

类似结构，TypeScript 实现。

C++ SDK

给 ESP32 / 嵌入式使用，需要封装 HTTP 客户端。

给硬件厂商的卖点

1. 5 分钟接入——一行命令安装 SDK，3 行代码调用
2. 完整文档——快速入门 + API 参考 + 示例代码
3. 技术支持——响应时间 < 24 小时
4. 稳定性——自动重试、断点续传

商业模式

模式	单价	客户类型
免费试用	10000 字符/月	所有客户
API 调用	¥0.01/次	中小客户
SDK 年费	¥1 万-10 万/年	中小硬件厂商
设备授权	¥10-50/台	大批量客户

下一步

等 pc-simulator/ 跑通后，抽取通用 SDK 模块。