帝网云是中国最专业的CDN及IDC综合服务提供商,自主研发的“EasyCDN”网络加速技术获得国家级认证,通过引入主动的内容管理层和全局负载均衡,并结合内容缓存等技术,提高响应速度和服务质量。1对1专席客服,7*24小时技术支持,数据可靠性达99%。

调用方式

服务地址

云转码服务的API地址:    http://transcoder5.dwion.com

通信协议:    Restful API风格,支持通过 HTTP 通道进行请求通信。

请求头域:
字段 类型 描述
Content-Type string application/json MIME类型
Identifier string xxxxxxxxxxxxx 用户唯一标识

请求方式:
GET/POST/PUT/DELETE

请求参数:
每个请求都需要指定要操作的资源对应的URI,以及指定操作所支持的请求参数,详情见对应接口说明。

字符编码:
请求及返回结果都使用 UTF-8 字符集进行编码。

HTTP状态码:
 401表示Identifier错误
 400表示请求参数错误
 2xx表示请求正确

查询预置转码模板接口

查询预置转码模板接口
【功能说明】
查询预置转码模板。
【http方法】
使用GET方法。
【请求URL】
http://transcoder5.dwion.com/dniontranscode/v1/template
【请求参数说明】
名称 类型 是否必填 描述
Identifier 请求头 DnionCommonTemplates

查询支持的模板参数接口

查询支持的模板参数接口
【功能】
查询支持的所有模板参数接口。
【http方法】
使用GET方法。
【请求URL】
http://transcoder5.dwion.com/dniontranscode/v1/param
【返回参数说明】
名称 类型 描述
Container List 音视频格式,见附录Container详情
Video Dict 视频参数,见附录Video详情
Audio Dict 音频参数,见附录Audio详情
Segment List 分片时长参数,见附录Segment详情
Font Dict 字体相关参数,见附录Font详情
Conflict List 互斥参数组合,见附录Conflict详情

自定义转码模板接口

新增自定义转码模板
【功能】
创建自定义转码模板,包含容器信息,视频跟音频流等设置如果相应部分不做设置,则使用模板转出来的码流中也不会包含相应的信息。
【http方法】
使用POST方法。
【请求URL】
http://transcoder5.dwion.com/dniontranscode/v1/template
【请求参数】
名称 类型 是否必填 描述
Name String 模板名称,最大128个字节。
Container String 容器格式,见附录参数Container详情。
Video Dict 视频流配置,见附录参数Video详情。例如:
{
"Codec":"H.264",
"Profile":"High",
"Bitrate":"400",
"Width":"640",
"Height":"360",
"Fps":"26",
"Gop":"60"
}
不设置Video参数则转码输出不包括视频流;如需保留视频流则必须设置此值。
Audio Dict 音频流配置,见附录参数Audio详情。例如:
{
"Codec":"AAC",
"Samplerate":"44100",
"Channels":"2",
"Bitrate":"64"
}
不设置Audio参数则转码输出不包括音频流;如需保留音频流则必须设置此对象。
Segment String 切片时长,见附录参数Segment详情。

【请求body示例】
{
    "Name": "MP4-HD",
    "Container": "MP4",
    "Video":
    {
        "Codec": "H.264",
        "Profile": "High",
        "Bitrate": "1800",
        "Width": "1280",
        "Height": "720",
        "Fps": "26",
        "Gop": "60"
    },
    "Audio":
    {
        "Codec": "AAC",
        "Samplerate": "44100",
        "Channels": "2",
        "Bitrate": "128"
    }
}
【返回示例】
{
 "Id":4,
"Enable":true
}
【返回参数说明】
名称 类型 描述
Id Int 模板id 
Enable Bool 模板状态,Enable=true开启,Enable=false停用

