50 lines
1.2 KiB
Markdown
50 lines
1.2 KiB
Markdown
# AIGC Backend (Python FastAPI)
|
||
|
||
原 Node.js + Koa 服务的 Python 重写版本，使用 FastAPI 框架。
|
||
|
||
## 环境要求
|
||
|
||
- Python 3.9+
|
||
|
||
## 安装依赖
|
||
|
||
```shell
|
||
uv sync
|
||
```
|
||
|
||
## 场景配置
|
||
|
||
编辑 `scenes/*.json`，填写以下字段：
|
||
|
||
| 字段 | 说明 |
|
||
|------|------|
|
||
| `AccountConfig.accessKeyId` | 火山引擎 AK，从 https://console.volcengine.com/iam/keymanage/ 获取 |
|
||
| `AccountConfig.secretKey` | 火山引擎 SK |
|
||
| `RTCConfig.AppId` | RTC 应用 ID |
|
||
| `RTCConfig.AppKey` | RTC 应用 Key（用于自动生成 Token） |
|
||
| `VoiceChat.*` | AIGC 相关配置，参考 https://www.volcengine.com/docs/6348/1558163 |
|
||
|
||
## 启动服务
|
||
|
||
```shell
|
||
uvicorn main:app --host 0.0.0.0 --port 3001 --reload
|
||
```
|
||
|
||
服务启动后监听 `http://localhost:3001`。
|
||
|
||
## 接口说明
|
||
|
||
### POST /getScenes
|
||
|
||
返回所有场景列表，自动生成 RoomId/UserId/Token（若未在 JSON 中配置）。
|
||
|
||
### POST /proxy?Action={Action}&Version={Version}
|
||
|
||
代理转发至火山引擎 RTC OpenAPI。
|
||
|
||
支持的 Action：
|
||
- `StartVoiceChat` — 启动语音对话
|
||
- `StopVoiceChat` — 停止语音对话
|
||
|
||
请求体需包含 `SceneID` 字段，对应 `scenes/` 目录下的 JSON 文件名（不含扩展名）。
|