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

使用场景

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

请求说明

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

调试

请求参数

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

Query

Body

返回参数

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

请求示例

{
    "GroupId":12304
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "02162938737815900000000000000000000ffff0acc1c0d448cef",
        "Action": "GetVideoByGid",
        "Version": "2021-01-01",
        "Service": "volc_content_api",
        "Region": "cn-north-1"
    },
    "Data": {
        "PosterUrl": "...",
        "VideoDuration": 242.5,
        "VideoId": "shilivid",
        "VideoList": [
            {
                "Definition": "360p",
                "MainUrl": "...",
                "Size": 5405063,
                "Height": 360,
                "Width": 640
            },
            
        ],
        "RequestId": "02162938737815900000000000000000000ffff0acc1c0d448cef",
        "VideoStatus": "active",
        "GroupId": 12304
    },
    "BaseResp": {
        "StatusMessage": "success",
        "StatusCode": 1000
    }
}

错误码

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