更新自定义转码模板
【功能】
更新转码模板。
【http方法】
使用PUT方法。
【请求URL】
http://transcoder5.dwion.com/dniontranscode/v1/template
【请求参数】
名称 类型 是否必填 描述
Id Int 模板id
Name String 模板名称,最大128个字节。
Container String 容器格式,见附录参数Container详情。
Video Dict 视频流配置,见附录参数Video详情。例如:
{
"Codec":"H.264",
"Profile":"High",
"Bitrate":"400",
"Width":"640",
"Height":"360",
"Fps":"26",
"Gop":"60"
}
Audio Dict 音频流配置,见附录参数Audio详情。例如:
{
"Codec":"AAC",
"Samplerate":"44100",
"Channels":"2",
"Bitrate":"64"
}
Segment String 切片时长,见附录参数Segment详情。
Enable Bool true为启用,false为停用,默认true

【请求body示例】
{
    "Id": 4,
    "Name": "MP4-HD",
    "Container": "MP4",
    "Video":
    {
        "Codec": "H.264",
        "Profile": "High",
        "Bitrate": "1800",
        "Width": "1280",
        "Height": "720",
        "Fps": "26",
        "Gop": "60"
    },
    "Audio":
    {
        "Codec": "AAC",
        "Samplerate": "44100",
        "Channels": "2",
        "Bitrate": "128"
    },
    "Enable": true
}
查询单个自定义转码模板
【功能】
根据模板id查询单个转码模板详细信息接口。
【http方法】
使用GET方法。
【请求URL】
http://transcoder5.dwion.com/dniontranscode/v1/template/{id}
【返回参数说明】
名称 类型 描述
Template Dict 模板详情
【返回JSON示例】
{
    "Template": {
            "Enable": true,
            "Container": "MP4",
            "Name": "MP4-LD",
            "Video": {
                "Profile": "High",
                "Height": "360",
                "Width": "640",
                "Codec": "H.264",
                "Crf": "",
                "Fps": "26",
                "Bitrate": "400",
                "Gop": "60"
            },
            "Audio": {
                "Channels": "2",
                "Samplerate": "44100",
                "Codec": "AAC",
                "Bitrate": "64"
            },
            "Id": 5
        }
}
查询所有自定义转码模板
【功能】
查询转码模板接口,可根据可用不可用条件查询,支持根据转码模板名字模糊筛查,支持分页。
【http方法】
使用GET方法。
【请求URL】
http://transcoder5.dwion.com/dniontranscode/v1/template?Page=&Limit=&Enable=&Name=
【请求参数说明】
名称 类型 是否必填 描述
Page String 页数
Limit String 每页显示记录条数
Enable String 模板状态,true表示只查询可用模板,不加此参数表示查询出所有的模板
Name String 模板名字,模糊筛查字段
【返回JSON示例】
{
    "TemplateList": [
        {
            "Enable": true,
            "Container": "MP4",
            "Name": "MP4-HD",
            "Video": {
                "Profile": "High",
                "Height": "720",
                "Width": "1280",
                "Codec": "H.264",
                "Crf": "",
                "Fps": "26",
                "Bitrate": "1800",
                "Gop": "60"
            },
            "Audio": {
                "Channels": "2",
                "Samplerate": "44100",
                "Codec": "AAC",
                "Bitrate": "128"
            },
            "Id": 4
        },
  		{
            "Enable": true,
            "Container": "MP4",
            "Name": "MP4-LD",
            "Video": {
                "Profile": "High",
                "Height": "360",
                "Width": "640",
                "Codec": "H.264",
                "Crf": "",
                "Fps": "26",
                "Bitrate": "400",
                "Gop": "60"
            },
            "Audio": {
                "Channels": "2",
                "Samplerate": "44100",
                "Codec": "AAC",
                "Bitrate": "64"
            },
            "Id": 5
        }
],
"Total":2
}
删除自定义转码模板
【功能】
删除模板接口,软删除,任何时候都可以删除。
【http方法】
使用ELETE方法。
【请求URL】
http://transcoder5.dwion.com/dniontranscode/v1/template/{id}
【请求参数说明】
名称 类型 是否必填 描述
Id Int 模板ID

转码作业接口

