查詢影片創作任務列表
更新時間:2026-11-04 11:56:53
介面描述
1、分页查询视频创作任务列表
2、接口支持https协议
介面URL
http://api.polyv.net/live/v4/ai/video-produce/list
請求方式
GET
介面約束
1、介面同時支援HTTP 、HTTPS ,建議使用HTTPS 確保介面安全,介面呼叫有頻率限制,詳細請查看
請求參數描述
| 參數名 | 必選 | 類型 | 說明 |
|---|---|---|---|
| appId | true | String | 帳號appId【詳見取得金鑰】 |
| timestamp | true | Long | 當前13位毫秒級時間戳,3分鐘內有效 |
| pageNumber | true | Integer | 分頁參數, 頁碼 |
| pageSize | true | Integer | 分頁參數, 每頁資料量, 最大1000 |
| videoName | false | String | 影片名稱, 限制60個字元 |
| status | false | Integer | 狀態, 【詳見status參數描述】 |
| createTimeStart | false | Long | 任務建立時間範圍查詢左邊界(時間戳) |
| createTimeEnd | false | Long | 任務建立時間範圍查詢右邊界(時間戳) |
| tags | false | List | 標籤, 格式是字串陣列, 最多支援10個標籤 |
| sign | true | String | 簽名,為32位大寫的MD5值,生成簽名的appSecret金鑰作為通訊資料安全的關鍵資訊,嚴禁儲存在用戶端直接使用,所有API都必須透過客戶自己伺服器中轉呼叫POLYV伺服器取得回應資料【詳見簽名生成規則】 |
範例
http://api.polyv.net/live/v4/ai/video-produce/list?timestamp=1716107535043&appId=gopl67qi7e&pageSize=10&pageNumber=1&createTimeStart=1719763200000&createTimeEnd=1719849600000&sign=6625340A6017272DF55CD1F5DC42CFCB
回應參數描述
| 參數名 | 類型 | 說明 |
|---|---|---|
| code | Integer | 回應狀態碼,200為成功返回,非200為失敗 |
| status | String | 回應結果,由業務決定,成功返回success,失敗返回error |
| success | Boolean | 回應結果,由業務決定,成功返回true,失敗返回false |
| data | Object | 成功回應時返回詳細資訊【詳見data欄位說明】 |
| error | Object | 狀態碼非200時的錯誤資訊【詳見Error欄位說明】 |
| requestId | String | 請求ID,每次請求生成的唯一的 UUID,僅可用於排查、除錯,不應該和業務掛上鉤 |
data參數描述
| 參數名 | 類型 | 說明 |
|---|---|---|
| pageNumber | Integer | 分頁參數, 頁碼 |
| pageSize | Integer | 分頁參數, 每頁資料量 |
| totalPages | Integer | 分頁參數, 總頁數 |
| totalItems | Integer | 分頁參數, 總資料量 |
| contents | List | 數字人詳細資訊, 【詳見contents參數描述】 |
contents參數描述
| 參數名 | 類型 | 說明 |
|---|---|---|
| id | Long | 任務ID |
| videoName | String | 影片名稱 |
| type | Integer | 1: 無數字人任務, 3: 有數字人任務 |
| status | Integer | 【詳見status參數描述】 |
| videoPath | String | 影片位址 |
| videoImage | String | 影片封面圖位址 |
| videoFileSize | Long | 影片檔案大小, 單位是byte |
| duration | Long | 影片時長, 單位是秒 |
| estimatedDuration | Long | 草稿預計影片時長,單位是秒。僅草稿狀態且已按新規則儲存時返回最近一次儲存成功的值,其他狀態或歷史草稿未重新儲存時返回null |
| digitalHumanId | Long | 當前任務使用的數字人id |
| dealTime | Long | 任務製作完成時間(時間戳) |
| createTime | Long | 任務建立時間(時間戳) |
| modifyTime | Long | 任務最後修改時間(時間戳) |
| subtitlePath | String | 字幕位址 |
| tags | List | 標籤, 字串陣列格式 |
status參數描述
| 參數值 | 類型 | 說明 |
|---|---|---|
| 5 | Integer | 草稿狀態 |
| 10 | Integer | 影片等待製作 |
| 15 | Integer | 影片製作中 |
| 20 | Integer | 影片製作成功 |
| 30 | Integer | 影片製作失敗 |
| 50 | Integer | 影片製作任務已過期 |
回應範例
成功範例
{
"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參數描述
| 參數名 | 類型 | 說明 |
|---|---|---|
| code | Integer | 錯誤代碼,用於確定具體的錯誤原因 |
| desc | String | 錯誤描述,與 error.code 對應 |
