82 lines
1.4 KiB
Markdown
82 lines
1.4 KiB
Markdown
# Text to BlendShapes API
|
|
|
|
将文字转换为52个形态键的API服务
|
|
|
|
## 功能
|
|
|
|
1. 文字 → 音频 (使用 gTTS)
|
|
2. 音频 → CSV (使用 Audio2Face)
|
|
3. CSV → 52个形态键数据
|
|
|
|
## 安装
|
|
|
|
```bash
|
|
cd a2f_api
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
## 使用
|
|
|
|
```bash
|
|
python api.py
|
|
```
|
|
|
|
服务将在 `http://localhost:5001` 启动
|
|
|
|
## API 接口
|
|
|
|
### POST /text-to-blendshapes
|
|
|
|
**请求:**
|
|
```json
|
|
{
|
|
"text": "你好世界",
|
|
"language": "zh-CN"
|
|
}
|
|
```
|
|
|
|
**响应:**
|
|
```json
|
|
{
|
|
"success": true,
|
|
"frames": [
|
|
{
|
|
"timeCode": 0.0,
|
|
"blendShapes": {
|
|
"EyeBlinkLeft": 0.0,
|
|
"EyeLookDownLeft": 0.0,
|
|
...
|
|
"TongueOut": 0.0
|
|
}
|
|
}
|
|
],
|
|
"audio_path": "...",
|
|
"csv_path": "..."
|
|
}
|
|
```
|
|
|
|
### POST /text-to-blendshapes/stream
|
|
|
|
**说明:** 使用 NDJSON 流式返回，便于边收边播放。
|
|
|
|
**响应:** 每行一个 JSON 对象，`type` 字段取值如下:
|
|
- `status` - 阶段提示
|
|
- `frame` - 单帧数据
|
|
- `end` - 完成信息
|
|
- `error` - 错误信息
|
|
|
|
**示例:**
|
|
```json
|
|
{"type":"status","stage":"tts","message":"Generating audio"}
|
|
{"type":"frame","frame":{"timeCode":0.0,"blendShapes":{"JawOpen":0.1}}}
|
|
{"type":"end","frames":900,"audio_path":"...","csv_path":"..."}
|
|
```
|
|
|
|
## 文件说明
|
|
|
|
- `tts_service.py` - 文字转音频服务
|
|
- `a2f_service.py` - Audio2Face包装器
|
|
- `blend_shape_parser.py` - CSV解析器
|
|
- `text_to_blendshapes_service.py` - 主服务
|
|
- `api.py` - Flask API
|