提交转码作业
【功能】
提交转码作业,一个转码模板对应一个转码作业。执行完成后需要调用“查询转码作业”接口查询执行结果,也可使用回调通知机制获取执行结果。
【http方法】
使用POST方法。
【请求URL】
http://transcoder5.dwion.com/dniontranscode/v1/task
【请求参数说明】
名称 类型 必填项 描述
Input Dict 作业输入,见附录参数Input详情。例如:
{
"Server":"127.0.0.1",
"Port":6081,
"Bucket":"example-bucket",
"Object":"test/test.flv",
"Area":"huadong"
}
Outputs List Outputs由Output列表构成,JSON数组,见附录参数Outputs详情。例如:
[{
"AccDomain":"dnion.cdn.com",
"Bucket":"example-bucket",
"Object":"test/test-hd.mp4",
"TemplateId":1,
"SnapshotTemplateId":5,
"WatermarkTemplateId":2
}]
Callback Dict 回调地址,回调详细信息见附录Callback详情。
【请求示例】
{
    "Input":
    {
        "Server": "127.0.0.1",
        "Port": 6081,
        "Bucket": "example-bucket",
        "Object": "test/test.flv",
        /*具体地区信息需咨询技术对接人*/
        "Area": "huadong" 
    },
    "Outputs": [
    {
        "AccDomain": "dnion.cdn.com",
        "Bucket": "example-bucket",
        "Object": "test/test-hd.mp4",
        "TemplateId": 4,
        "SnapshotTemplateId": 1,
        "WaterMarkTemplateId": 2
    }],
    "CallbackUrl": "http://dnion.cdn.com/callback/api"
}
【返回示例】
{
    "TaskList": [
    {
        "TaskId": 111,
        "TemplateId": 4,
        "WaterMarkTemplateId": 2,
        "SnapshotTemplateId": 1
    }],
    "FileId": 108
}
【返回参数说明】
名称 类型 描述
TaskList List 作业列表
FileId Int 输入文件id
开启或取消转码作业
【功能】
开启:作业状态从“已取消”变为“已提交”,
取消:作业状态从“已提交”变为“已取消”。
【http方法】
使用PUT方法。
【请求URL】
http://transcoder5.dwion.com/dniontranscode/v1/task
【请求参数说明】
名称 类型 必填项 描述
Id Int 作业id
State String 开启:State=Submit,
取消:State=Cancel

