|
|
# SadTalker 文档
|
|
|
|
|
|
## 目录
|
|
|
|
|
|
1. [基础信息](#基础信息)
|
|
|
2. [接口列表](#接口列表)
|
|
|
- [生成动态视频（并移除音频）](#1-生成动态视频并移除音频)
|
|
|
- [生成静音视频（并裁剪视频）](#2-生成静音视频并裁剪视频)
|
|
|
3. [错误响应](#错误响应)
|
|
|
4. [文件命名约定](#文件命名约定)
|
|
|
5. [运行服务](#运行服务)
|
|
|
|
|
|
## 基础信息
|
|
|
|
|
|
- **应用名称**: Video Processing Service
|
|
|
- **基础URL**: `http://<your-server-ip>:8000`
|
|
|
|
|
|
## 接口列表
|
|
|
|
|
|
### 1. 生成动态视频（并移除音频）
|
|
|
|
|
|
- **端点**: `/dynamic-video`
|
|
|
- **方法**: `POST`
|
|
|
- **描述**: 上传图片生成动态视频，并移除视频中的音频。
|
|
|
- **请求参数**:
|
|
|
- **文件**:
|
|
|
- **名称**: `image`
|
|
|
- **类型**: `file`
|
|
|
- **描述**: 要处理的图像文件，格式应为PNG或JPEG。
|
|
|
|
|
|
- **响应**:
|
|
|
- **成功**: 返回生成的无声视频文件。
|
|
|
- **类型**: `video/mp4`
|
|
|
- **失败**:
|
|
|
- **JSON**: `{"error": "No subdirectory found in result directory"}` （如果结果目录中没有找到子目录）
|
|
|
- **JSON**: `{"error": "Video file not found"}` （如果生成的视频文件不存在）
|
|
|
|
|
|
- **示例**:
|
|
|
```sh
|
|
|
curl -X POST "http://<your-server-ip>:8000/dynamic-video" \
|
|
|
-H "accept: application/json" \
|
|
|
-H "Content-Type: multipart/form-data" \
|
|
|
-F "image=@path/to/your/image.png"
|
|
|
```
|
|
|
|
|
|
### 2. 生成静音视频（并裁剪视频）
|
|
|
|
|
|
- **端点**: `/silent-video`
|
|
|
- **方法**: `POST`
|
|
|
- **描述**: 上传图片生成静音视频，并裁剪视频时长。
|
|
|
- **请求参数**:
|
|
|
- **文件**:
|
|
|
- **名称**: `image`
|
|
|
- **类型**: `file`
|
|
|
- **描述**: 要处理的图像文件，格式应为PNG或JPEG。
|
|
|
|
|
|
- **响应**:
|
|
|
- **成功**: 返回生成的裁剪视频文件。
|
|
|
- **类型**: `video/mp4`
|
|
|
- **失败**:
|
|
|
- **JSON**: `{"error": "No subdirectory found in result directory"}` （如果结果目录中没有找到子目录）
|
|
|
- **JSON**: `{"error": "Video file not found"}` （如果生成的视频文件不存在）
|
|
|
|
|
|
- **示例**:
|
|
|
```sh
|
|
|
curl -X POST "http://<your-server-ip>:8000/silent-video" \
|
|
|
-H "accept: application/json" \
|
|
|
-H "Content-Type: multipart/form-data" \
|
|
|
-F "image=@path/to/your/image.png"
|
|
|
```
|
|
|
|
|
|
## 错误响应
|
|
|
|
|
|
所有端点均可能返回以下错误响应：
|
|
|
|
|
|
- **HTTP 400**: 请求格式错误
|
|
|
- **JSON**: `{"detail": "Invalid request"}`
|
|
|
|
|
|
- **HTTP 500**: 服务器内部错误
|
|
|
- **JSON**: `{"detail": "Internal server error"}`
|
|
|
|
|
|
## 文件命名约定
|
|
|
|
|
|
- 上传的图片文件将根据上传接口存储到以下路径：
|
|
|
- 动态视频：`dynamic/dynamic_image.png`
|
|
|
- 静音视频：`silent/silent_image.png`
|
|
|
|
|
|
- 生成的视频文件将存储在 `results` 目录中的子目录下，文件名示例：
|
|
|
- 动态视频：`dynamic_image##dynamic_audio_enhanced.mp4`
|
|
|
- 静音视频：`silent_image##silent_audio_enhanced.mp4`
|
|
|
- 无声视频：`dynamic_image##dynamic_audio_enhanced_dynamic.mp4`
|
|
|
- 裁剪视频：`silent_image##silent_audio_enhanced_trimmed.mp4`
|
|
|
|
|
|
## 运行服务
|
|
|
|
|
|
- 启动服务:
|
|
|
```sh
|
|
|
uvicorn main:app --host 0.0.0.0 --port 8000
|
|
|
```
|
|
|
|
|
|
请确保在实际部署时替换 `<your-server-ip>` 为你的服务器 IP 地址，并根据需要调整端口号。 |