查詢素材列表

更新時間：2026-02-27 11:12:23

介面描述

1、查询账号下的素材列表，支持分页，支持按素材类型、分类等条件进行查询。
2、接口支持https协议

介面URL

https://api.polyv.net/live/v4/material/list

請求方式

GET

介面限制

1、介面同時支援HTTP、HTTPS，建議使用HTTPS以確保介面安全，介面呼叫有頻率限制，詳細請查看

請求參數描述

參數名	必填	類型	說明
appId	true	String	帳號appId【詳見取得金鑰】
timestamp	true	Long	當前13位毫秒級時間戳，3分鐘內有效
sign	true	String	簽名，為32位大寫的MD5值，`產生簽名的appSecret金鑰作為通訊資料安全的關鍵資訊，嚴禁儲存在用戶端直接使用，所有API都必須透過客戶自己伺服器中轉呼叫POLYV伺服器取得回應資料`【詳見簽名產生規則】
pageNumber	true	Integer	頁碼
pageSize	true	Integer	每頁資料大小
type	true	String	素材類型 image：圖片 video：影片 audio：音訊 document：文件
categoryId	false	Long	素材分類ID
title	false	String	素材標題或頻道號，支援模糊查詢
startCreateTime	false	Long	建立時間範圍查詢 - 起始值(13位時間戳)
endCreateTime	false	Long	建立時間範圍查詢 - 終止值(13位時間戳)
expireSecond	false	Long	播放地址簽名有效期（單位秒），不傳預設一天時長。最大設定 30天時長（2592000）

範例

http://api.polyv.net/live/v4/material/list?pageNumber=1&pageSize=10&categoryId=123&type=video&appId=frlr1zazn3&sign=A69559D6EBF130B9C0F60807459FC311&timestamp=1642733791590

回應參數描述

參數名	類型	說明
code	Integer	回應狀態碼，200為成功返回，非200為失敗
status	String	回應結果，由業務決定，成功返回success，失敗返回error
success	Boolean	是否成功回應
requestId	String	請求ID，每次請求產生的唯一的 UUID，僅可用於排查、除錯，不應該和業務掛上鉤
error	Object	狀態碼非200時的錯誤資訊【詳見Error欄位描述】
data	Object	【詳見data欄位說明】

Error參數描述

參數名	類型	說明
code	Integer	錯誤代碼，用於確定具體的錯誤原因
desc	String	錯誤描述，與 error.code 對應

Data參數描述

參數名	類型	說明
pageNumber	Integer	目前頁碼
pageSize	Integer	每頁資料量
totalPages	Long	頁面總數
totalItems	Long	總資料量
contents	Array	目前頁內容【詳見contents欄位說明】

Contents參數描述

參數名	類型	說明
id	String	素材ID
url	String	素材存取位址（帶有效期）
title	String	素材標題
type	String	素材類型 video：影片 image：圖片 document：文件 text：圖文
fileSize	Long	檔案大小（位元組）
duration	Long	時長（秒），僅影片類型素材
source	String	素材來源 upload：本機上傳 record：錄製影片 pptRecord：課件重製 aiVideo：AI影片 channelDocument：頻道課件 productExplain：商品講解
extData	Object	擴充資料，不同素材類型包含不同的擴充資訊 firstImg：首圖位址 screenshotList：影片截圖列表 subtitleList：字幕列表 text：圖文內容（僅圖文類型）
categoryId	Long	分類ID
status	String	素材狀態 normal：正常 temp_store：暫存 recycle：回收站 wait_audit：待審核 auditing：審核中 audit_fail：審核失敗 wait_encode：待轉碼 encoding：轉碼中 encode_fail：轉碼失敗 expired：已過期
expireDate	Long	素材過期時間戳（毫秒）
createUserId	String	建立使用者ID
createUserName	String	建立使用者名稱
channelId	Long	關聯頻道ID（僅部分素材有）
createTime	Long	建立時間戳（毫秒）
updateTime	Long	更新時間戳（毫秒）

回應範例

系統全域錯誤說明詳見全域錯誤說明

成功範例

查詢影片素材