【请求示例】
{
"Id":1,
"State":"Cancel"
}
查询单个转码作业
【功能】
根据InputfileId查询转码结果。
【http方法】
使用GET方法。
【请求URL】
http://transcoder5.dwion.com/dniontranscode/v1/task/{id}
【返回示例】
{
    "Input":
    {
        "Id": 1,
        "Container": "FLV",
        "Object": "test/test.flv",
        "Bucket": "example-bucket",
        "Length": "367892",
        "Size": "696869"
    },
    "TaskList": [
    {
        "Object": "test/test-hd.mp4",
        "Bucket": "example-bucket",
        "State": "Success",
        "ErrInfo": "",
        "Id": 111,
        "TemplateId": 1,
        "SnapshotTemplateId": 2,
        "WaterMarkTemplateId": 3,
        "Length": "367892",
        "StartTime": "2017-06-15 18:31:00",
        "EndTime": "2017-06-15 18:32:05",
        "CreateTime": "2017-06-15 18:29:59",
        "Size": "895889",
        "AccDomain": "xiaomi.vod.com",
        "FileUrl": "http://xiaomi.vod.com/test/test-hd.mp4",
        "SnapshotUrl": ["http://xiaomi.vod.com/test/test-hd_ss10.jpg",
            " http://xiaomi.vod.com/test/test-hd_ss20.jpg"
        ]
    }]
}
【返回参数说明】
名称 类型 描述
Input Dict 输入文件
TaskList List 作业列表
查询所有转码作业
【功能】
批量查询转码作业,可根据时间段、任务状态、域名条件查询,返回默认按CeateTime降序排列,支持根据bucket和object模糊筛选,支持分页。
【http方法】
使用GET方法。
【请求URL】
http://transcoder5.dwion.com/dniontranscode/v1/task?Page=&Limit=&State=&Start=&End=&Domain=& Bucket=&Object=
【请求参数说明】
名称 类型 必填项 描述
State String 转码作业状态,Submit表示作业已提交,Scheduling表示队列中,Transcoding表示转码中,Success表示转码成功,Failed表示转码失败,Cancel表示转码取消,不选State会列出所有状态的作业。
Start String 创建转码作业时间范围中的下限值,日期格式按照ISO8601标准表示,并需要使用UTC时间。格式为:YYYY-MM-DDThh:mm:ssZ 例如,2014-01-10T12:00:00Z(为北京时间2014年1月10日20点0分0秒)。
End String 创建转码作业时间的上限,日期格式按照ISO8601标准表示,并需要使用UTC时间。格式为:YYYY-MM-DDThh:mm:ssZ 例如,2014-01-11T12:00:00Z(为北京时间2014年1月11日20点0分0秒)。
Area String huadong
Limit String 每页显示记录条数
Page Int 页数
Domain String 加速域名
Bucket String 输入object所在的bucket
Object String 输入的object
【返回JSON示例】
{
    "FileList": [
    {
        "Input":
        {
            "Id": 1,
            "Container": "FLV",
            "Object": "test/test.flv",
            "Bucket": "example-bucket",
            "Length": "367892",
            "Size": "696869"
        },
        "TaskList": [
        {
            "Object": "test/test-hd.mp4",
            "Bucket": "example-bucket",
            "State": "Success",
            "ErrInfo": "",
            "Id": 111,
            "TemplateId": 1,
            "SnapshotTemplateId": 2,
            "WaterMarkTemplateId": 3,
            "Length": "367892",
            "StartTime": "2017-06-15 18:31:00",
            "EndTime": "2017-06-15 18:32:05",
            "CreateTime": "2017-06-15 18:29:59",
            "Size": "895889",
            "AccDomain": "xiaomi.vod.com",
            "FileUrl": "http://xiaomi.vod.com/test/test-hd.mp4",
            "SnapshotUrl": ["http://xiaomi.vod.com/test/test-hd_ss10.jpg",
                " http://xiaomi.vod.com/test/test-hd_ss20.jpg"
            ]
        }]
    }],
    "Total": 1
}
【返回参数说明】
名称 类型 描述
FileList List 转码作业列表
Total Int 匹配条件的记录总数
删除转码作业
【功能】
删除某个转码作业,只能在作业处于“提交”、“取消”、“失败”的状态才能删除,不可恢复。
【http方法】
使用DELETE方法。
【请求URL】
http://transcoder5.dwion.com/dniontranscode/v1/task/{id}

水印模板接口

新增水印模板
【功能】
创建水印模板。
【http方法】
使用POST方法。
【请求URL】
http://transcoder5.dwion.com/dniontranscode/v1/wmtemplate
【请求参数说明】
名称 类型 是否必填 描述
Name String 水印模板名称,最大128字节
Pic List 图片类型水印模板配置,JSON对象,见附录转码水印详情,例如:
[{
"Width":100,
"InputBucket":"ccccc",
"Height":100,
"Dx":10,
"Dy":10,
"InputObject":"cdcdcdc",
"Area":"huadong",
"Pos":1,
"Start":10,
"Duration":"ToEnd"}
}]
Text List 文字类型水印模板配置,JSON对象,见附录转码水印详情例如:
[{
"FontSize":20,
"Dy":10,
"Dx":10,
"FontColor":"white",
"FontAlpha":"0xff",
"Text":"不好",
"Font":"宋体",
"Pos":2,
"Start":5,
"Duration":"10"
}]
【请求示例】
{
  "Name":"DNION-TEST-PIC-TEXT-WATERMARK-2",
  "Pic":[
   {
        "InputBucket":"examplebucket",
		"Area":"huadong",
        "InputObject":"test/logo.png",
        "Width":92,
        "Height":62,
        "Dx":10,
        "Dy":10,
        "Pos":1,
        "Start":5,
        "Duration":"ToEnd"
  }
],
  "Text":[
  {
        "Text":"汉字",
        "Font":"宋体",
        "FontColor":"black",
        "FontSize":20,
        "Dx":10,
        "Dy":10,
        "Pos":2,
        "Start":5,
        "Duration":"20"
  }
  ]
 }
