Query Video Creation Task List

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

API Description

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

API URL

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

Online API Call

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
pageNumber	true	Integer	Pagination parameter, page number
pageSize	true	Integer	Pagination parameter, number of records per page, maximum 1000
videoName	false	String	Video name, limited to 60 characters
status	false	Integer	Status, [see status parameter description for details]
createTimeStart	false	Long	Left boundary of the task creation time range query (timestamp)
createTimeEnd	false	Long	Right boundary of the task creation time range query (timestamp)
tags	false	List	Tags, in string array format, supports up to 10 tags
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 not be saved on the client for direct use. All APIs must be called through the customer's 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/list?timestamp=1716107535043&appId=gopl67qi7e&pageSize=10&pageNumber=1&createTimeStart=1719763200000&createTimeEnd=1719849600000&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 success [see data field description for details]
error	Object	Error information when the status code is non-200 [see Error field description for details]
requestId	String	Request ID, a unique UUID generated for each request, usable only for troubleshooting and debugging, and should not be tied to business logic

data Parameter Description

Parameter Name	Type	Description
pageNumber	Integer	Pagination parameter, page number
pageSize	Integer	Pagination parameter, number of records per page
totalPages	Integer	Pagination parameter, total number of pages
totalItems	Integer	Pagination parameter, total number of records
contents	List	Digital human detailed information, [see contents parameter description for details]

contents 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
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 from 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 waiting for production
15	Integer	Video in production
20	Integer	Video production succeeded
30	Integer	Video production failed
50	Integer	Video production task has expired

Response Example

Success example

{
  "code": 200,
  "status": "success",
  "requestId": "a571dd2e594d4a4b9cfef30250bd35a0.68.17222469243988627",
  "data": {
    "pageNumber": 1,
    "pageSize": 3,
    "totalPages": 2,
    "totalItems": 6,
    "contents": [
      {
        "id": 6765,
        "videoName": "我的视频创作任务1",
        "type": 3,
        "status": 5,
        "videoPath": null,
        "videoImage": null,
        "duration": null,
        "estimatedDuration": 57,
        "digitalHumanId": 45,
        "dealTime": null,
        "createTime": 1722246912000,
        "modifyTime": 1722246912000
      },
      {
        "id": 6710,
        "videoName": "我的视频创作任务2",
        "type": 3,
        "status": 20,
        "uploadStatus": 0,
        "videoPath": "https://oss-live-1.videocc.net/pptvideo/20240725/video/6710_c1fd4c452ea3413c933d9a3364e23d3d.mp4",
        "videoImage": "https://oss-live-1.videocc.net/pptvideo/20240725/image/6710_c1fd4c452ea3413c933d9a3364e23d3d.jpeg",
        "duration": 60,
        "estimatedDuration": null,
        "digitalHumanId": 45,
        "dealTime": 1721879928000,
        "createTime": 1721879652000,
        "modifyTime": 1721879928000
      },
      {
        "id": 6185,
        "videoName": "我的视频创作任务3",
        "type": 1,
        "status": 50,
        "videoPath": "https://oss-live-1.videocc.net/pptvideo/20240627/video/6185_91e59d88668841c581c7307377ff55bb.mp4",
        "videoImage": "https://oss-live-1.videocc.net/pptvideo/20240627/image/6185_91e59d88668841c581c7307377ff55bb.jpeg",
        "duration": null,
        "estimatedDuration": null,
        "digitalHumanId": null,
        "dealTime": 1719503446000,
        "createTime": 1719503172000,
        "modifyTime": 1722096000000
      }
    ]
  },
  "success": true
}

Error Parameter Description

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