{
  "code": 200,
  "status": "success",
  "requestId": "cb237e0e77bc49b59dda283638837d45.79.17479908395732399",
  "data": {
    "pageNumber": 1,
    "pageSize": 10,
    "totalPages": 1,
    "totalItems": 1,
    "contents": [
      {
        "id": "a7fu823e0297829685d04d48e592a164",
        "url": "https://m-tc.videocc.net/polyvlive/02e830941397757912837685700/recordclip-20250516113833-130254-182f0b20_s.mp4?sign=9cd164c11e74d0331a72752b3328413941a3d1b78b9885b01675aa7cb8d98366&t=1748077239",
        "title": "商品讲解-素材库_商品讲解片段",
        "type": "video",
        "fileSize": 3868757,
        "duration": 74,
        "source": "productExplain",
        "extData": {
          "firstImg": "https://videolib-tc.videocc.net/material/2025-05-16/a7fu823e02/video/a7fu823e0297829685d04d48e592a164/a7fu823e0297829685d04d48e592a164_1.jpg",
          "screenshotList": [
            "https://videolib-tc.videocc.net/material/2025-05-16/a7fu823e02/video/a7fu823e0297829685d04d48e592a164/a7fu823e0297829685d04d48e592a164_1.jpg",
            "https://videolib-tc.videocc.net/material/2025-05-16/a7fu823e02/video/a7fu823e0297829685d04d48e592a164/a7fu823e0297829685d04d48e592a164_2.jpg",
            "https://videolib-tc.videocc.net/material/2025-05-16/a7fu823e02/video/a7fu823e0297829685d04d48e592a164/a7fu823e0297829685d04d48e592a164_3.jpg",
            "https://videolib-tc.videocc.net/material/2025-05-16/a7fu823e02/video/a7fu823e0297829685d04d48e592a164/a7fu823e0297829685d04d48e592a164_4.jpg",
            "https://videolib-tc.videocc.net/material/2025-05-16/a7fu823e02/video/a7fu823e0297829685d04d48e592a164/a7fu823e0297829685d04d48e592a164_5.jpg"
          ],
          "fileSize": null,
          "subtitleList": null,
          "recordFile": null,
          "share": {
            "title": "商品讲解-素材库_商品讲解片段",
            "description": "发现了一个精彩视频，快点击看看吧",
            "icon": "https://videolib-tc.videocc.net/material/2025-05-16/a7fu823e02/video/a7fu823e0297829685d04d48e592a164/a7fu823e0297829685d04d48e592a164_1.jpg"
          },
          "text": null
        },
        "categoryId": 1530,
        "status": "normal",
        "expireDate": null,
        "createUserId": "a7fu823e02",
        "createUserName": "系统生成",
        "channelId": 5859892,
        "createTime": 1747366763000,
        "updateTime": 1747366805000,
        "sourceId": null,
        "inChannelPlayback": false
      }
    ]
  },
  "success": true
}

查詢圖片素材

{
  "code": 200,
  "status": "success",
  "requestId": "cb237e0e77bc49b59dda283638837d45.73.17479910224942443",
  "data": {
    "pageNumber": 1,
    "pageSize": 10,
    "totalPages": 1,
    "totalItems": 1,
    "contents": [
      {
        "id": "a7fu823e02a038048f630942fdacc981",
        "url": "https://liveimages.videocc.net/uploaded/images/a7fu823e02/2025/04/h6axa0tk9i.png",
        "title": "红色 128 128.png",
        "type": "image",
        "fileSize": 21868,
        "duration": 0,
        "source": "upload",
        "extData": {
          "firstImg": null,
          "screenshotList": null,
          "fileSize": null,
          "subtitleList": null,
          "recordFile": null,
          "share": null,
          "text": null,
          "encodeTemplateId": "FHD-2"
        },
        "categoryId": 450,
        "status": "normal",
        "expireDate": null,
        "createUserId": "a7fu823e02",
        "createUserName": "欧佩锶",
        "channelId": 0,
        "createTime": 1744302007000,
        "updateTime": 1744302007000,
        "sourceId": null,
        "inChannelPlayback": false
      }
    ]
  },
  "success": true
}

查詢文件素材

{
  "code": 200,
  "status": "success",
  "requestId": "cb237e0e77bc49b59dda283638837d45.73.17479911121192453",
  "data": {
    "pageNumber": 1,
    "pageSize": 10,
    "totalPages": 1,
    "totalItems": 1,
    "contents": [
      {
        "id": "a7fu823e02e492517f80494327b58ad6",
        "url": "https://polyvppt.oss-cn-shenzhen.aliyuncs.com/sources/20250411/a7fu823e02e492517f8043294327b58ad6.pdf",
        "title": "7月体验设计报告.pdf",
        "type": "document",
        "fileSize": 4247512,
        "duration": 0,
        "source": "upload",
        "extData": null,
        "categoryId": 452,
        "status": "normal",
        "expireDate": null,
        "createUserId": "a7fu823e02",
        "createUserName": "欧佩锶",
        "channelId": 0,
        "createTime": 1744301806000,
        "updateTime": 1744301869000,
        "sourceId": null,
        "inChannelPlayback": false
      }
    ]
  },
  "success": true
}