【返回示例】
{
"Id":1,
"Enable":True
}
【返回参数说明】
名称 类型 描述
Id Int 模板ID
Enable bool 模板状态,Enable=True开启,Enable=False停用

更新水印模板
【功能】
更新水印模板。
【http方法】
使用PUT方法。
【请求URL】
http://transcoder5.dwion.com/dniontranscode/v1/wmtemplate
【请求参数说明】
名称 类型 是否必填 描述
Id Int 模板id
Name String 水印模板名称,最大128字节
Pic List 图片类型水印模板配置,JSON对象,见附录转码水印详情,例如:
[{
"Width":100,
"Area":"huadong",
"InputBucket":"ccccc",
"Height":100,
"Dx":10,
"Dy":10,
"InputObject":"cdcdcdc",
"Pos":1,
"Start":10,
"Duration":"ToEnd"}
}]
Text List 文字类型水印模板配置,JSON对象,见附录转码水印详情例如:
[{
"FontSize":20,
"Dy":10,
"Dx":10,
"FontColor":"white",
"Text":"不好",
"Font":"宋体",
"Pos":2,
"Start":5,
"Duration":"10"
}]
Enable Bool true为启用,false为停用,默认true
【请求示例】
{
	"Id":4,
"Name":"DNION-TEST-PIC-TEXT-WATERMARK-2",
  		"Pic":[
   				{
				 "Area":"huadong",
       			 "InputBucket":"examplebucket",
       			 "InputObject":"test/logo.png",
       			 "Width":92,
       			 "Height":62,
       			 "Dx":10,
       			 "Dy":10,
       			 "Pos":1,
       			 "Start":5,
        		"Duration":"ToEnd"
  			}
],
 		 "Text":[
 				 {
       				 "Text":"汉字",
      				  "Font":"宋体",
       				 "FontColor":"black",
      				  "FontSize":20,
       				 "Dx":10,
       				 "Dy":10,
       				 "Pos":2,
      				  "Start":5,
      				  "Duration":"20"
  				}
  				]
	"Enable":true
}
查询单个水印模板
【功能】
根据id查询指定水印模板详情接口。
【http方法】
使用GET方法。
【请求URL】
http://transcoder5.dwion.com/dniontranscode/v1/wmtemplate/{id}
【请求示例】
{
    "WmTemplate":
    {
        "Texts": [
        {
            "Text": "汉字",
            "Font": "宋体",
            "FontColor": "black",
            "FontSize": 20,
            "Dx": 10,
            "Dy": 10,
            "Pos": 2,
            "Start": 5,
            "Duration": "20"
        }],
        "Pics": [
        {
            "Area": "huadong",
            "InputBucket": "examplebucket",
            "InputObject": "test/logo.png",
            "Width": 92,
            "Height": 62,
            "Dx": 10,
            "Dy": 10,
            "Pos": 1,
            "Start": 5,
            "Duration": "ToEnd"
        }],
        "Enable": true,
        "Id": 6,
        "Name": "zfd_test"
    }
}
【返回参数说明】
名称 类型 描述
WmTemplate Dict 水印模板详情
查询所有水印模板
【功能】
查询水印模板接口,可根据可用不可用条件查询,支持根据模板名字模糊筛选,支持分页。
【http方法】
使用GET方法。
【请求URL】
http://transcoder5.dwion.com/dniontranscode/v1/wmtemplate?Page=&Limit=&Enable=&Name=
【请求参数说明】
名称 类型 是否必填 描述
Page String 页数
Limit String 每页显示记录条数
Enable String 模板状态,true表示只查询可用模版,不加此参数表示查询出所有的模板
Name String 模板名字,模糊筛选字段
【请求示例】
{
"WmTemplateList": [
{
"Texts": [
{
        "Text":"汉字",
        "Font":"宋体",
        "FontColor":"black",
        "FontSize":20,
        "Dx":10,
        "Dy":10,
        "Pos":2,
        "Start":5,
        "Duration":"20"
  }
],
"Pics": [
{
		"Area":"huadong",
        "InputBucket":"examplebucket",
        "InputObject":"test/logo.png",
        "Width":92,
        "Height":62,
        "Dx":10,
        "Dy":10,
        "Pos":1,
        "Start":5,
        "Duration":"ToEnd"
  }
],
"Enable": true,
"Id": 6,
"Name": "zfd_test"
}
}],
"Total":1
}
【返回参数说明】
名称 类型 描述
WmTemplateList List 水印模板列表
Total Int 匹配条件的模板总数

