跳转至

视频上传

登录接口

[POST] /api/v1/uploads

输入参数

参数名称 必选 类型 描述
scene String queryString 参数,当前上传文件所属的类型,值:media - 媒体文件,material - 素材文件,subtitle - 字幕文件
upload Binary form-file 参数,当前上传文件的二进制,需要在请求头中设置 "Content-Type", "multipart/form-data; boundary=----WebKitFormBoundaryhbOZttuwlt0kBawD"
workflowId String queryString 或 form-string 参数,当需要在上传成功后,自动对该文件触发指定工作流时,需要指定工作流ID

返回结果

参数名称 类型 描述
uid String 媒体或素材文件的唯一标识
File String 文件名称
Bucket String 当前用户所属租户的对象存储桶名称
Path String 文件上传到对象存储中的存放路径
type String 上传的文件类型,对应值为:0 - 未知,1 - 视频,2 - 音频,3 - 图片,4 - 字幕

示例

以下为 Javascript 语言的代码示例, 示例中 Authorization 参数均以字符串 "token" 表示

输入示例

var data = new FormData();
data.append("upload", fileInput.files[0], "/C:/Users/yourname/Downloads/Japan-in-8K-60fps.mp4");

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function() {
  if(this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "http://vod.test.mediacloud.imgo.tv/api/v1/uploads?scene=media");
xhr.setRequestHeader("Content-Type", "multipart/form-data; boundary=----WebKitFormBoundaryhbOZttuwlt0kBawD");
xhr.setRequestHeader("Authorization", "token");

xhr.send(data);
输出示例
{
    "requestId": "2dd622b1-fe45-4ad6-934a-a17f901b537c",
    "code": 200,
    "msg": "上传成功",
    "data": [
        {
            "uid": "09f55e10-d98a-440d-8437-59c198b7e992",
            "File": "Japan-in-8K-60fps.mp4",
            "Bucket": "vod-7e30cf64-572c-4338-9674-86583f725fa0",
            "Path": "2024/03/08/4fb7297f-2ba7-4382-8c29-13b914eb0887.mp4",
            "type": 0
        }
    ]
}