# TTS 硬件 SDK

## 目标

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

## SDK 设计

### 接口设计原则

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

### 核心接口

```python
# 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

```python
# 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 模块。