调用 UploadMediaByUrl 接口通过源文件 URL 批量拉取媒资并上传至视频点播。

使用说明

• 使用前，请确保您已充分了解视频点播产品的收费方式和价格。媒资上传到视频点播中会产生存储费用，具体参见媒资存储计费。
• 使用前，请确保您已阅读媒资上传概述了解媒资上传功能、视频点播支持的媒资类型、格式和大小限制。
• 本接口主要适用于文件没有存储在本地服务器或终端，需要通过公网访问的 URL 地址上传的场景。源文件 URL 支持 HTTP 和 HTTPS。
• 本接口为异步上传接口。上传任务成功提交后，系统会生成异步执行的任务，排队执行，不保证时效性。
• 上传任务成功提交后，可通过以下方式获取任务结果：
  • 调用 QueryUploadTaskInfo 接口查询 URL 批量上传任务状态。
  • 配置 URL 批量拉取上传完成事件通知。每个 URL 上传完成时您都将收到通知。配置方式请见事件通知概述。

注意事项

• URL 必须是源文件 URL，不能是包含视频文件的页面 URL。
• 本接口的单用户 QPS 限制为 500 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 QPS 限制。

请求说明

请求地址：https://vod.volcengineapi.com?Action=UploadMediaByUrl&Version=2020-08-01

调试

请求参数

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

返回参数

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

请求示例

https://vod.volcengineapi.com?Action=UploadMediaByUrl&Version=2020-08-01
{
  "SpaceName": "test",
  "URLSets": [
    {
      "Tags": "tag1",
      "Title": "demo",
      "FileName": "example.mp4",
      "SourceUrl": "https://demourl",
      "Templates": [
        {
          "TemplateIds": [
            "abcd***123"
          ],
          "TemplateType": "transcode"
        }
      ],
      "Description": "视频测试",
      "CallbackArgs": "YourCallbackArgs",
      "StorageClass": 1,
      "ClassificationId": 6708,
      "EnableLowPriority": true
    }
  ]
}

返回示例

{
  "Result": {
    "Data": [
      {
        "JobId": "db3ab211095******b0955a30b550",
        "SourceUrl": "https://demourl.mp4"
      }
    ]
  },
  "ResponseMetadata": {
    "Action": "UploadMediaByUrl",
    "Region": "cn-north-1",
    "Service": "vod",
    "Version": "2020-08-01",
    "RequestId": "20230604110420****100232280022D31"
  }
}

错误码

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

服务端 SDK

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

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