本接口支持无需传递Vid参数，即可批量获取可播放的资源链接。

使用场景

• 接口使用方式：
  • 视频播放时，调用接口获取播放链接，判断VideoStatus字段，active时为可播放，可避免下发后因内容状态变更导致的链接失效。
• 视频url有效期：
  • 火山视频内容url有效期为一个小时+视频时长，遵从防盗链合规机制，不支持更改；
  • 内容创作方式引入的视频内容，视频url有效时长可在视频云配置，需大于60分钟，详见：域名配置 - 访问控制 - 时间戳防盗链。

请求说明

• 请求方式：POST
• 请求地址：https://cms.volcengineapi.com?Action=MGetVideoByGids&Version=2021-01-01
• 请求头：ServiceName: volc_content_api

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

Body

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构

请求示例

{
    "GroupIds": [
         170....,
         170....,
    ]
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20210903095110010225146063018E0***",
        "Action": "MGetVideoByGids",
        "Version": "2021-09-01",
        "Service": "volc_content_api",
        "Region": "cn-north-1"
    },
    "Data": {
        "Videos":[
            {
                "PosterUrl": "https://....",
                "VideoDuration": 15.318,
                "VideoId": "...",
                "RequestId": "20210903095110010225146063018E0***",
                "VideoStatus": "wait_audit"
            }
        ],
        "MissReasons":[
            {
                "GroupId": 1773026091,
                "Reason": "gid_not_exist_or_delete"
            }
        ]
    }
    "BaseResp": {
        "StatusMessage": "success",
        "StatusCode": 1000
    }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。