|
|
|
@ -1,5 +1,3 @@
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## 视频生成接口文档
|
|
|
|
|
|
|
|
|
|
### 基本信息
|
|
|
|
@ -21,10 +19,13 @@
|
|
|
|
|
|
|
|
|
|
#### 响应
|
|
|
|
|
|
|
|
|
|
| 字段 | 类型 | 描述 |
|
|
|
|
|
| ---- | ---- | ---- |
|
|
|
|
|
| message | string | 视频正在生成,请稍后。 |
|
|
|
|
|
| uid | string | 任务的唯一标识符。 |
|
|
|
|
|
| 字段名 | 类型 | 描述 |
|
|
|
|
|
| ------ | ---- | ---- |
|
|
|
|
|
| message | string | 状态消息,表示视频正在生成。 |
|
|
|
|
|
| uid | string | 唯一任务标识符,可用于查询任务状态。 |
|
|
|
|
|
|
|
|
|
|
- **成功:** 返回任务状态信息,包括唯一任务标识符 `uid`。
|
|
|
|
|
- **失败:** 返回错误信息。
|
|
|
|
|
|
|
|
|
|
### 生成静态视频
|
|
|
|
|
|
|
|
|
@ -40,36 +41,38 @@
|
|
|
|
|
|
|
|
|
|
#### 响应
|
|
|
|
|
|
|
|
|
|
| 字段 | 类型 | 描述 |
|
|
|
|
|
| ---- | ---- | ---- |
|
|
|
|
|
| message | string | 视频正在生成,请稍后。 |
|
|
|
|
|
| uid | string | 任务的唯一标识符。 |
|
|
|
|
|
| 字段名 | 类型 | 描述 |
|
|
|
|
|
| ------ | ---- | ---- |
|
|
|
|
|
| message | string | 状态消息,表示视频正在生成。 |
|
|
|
|
|
| uid | string | 唯一任务标识符,可用于查询任务状态。 |
|
|
|
|
|
|
|
|
|
|
- **成功:** 返回任务状态信息,包括唯一任务标识符 `uid`。
|
|
|
|
|
- **失败:** 返回错误信息。
|
|
|
|
|
|
|
|
|
|
### 查询任务状态
|
|
|
|
|
|
|
|
|
|
- **路径:** `/status/{uid}`
|
|
|
|
|
- **请求方法:** `GET`
|
|
|
|
|
- **描述:** 通过任务的唯一标识符查询任务的状态和结果。
|
|
|
|
|
- **描述:** 通过唯一任务标识符 `uid` 查询任务状态。
|
|
|
|
|
|
|
|
|
|
#### 请求参数
|
|
|
|
|
|
|
|
|
|
| 参数名 | 类型 | 描述 |
|
|
|
|
|
| ------ | ---- | ---- |
|
|
|
|
|
| uid | string | 必填。任务的唯一标识符。 |
|
|
|
|
|
| uid | string | 必填。唯一任务标识符。 |
|
|
|
|
|
|
|
|
|
|
#### 响应
|
|
|
|
|
|
|
|
|
|
| 字段 | 类型 | 描述 |
|
|
|
|
|
| ---- | ---- | ---- |
|
|
|
|
|
| status | string | 任务的状态(processing, completed, failed)。 |
|
|
|
|
|
| video_path | string | (仅在任务完成时返回)生成的视频文件路径。 |
|
|
|
|
|
| message | string | (仅在任务失败时返回)失败原因。 |
|
|
|
|
|
|
|
|
|
|
### 注意事项
|
|
|
|
|
| 字段名 | 类型 | 描述 |
|
|
|
|
|
| ------ | ---- | ---- |
|
|
|
|
|
| status | string | 任务状态(processing、completed、failed)。 |
|
|
|
|
|
| video_path | string | 任务完成时返回的视频路径(仅在任务完成时返回)。 |
|
|
|
|
|
| message | string | 错误信息(仅在任务失败时返回)。 |
|
|
|
|
|
|
|
|
|
|
- 如果上传相同的图片,系统会检查之前是否已经生成了对应的视频。如果已生成则直接返回之前的视频,无需重新生成。
|
|
|
|
|
- 每次上传的图片都会被记录下来,以及对应的生成视频路径,以便下次上传同一张图片时可以直接返回之前的视频。
|
|
|
|
|
- 通过 `uid` 查询任务状态时,如果任务正在处理会返回状态 `processing`,如果生成成功会返回生成的视频文件,如果生成失败会返回失败原因。
|
|
|
|
|
- **成功:** 返回任务状态信息,任务完成时返回生成的视频文件。
|
|
|
|
|
- **失败:** 返回错误信息。
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
### 注意事项
|
|
|
|
|
|
|
|
|
|
- 如果上传相同的图片,系统会检查之前是否已经生成了对应的视频,如果已生成则直接返回之前的视频,无需重新生成。
|
|
|
|
|
- 每次上传的图片都会被记录下来,以及对应的生成视频路径,以便下次上传同一张图片时可以直接返回之前的视频。
|