Query Video Creation Task

Updated: 2026-11-04 11:56:53

API Description

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

API URL

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

Request Method

GET

API Constraints

The API supports both HTTP and HTTPS. HTTPS is recommended to ensure API security. API calls are subject to rate limits. For details, please see

Request Parameter Description

Parameter Name	Required	Type	Description
appId	true	String	Account appId [see Get Key for details]
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 information for communication data security and must never be saved on the client for direct use. All APIs must be called through your own server to relay requests to the POLYV server and obtain response data` [see Signature Generation Rules for details]

Example

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

Response Parameter Description

Parameter Name	Type	Description
code	Integer	Response status code, 200 indicates a successful return, non-200 indicates failure
status	String	Response result, determined by the business; returns success on success and error on failure
success	Boolean	Response result, determined by the business; returns true on success and false on failure
data	Object	Detailed information returned on a successful response [see data field description for details]
error	Object	Error information when the status code is not 200 [see Error field description for details]
requestId	String	Request ID, a unique UUID generated for each request. It is only for troubleshooting and debugging and should not be tied to business logic

data Parameter Description

Parameter Name	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 for details]
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
estimatedDuration	Long	Estimated video duration of the draft, in seconds. Returned only when the draft is in draft status and has been saved under the new rules; returns the value of the most recent successful save. Returns null for other statuses or when a historical draft has not been re-saved
digitalHumanId	Long	ID of the digital human used by the current task
dealTime	Long	Task production 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

Parameter Value	Type	Description
5	Integer	Draft status
10	Integer	Video awaiting production
15	Integer	Video in production
20	Integer	Video production succeeded
30	Integer	Video production failed
50	Integer	Video production 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,
    "estimatedDuration": null,
    "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 Parameter Description

Parameter Name	Type	Description
code	Integer	Error code, used to determine the specific cause of the error
desc	String	Error description, corresponding to error.code