删除水印模板
【功能】
删除水印模板接口,如果有状态为“已提交”的作业在使用该水印模板,则相应的水印模板不能被删除。
【http方法】
使用DELETE方法。
【请求URL】
http://transcoder5.dwion.com/dniontranscode/v1/wmtemplate/{Id}
【请求参数说明】
名称 类型 是否必填 描述
Id String 水印模板Id

截图模板接口

新增截图模板
【功能】
新增截图模板接口,目前支持生成jpg格式图片。
时间点截图模式,如:指定视频的第2秒和第5秒各截一张图。
张数截图模式,如:视频时长67秒,指定从第7秒开始每隔10秒截一张图,张数为5张,则截图效果为在17秒、27秒、37秒、47秒、57秒各截一张图,共5张图。
【http方法】
使用POST方法。
【请求URL】
http://transcoder5.dwion.com/dniontranscode/v1/sstemplate
【请求参数说明】
名称 类型 是否必填 描述
Name String 截图模板名称,最大128字节
PicType String 截图图片格式,目前只支持JPG格式
Times String 截图时间点,逗号隔开,如 "20,30,50"
Starttime String 开始截图时间,单位/秒
Num String 截图张数
Interval String 截图时间间隔,单位/秒
Width String 截图图片宽,单位像素
Height String 截图图片高,单位像素

【请求示例】
{
  "Name":"DNION-TEST-NUM-640-360",
  "PicType":"JPG",
  "Num":"5",
  "Starttime":"10",
  "Interval":"5",
  "Width":"640",
  "Height":"360"
}
【返回示例】
{
"Id":1,
"Enable":True
}
【返回参数说明】
名称 类型 描述
Id Int 截图模板ID
Enable Bool 截图模板状态,Enable=True开启,Enable=False取消

更新截图模板
【功能】
更新截图模板。
【http方法】
使用PUT方法。
【请求URL】
http://transcoder5.dwion.com/dniontranscode/v1/sstemplate
【请求参数说明】
名称 类型 是否必填 描述
Id Int 截图模板Id
Name String 截图模板名称,最大128字节
PicType String 截图图片格式,目前只支持JPG格式
Times String 截图时间点,逗号隔开,如 "20,30,50"
Starttime String 开始截图时间,单位/秒
Num String 截图张数
Interval String 截图时间间隔,单位/秒
Width String 截图图片宽,单位像素
Height String 截图图片高,单位像素
Enable Bool false为停用,true表示启用,默认true

【请求示例】
{
"Id":3,
"Name":"DNION-TEST-NUM-640-360",
"PicType":"JPG",
"Num":"5",
"Starttime":"10",
"Interval":"5",
"Width":"640",
"Height":"360",
"Enable":false
}
查询单个截图模板
【功能】
根据id查询指定截图模板详情接口。
【http方法】
使用GET方法。
【请求URL】
http://transcoder5.dwion.com/dniontranscode/v1/sstemplate/{id}
【返回示例】
{
"SsTemplate":{
  "Name":"DNION-TEST-NUM-640-360",
  "PicType":"JPG",
  "Num":"5",
  "Starttime":"10",
  "Interval":"5",
  "Width":"640",
  "Height":"360",
  "Enable": true,
  "Id": 6,
}
}
【返回参数说明】
名称 类型 描述
SsTemplate Dict 截图模板详情

