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

使用场景

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

请求说明

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

调试

请求参数

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

Query

Body

返回参数

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

请求示例

{
    "GroupId":12304,
    "Vid":"shilivid"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202111021706140101941000965D007***",
        "Action": "GetVideoByVid",
        "Version": "2021-08-18",
        "Service": "volc_content_api",
        "Region": "cn-north-1"
    },
    "Data": {
        "PosterUrl": "https://....",
        "VideoDuration": 312.122,
        "VideoId": "...",
        "VideoList": [
            {
                "Definition": "360p",
                "MainUrl": "....",
                "Size": 6599735,
                "Height": 360,
                "Width": 360
            }
        ],
        "RequestId": "202111021706140101941000965D007***",
        "VideoStatus": "active"
    },
    "BaseResp": {
        "StatusMessage": "success",
        "StatusCode": 1000
    }
}

错误码

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