查詢圖文素材

{
  "code": 200,
  "status": "success",
  "requestId": "cb237e0e77bc49b59dda283638837d45.74.17479913547392435",
  "data": {
    "pageNumber": 1,
    "pageSize": 10,
    "totalPages": 1,
    "totalItems": 1,
    "contents": [
      {
        "id": "a7fu823e022710f7d7d26b4f69aaa6c0",
        "url": "",
        "title": "多图测试图文",
        "type": "text",
        "fileSize": 0,
        "duration": 0,
        "source": "upload",
        "extData": {
          "firstImg": null,
          "screenshotList": null,
          "fileSize": null,
          "subtitleList": null,
          "recordFile": null,
          "share": {
            "title": "多图测试图文",
            "description": "发现了一个精彩内容，快点击看看吧",
            "icon": "https://liveimages.videocc.net/uploaded/images/a7fu823e02/2025/03/h5zardn31m.jpg?plv_mms=1743391043863-350.3742757194408"
          },
          "text": {
            "images": [
              "https://liveimages.videocc.net/uploaded/images/a7fu823e02/2025/03/h5zardn31m.jpg?plv_mms=1743391043863-350.3742757194408",
              "https://liveimages.videocc.net/uploaded/images/a7fu823e02/2025/03/h5zards08q.jpg?plv_mms=1743391043863-602.6920334225199",
              "https://liveimages.videocc.net/uploaded/images/a7fu823e02/2025/01/h3nqvs8jas.jpeg?plv_mms=1743391043863-751.5467422146664",
              "https://liveimages.videocc.net/uploaded/images/a7fu823e02/2025/01/h3nqtk957b.jpeg?plv_mms=1743391043863-420.29323508747865",
              "https://liveimages.videocc.net/uploaded/images/a7fu823e02/2024/12/h30ix9w7qj.jpg?plv_mms=1743391043863-197.84624565239062",
              "https://liveimages.videocc.net/uploaded/images/a7fu823e02/2024/12/h30iwvyu4r.jpg?plv_mms=1743391043863-922.8547464558876",
              "https://liveimages.videocc.net/uploaded/images/a7fu823e02/2024/12/h30iwlmh6j.jpeg?plv_mms=1743391043863-12.867434730769789",
              "https://liveimages.videocc.net/uploaded/images/a7fu823e02/2024/10/h153sh5jk0.jpg?plv_mms=1743391043863-632.0940623335202",
              "https://liveimages.videocc.net/uploaded/images/a7fu823e02/2024/10/h153sh3vyn.jpg?plv_mms=1743391043863-965.7372635000663",
              "https://liveimages.videocc.net/uploaded/images/a7fu823e02/2024/10/h153shiyd5.jpg?plv_mms=1743391043863-314.0656978590886",
              "https://liveimages.videocc.net/uploaded/images/a7fu823e02/2024/10/h153sge9pg.jpg?plv_mms=1743391058642-460.42600062547456",
              "https://liveimages.videocc.net/uploaded/images/a7fu823e02/2024/10/h153sgf9pu.jpg?plv_mms=1743391058642-614.4276765364893",
              "https://liveimages.videocc.net/uploaded/images/a7fu823e02/2024/10/h153sfr5q5.jpg?plv_mms=1743391058642-217.8931084108091",
              "https://liveimages.videocc.net/uploaded/images/a7fu823e02/2025/03/h5zb7a45id.jpg?plv_mms=1743392053424-313.51302601559826",
              "https://liveimages.videocc.net/uploaded/images/a7fu823e02/2025/03/h5zb5w0dsn.png?plv_mms=1743392240749-654.9400646223855"
            ],
            "description": "多图测试图文22222222222222"
          }
        },
        "categoryId": 1037,
        "status": "normal",
        "expireDate": null,
        "createUserId": "a7fu823e02",
        "createUserName": "欧佩锶",
        "channelId": 0,
        "createTime": 1743391137000,
        "updateTime": 1747991341000,
        "sourceId": null,
        "inChannelPlayback": false
      }
    ]
  },
  "success": true
}

異常範例

{
  "code": 400,
  "status": "error",
  "error": {
    "code": 10003,
    "desc": "时间戳过期"
  },
  "success": false
}