查询所有截图模板
【功能】
查询截图模板接口,可根据可用不可用条件查询,支持根据模板名字模糊筛选,支持分页。
【http方法】
使用GET方法。
【请求URL】
http://transcoder5.dwion.com/dniontranscode/v1/sstemplate?Page=&Limit=&Enable=&Name=
【请求参数说明】
名称 类型 是否必填 描述
Page String 页数
Limit String 每页显示记录条数
Enable String 模版状态,true表示只查询可用模版,不加此参数表示查询出所有的模版
Name String 模板名字,模糊筛选字段

【返回示例】
{
    "SsTemplateList": [
    {
        "Name": "DNION-TEST-NUM-640-360",
        "PicType": "JPG",
        "Num": "5",
        "Starttime": "10",
        "Interval": "5",
        "Width": "640",
        "Height": "360",
        "Enable": true,
        "Id": 6,
    }],
    "Total": 1
}
【返回参数说明】
名称 类型 描述
SsTemplateList List 截图模板列表

删除截图模板
【功能】
删除截图模板。
【http方法】
使用DELETE方法。
【请求URL】
http://transcoder5.dwion.com/dniontranscode/v1/sstemplate/{Id}
【请求参数说明】
名称 类型 是否必填 描述
Id String 截图模板Id

附录

转码信息详情
【Container详情】
名称 类型 必填项 描述
Container String 容器格式,目前视频转码支持输出格式有FLV、MP4、TS、M3U8;音频转码支持输出格式有MP3。
【Video详情】
名称 类型 必填项 描述
Codec String 编解码格式,目前只支持H.264,默认H.264
Profile String 编码级别,支持Baseline、Main、High、默认High,
Baseline:适合移动设备,
Main:适合标准分辨率设备,
High:适合高分辨率设备。
目前仅H.264支持此参数
Bitrate String 视频输出文件的码率,单位Kbps
Width String 宽,默认值视频原始宽,单位px
Height String 高,默认值是视频原始高,单位px
Fps String 帧率,默认值取输入文件帧率,,单位fps
Gop String 关键帧间最大帧数
以下表格显示视频转码编解码格式与容器格式的组合支持情况:
Container Audio Codecs Video Codecs
FLV AAC、MP3 H.264
MP4 AAC、MP3 H.264
TS AAC、MP3 H.264
M3u8 AAC、MP3 H.264
【Audio详情】
名称 类型 必填项 描述
Codec String 音频编解码格式,AAC、MP3,默认AAC
Samplerate String 采样率,默认值44100,支持22050、32000、44100、48000、96000,单位Hz。
若视频容器格式为FLV,音频编码格式选择MP3时,采样率不支持32000、48000、96000;
音频编码格式为MP3时,采样率不支持96000
Bitrate String 输出文件的音频码率,单位Kbps
Channels String 音频声道数
以下表格显示音频转码编解码格式与容器格式的组合支持情况:
Container Audio Codecs
MP3 MP3
【Segment详情】
名称 类型 必填项 描述
Segment String 分片时长,整数值,单位秒
【Font详情】
名称 类型 必填项 描述
Font String 字体,如宋体,楷体
FontColor String 字体颜色,如black,white,见附录Color详情
【Conflict详情】
名称 类型 必填项 描述
Key1 String 例子:{"key2": "Video=False",
      "key1": "Container=MP3"}
表示Container为MP3时,Video参数不允许出现在post body
Key2 String
【Input详情】
名称 类型 必填项 描述
Server String Ceph存储服务器,ip或域名
huadong:api.js.dstor.dwion.com
huadong2:api.upyun.weiyuan.dwion.com
huanan:api.gdbak.dstor.dnion.com
Port Int 6081:Ceph存储服务端口
Bucket String 输入文件所用Bucket,遵守Bucket定义规则
Object String 输入文件,遵守Object定义规则
Area String huadong:华东
huadong2:华东2
huanan:华南
【Outputs详情】
名称 类型 描述
AccDomain String 用户加速域名
Bucket String 输出文件所用Bucket,遵守Bucket定义规则
Object String 输出文件,遵守Object定义规则 
TemplateId Int 转码模板id 
SnapshotTemplateId Int 截图模板id
WaterMarkTemplateId Int 水印模板id
【Callback详情】
名称 类型 描述
File Dict 文件信息, 包括时长(单位/s),大小(单位/Bit),码率(单位/Kbps),访问地址,截图地址
Audio Dict 文件音频信息,包括码率(单位/Kbps),声道数,编码格式,采样率(单位/Hz)
Video Dict 文件视频信息,包括码率(单位/Kbps),分辨率,帧率(单位fps),编码格式,显示纵横比
TaskId Int 任务Id
State String 任务状态
TemplateId Int 转码模版Id
WatermarkTemplateId Int 水印模版Id
SnapshotTemplateId Int 截图模版Id

