通过内容推荐接口获取到火山来源的视频内容后，通过Vid和GroupId调用接口批量获取可播放的资源链接。

使用场景

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

请求说明

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

调试

请求参数

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

Query

Body

返回参数

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

请求示例

{
    "GroupVideos": [
        {
            "GroupId": 170....,
            "Vid": "...."
        }
    ]
}

返回示例

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

错误码

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