Polyv Help Center

Help Center

Live Streaming Server API

Query Video Creation Task

Updated: 2025-10-27 18:29:20

API Description

1、查询视频创作任务
2、接口支持https协议

API URL

http://api.polyv.net/live/v4/ai/video-produce/get

Request Method

GET

API Constraints

  1. The API supports both HTTP and HTTPS. HTTPS is recommended for security. API calls have frequency limits. See details

Request Parameters

Parameter Required Type Description
appId true String Account appId See details on obtaining keys
timestamp true Long Current 13-digit millisecond timestamp, valid for 3 minutes
aiPPTVideoId true Integer Video creation task ID
sign true String Signature, a 32-character uppercase MD5 value. The appSecret key used to generate the signature is critical for communication data security. It must never be used directly on the client side. All APIs must be called through your own server to relay requests to the POLYV server for responses. See signature generation rules

Example

http://api.polyv.net/live/v4/ai/video-produce/get?timestamp=1716107535043&appId=gopl67qi7e&aiPPTVideoId=4229&sign=6625340A6017272DF55CD1F5DC42CFCB

Response Parameters

Parameter Type Description
code Integer Response status code, 200 for success, non-200 for failure
status String Response result, determined by business logic: success returns "success", failure returns "error"
success Boolean Response result, determined by business logic: success returns true, failure returns false
data Object Detailed information on successful response See data field description
error Object Error information when status code is non-200 See Error field description
requestId String Request ID, a unique UUID generated for each request. Only for troubleshooting and debugging; should not be tied to business logic

data Field Description

Parameter Type Description
id Long Task ID
videoName String Video name
type Integer 1: Task without digital human, 3: Task with digital human
status Integer See status parameter description
videoPath String Video URL
subtitlePath String Subtitle URL
videoImage String Video cover image URL
videoFileSize Long Video file size, in bytes
duration Long Video duration, in seconds
digitalHumanId Long Digital human ID used in the current task
dealTime Long Task completion time (timestamp)
createTime Long Task creation time (timestamp)
modifyTime Long Task last modification time (timestamp)
subtitlePath String Subtitle URL
tags List Tags, in string array format

status Parameter Description

Value Type Description
5 Integer Draft status
10 Integer Video pending creation
15 Integer Video in progress
20 Integer Video creation successful
30 Integer Video creation failed
50 Integer Video creation task expired

Response Example

Success Example

{
  "code": 200,
  "status": "success",
  "requestId": "be442eaa-0e03-426c-b6e8-36a8b4ac7b0d",
  "data": {
    "id": 4229,
    "videoName": "视频名称-测试",
    "fileId": "",
    "fileName": null,
    "type": 3,
    "status": 20,
    "times": 1,
    "uploadStatus": 0,
    "videoPath": "https://oss-live-1.videocc.net/pptvideo/20250714/video/4229_cb77f770eccc4f3ea5435021947e9b98.mp4",
    "videoImage": "https://oss-live-1.videocc.net/pptvideo/20250714/image/4229_cb77f770eccc4f3ea5435021947e9b98.jpg",
    "videoFileSize": 510437,
    "digitalHumanId": 15,
    "digitalHumanPositionSize": "1412,247,467,830",
    "videoPoolId": null,
    "dealTime": 1752478906000,
    "expireTime": 1755070906000,
    "duration": 1,
    "executeTime": null,
    "retry": 0,
    "errorMessage": "",
    "innerErrorMessage": "",
    "createTime": 1752478716000,
    "modifyTime": 1752478906000,
    "draftJsonUrl": null,
    "subtitlePath": "https://oss-live-1.videocc.net/pptvideo/20250714/subtitle/4229_cb77f770eccc4f3ea5435021947e9b98.srt"
  },
  "success": true
}

Error Field Description

Parameter Type Description
code Integer Error code, used to identify the specific error
desc String Error description, corresponding to error.code
联系客服，在线咨询