【转码信息返回示例】
{
    "Input":
    {
        "Audio":
        {
            "Bitrate": "80",
            "Channels": 2,
            "Codec": "aac",
            "Samplerate": "44100"
        },
        "Video":
        {
            "Aspect": "16:9",
            "Bitrate": "633",
            "Codec": "h264",
            "Framerate": "25",
            "Resolution": "854*480"
        },
        "File":
        {
            "Duration": "84.800000",
            "Size": "7651027",
            "TotalRate": "721"
        }
    },
    "TaskId": 111,
    "Output":
    {
        "Audio":
        {
            "Bitrate": "80",
            "Channels": 2,
            "Codec": "aac",
            "Samplerate": "44100"
        },
        "Video":
        {
            "Aspect": "16:9",
            "Bitrate": "633",
            "Codec": "h264",
            "Framerate": "25",
            "Resolution": "854*480"
        },
        "File":
        {
            "Duration": "84.800000",
            "Size": "7651027",
            "SnapshotUrl": [
                "http://dnion.cdn.com/test.jpg"
            ],
            "TotalRate": "721",
            "Url": "http://dnion.cdn.com/test.mp4"
        },
        "State": "Success",
        "TemplateId": 1,
        "WatermarkTemplateId": 1,
        "SnapshotTemplateId": 1
    }
}
转码水印参数详情
【公共参数】
名称 类型 必填项 描述
Width Int 若设置,则此值覆盖水印模板对应水印图片宽,单位px。
Height Int 若设置,则此值覆盖水印模板对应水印图片高,单位px。 
Dx Int 水印图片相对参考点的水平偏移量,默认值是10,单位px。
Dy Int 水印图片相对参考点的垂直偏移量,默认值是10,单位px。
Pos Int 水印的位置,默认1:TopLeft
1:TopLeft, 2:TopRight
3:BottomLeft, 4:BottomRight
Start Int 水印开始显示时间,单位/s,默认0
Duration String 水印持续显示时间,单位/s,默认ToEnd
【文字水印】
名称 类型 必填项 描述
Text String 文字内容
Font String 字体,如:宋体,默认宋体
FontColor String 字体颜色,有效值为已支持的颜色名(大小写不敏感)如:black,或RGB值([0x|#]RRGGBB), 如0xF0F8FF, 默认black(0x000000), 支持的颜色名见附录Color详情
FontAlpha String 字体透明度,取值范围0x00~0xff或0.0~1.0,数值大小与透明度成反比
FontSize Int 字体大小

【图片水印】
名称 类型 必填项 描述
InputBucket String 图片文件所在bucket
InputObject String 图片文件object,目前只支持png格式图片
Area String 存储区域,如huadong、huanan等

格式支持详情
【输入格式】
容器格式
3GP、AVI、FLV、MP4、M3U8、MPG、ASF、WMV、MKV、MOV、TS、WebM等

视频编码格式
H.264/AVC、H.263、 H.263+、MPEG-1、MPEG-2、MPEG-4、MJPEG、VP8、VP9、Quicktime、 RealVideo、Windows Media Video等

音频编码格式
AAC、AC-3、ADPCM、AMR、DSD、MP1、MP2、MP3、PCM、RealAudio、Windows Media Audio
【输出格式】
容器格式
FLV、MP4、M3U8(TS),MP3

视频编码格式
H.264、H.265

音频编码格式
AAC、MP3