此接口用于在指定空间下，设置会话 ID、提取视频元信息方式、上传函数等参数，确认媒资上传到视频点播的结果。

使用说明

• 确认上传成功后将返回 Vid 以及媒资基础信息。
• 完整上传流程可参考媒资上传概述。
• 您可以配置视频上传完成回调通知。当视频上传完成时，您将收到事件回调消息，配置方法详见回调设置。

请求说明

请求地址：https://vod.volcengineapi.com?Action=CommitUploadInfo&Version=2022-01-01

调试

请求参数

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

返回参数

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

请求示例 1

音视频上传

https://vod.volcengineapi.com?Action=CommitUploadInfo&Version=2022-01-01&SpaceName=YourSpaceName&SessionKey=ApplyUploadInfoReturnSessionKey&CallbackArgs=""&GetMetaMode=&Functions=[{"Name": "GetMeta"},{"Name":"Snapshot","Input":{"SnapshotTime": 2.0}}]

返回示例 1

{
  "ResponseMetadata": {
    "RequestId": "2020110618300501022509205920011***",
    "Action": "CommitUploadInfo",
    "Version": "2022-01-01",
    "Service": "vod",
    "Region": "cn-north-1"
  },
  "Result": {
    "Data": {
      "Vid": "v0c255fa007abu0lc8a0oej77lbbv***",
      "SourceInfo": {
        "StoreUri": "tos-path-v-da1421/49ad5efabc3a4b32bed5df34fa7fd***",
        "Md5": "cf2b56eaa3fe3ec856ec4503a068a***",
        "Width": 960,
        "Height": 540,
        "Duration": 52.036,
        "Bitrate": 2068561,
        "Format": "MP4",
        "Size": 13454959,
        "FileType": "video"
      },
      "PosterUri": "tos-path-v-da1421/3108f4e3298248bda9e5658ae0a52***",
      "CallbackArgs": ""
    }
  }
}

请求示例 2

素材上传-音视频

https://vod.volcengineapi.com?Action=CommitUploadInfo&Version=2022-01-01&SpaceName=YourSpaceName&SessionKey=ApplyUploadInfoReturnSessionKey&CallbackArgs=""&GetMetaMode=&Functions=[{"name":"GetMeta"},{"name":"AddOptionInfo","input":{"Title":"视频01.mp4","Category":"video","FileType":"media","Format":"mp4","RecordType":2}}]

返回示例 2

{
    "ResponseMetadata": {
        "RequestId": "20231219194***543B816B334B878A66",
        "Action": "CommitUploadInfo",
        "Version": "2022-01-01",
        "Service": "vod",
        "Region": "cn-north-1"
    },
    "Result": {
        "Data": {
            "SourceInfo": {
                "Md5": "f6bd77b31cbd***4687a886df9c8",
                "FileType": "video",
                "Height": 1080,
                "Width": 2872,
                "Format": "MP4",
                "Duration": 11.423,
                "Size": 4301565,
                "StoreUri": "tos-vod-cn-v-03e4d54***112705/视频01.mp4",
                "Bitrate": 3012564,
                "Fps": 30,
                "VideoStreamMeta": {
                    "Codec": "h264",
                    "Height": 1080,
                    "Width": 2872,
                    "Duration": 11.423,
                    "Definition": "unknown",
                    "Bitrate": 3012564,
                    "Fps": 30
                },
                "AudioStreamMeta": {
                    "Duration": 11.422766,
                    "SampleRate": 44100,
                    "Bitrate": 128455
                },
                "TosStorageClass": "STANDARD",
                "FileName": "视频01.mp4"
            },
            "PosterUri": "tos-vod-cn-v-03e4d5***12705/视频01_cover",
            "Mid": "v02c24g10001cm***s1v0vvbrod9rg"
        }
    }
}

请求示例 3

素材上传-图片

https://vod.volcengineapi.com?Action=CommitUploadInfo&Version=2022-01-01&SpaceName=YourSpaceName&SessionKey=ApplyUploadInfoReturnSessionKey&CallbackArgs=""&GetMetaMode=&Functions=[{"name":"GetMeta"},{"name":"AddOptionInfo","input":{"Title":"03.png","Category":"image","FileType":"image","Format":"png","RecordType":2}}]

返回示例 3

{
    "ResponseMetadata": {
        "RequestId": "2023121919***A1890C411D0907DC666",
        "Action": "CommitUploadInfo",
        "Version": "2022-01-01",
        "Service": "vod",
        "Region": "cn-north-1"
    },
    "Result": {
        "Data": {
            "SourceInfo": {
                "Md5": "7ea8e3d4739d***6546dc9f71ac1d0",
                "Height": 378,
                "Width": 966,
                "Format": "png_pipe",
                "Size": 24221,
                "StoreUri": "tos-vod-cn-v-03e4d54***12705/03.png",
                "FileName": "03.png"
            },
            "Mid": "i0032s8ri4dl***83c77u4bfeg3utg"
        }
    }
}

请求示例 4

如下为素材上传-字幕或者字体示例：

https://vod.volcengineapi.com?Action=CommitUploadInfo&Version=2022-01-01&SpaceName=YourSpaceName&SessionKey=eyJBcHBJRCI6IiIsIkxlZ2FsIjoiIiwiVXNlcklEIjo***MjcwNS/lrZfluZUwMSJ9&CallbackArgs=""&GetMetaMode=&Functions=[{"name":"GetMeta"},{"name":"AddOptionInfo","input":{"Title":"字幕.AAC.ass","Category":"subtitle","FileType":"object","Format":"ass","RecordType":2}}]

返回示例 4

{
    "ResponseMetadata": {
        "RequestId": "2023121919***41C8A3521108088CEEED",
        "Action": "CommitUploadInfo",
        "Version": "2022-01-01",
        "Service": "vod",
        "Region": "cn-north-1"
    },
    "Result": {
        "Data": {
            "SourceInfo": {
                "Size": 228349,
                "StoreUri": "tos-vod-cn-v-03e4d5***112705/字幕01",
                "FileName": "字幕01"
            },
            "Mid": "s00d250hbohsc***jc77u3of8hvsfg"
        }
    }
}

错误码

下表列举了本接口特有的错误码。如需了解更多错误码，详见视频点播公共错误码。

服务端 SDK

点播 OpenAPI 提供了配套的服务端 SDK，支持多种编程语言，帮助您实现快速开发。建议使用服务端 SDK 来调用 API，此 API 各语言调用的示例代码，请参考如下：

• Java
• Python
• PHP
• Go
• Node.js