Upload PPT for Video Creation
Updated: 2025-09-04 13:37:15
API Description
1、上传用于视频创作的ppt, 等待ppt转码解析完成后, 即可将该ppt用于视频创作
2、接口支持https协议
API URL
http://api.polyv.net/live/v4/ai/video-produce/ppt/upload
Request Method
POST
API Constraints
- The API supports both HTTP and HTTPS. HTTPS is recommended for security. API calls are subject to rate limits. See details
URL Request Parameter Description (for signing)
| Parameter | Required | Type | Description |
|---|---|---|---|
| appId | true | String | Account appId See details on obtaining keys |
| timestamp | true | Long | Current 13-digit millisecond timestamp, valid within 3 minutes |
| sign | true | String | Signature, a 32-character uppercase MD5 value. The appSecret used for generating the signature is critical for communication data security. It must not be used directly on the client side. All APIs must be called through the customer's own server to relay requests to the POLYV server for response data. See signature generation rules |
POST form-data Parameter Description
| Parameter | Required | Type | Description |
|---|---|---|---|
| url | true | String | PPT file URL, file size limit within 10MB |
| docName | false | String | Custom PPT file name, length limit of 100 characters. If not provided, the PPT name defaults to the filename extracted from the URL. |
| childUserId | false | String | Live streaming sub-account user ID, used to isolate PPT data between sub-accounts. |
Response Parameter Description
| Parameter | Type | Description |
|---|---|---|
| code | Integer | Response status code, 200 for success, non-200 for failure. |
| status | String | Response result, determined by business logic. Returns "success" on success, "error" on failure. |
| success | Boolean | Response result, determined by business logic. Returns true on success, false on failure. |
| data | Object | Channel details returned on successful response. See data field description |
| error | Object | Error information when status code is not 200. See Error field description |
| requestId | String | Request ID, a unique UUID generated for each request. For debugging and troubleshooting only, not for business logic. |
data Parameter Description
| Parameter | Type | Description |
|---|---|---|
| fileId | String | File ID. Note: POLYV will not create duplicate PPT transcoding and parsing tasks for identical PPT files. If you upload the same PPT repeatedly, the returned fileId will be the same. |
Response Example
Success Example
{
"code": 200,
"status": "success",
"requestId": "e90aba2c69a24bab894c7f708b853b75.72.17161066775207261",
"data": {
"fileId": "22d1a1586dc04382685996bc227bfb44c560fac50fpptVideocommon"
},
"success": true
}
Error Parameter Description
| Parameter | Type | Description |
|---|---|---|
| code | Integer | Error code, used to identify the specific error. |
| desc | String | Error description, corresponding to error.code. |
