You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2.1 KiB
2.1 KiB
## 视频生成接口文档
### 基本信息
- 接口地址：
http://192.168.10.70:8000/
- API 版本： 1.0
### 生成动态视频
- 路径： /dynamic-video
- 请求方法： POST
- 描述： 上传一张图片，生成带有动态效果的视频。
#### 请求参数
| 参数名 | 类型 | 描述 |
| ------ | ---- | ---- |
| image | File | 必填。要上传的图片文件。 |
#### 响应
| 字段 | 类型 | 描述 |
| ---- | ---- | ---- |
| message | string | 视频正在生成，请稍后。 |
| uid | string | 任务的唯一标识符。 |
### 生成静态视频
- 路径： /silent-video
- 请求方法： POST
- 描述： 上传一张图片，生成无声的视频。
#### 请求参数
| 参数名 | 类型 | 描述 |
| ------ | ---- | ---- |
| image | File | 必填。要上传的图片文件。 |
#### 响应
| 字段 | 类型 | 描述 |
| ---- | ---- | ---- |
| message | string | 视频正在生成，请稍后。 |
| uid | string | 任务的唯一标识符。 |
### 查询任务状态
- 路径： /status/{uid}
- 请求方法： GET
- 描述： 通过任务的唯一标识符查询任务的状态和结果。
#### 请求参数
| 参数名 | 类型 | 描述 |
| ------ | ---- | ---- |
| uid | string | 必填。任务的唯一标识符。 |
#### 响应
| 字段 | 类型 | 描述 |
| ---- | ---- | ---- |
| status | string | 任务的状态（processing, completed, failed）。 |
| video_path | string | （仅在任务完成时返回）生成的视频文件路径。 |
| message | string | （仅在任务失败时返回）失败原因。 |
### 注意事项
- 如果上传相同的图片，系统会检查之前是否已经生成了对应的视频。如果已生成则直接返回之前的视频，无需重新生成。
- 每次上传的图片都会被记录下来，以及对应的生成视频路径，以便下次上传同一张图片时可以直接返回之前的视频。
- 通过 uid 查询任务状态时，如果任务正在处理会返回状态 processing，如果生成成功会返回生成的视频文件，如果生成失败会返回失败原因。