查询素材列表

更新时间：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
}

直播服务端 API

查询素材列表

接口描述

接口URL

请求方式

接口约束

请求参数描述

示例

响应参数描述

Error参数描述

Data参数描述

Contents参数描述

响应示例