快速入门
又拍云处理(异步音视频处理)基于云存储服务,您在使用它之前,请确保您已经注册又拍云账号并完成实名验证,请确保您已经创建云存储服务。
收费方面,见价格。
开发者指南
提交处理任务
请求方法
对已经存在云存储中的音视频文件,以 POST
方法向 http://p0.api.upyun.com/pretreatment/
提交处理任务,响应中返回任务 task_id
。任务以异步的方式处理,处理完成后,回调通知用户处理结果。
curl -X POST \
http://p0.api.upyun.com/pretreatment/ \
-H "Authorization: UPYUN <Operator>:<Signature>" \
-H "Date: <Wed, 29 Oct 2014 02:26:58 GMT>" \
-H "Content-MD5: <Content-MD5>" \
-d "accept=json"
-d "service=<service>" \
-d "notify_url=<notify_url>" \
-d "source=<音视频文件相对路径>" \
-d "tasks=<base64 编码后的任务字符串>" \
认证鉴权
Authorization
详见签名认证。
请求参数
参数 | 类型 | 必选 | 说明 |
---|---|---|---|
service | string | 是 | 音/视频文件所在的服务名 |
notify_url | string | 是 | 回调通知地址,详见回调通知 |
source | string | 是 | 原始音/视频文件路径 |
tasks | string | 是 | 任务信息,详见 tasks 参数说明 |
accept | string | 是 | 回调信息的格式,值为json |
1. 按 JSON 格式组装任务,一次请求 tasks
最多可以提交 10 个任务。任务参数见功能。
[
{
"type": "video", // 视频转码
"avopts": "/s/240p(4:3)/as/1/r/30", // 参数
"return_info": true, // 返回元数据
"save_as": "/a/b.mp4" // 保存路径
},
{
"type": "video", // 视频拼接
"avopts": "/i/L2EvYi9jLm1wNA==/i/LzEvMi8zLm1wNA==", // 参数
"save_as": "/concat/a.mp4" // 保存路径
},
…
]
2. 把 JSON 字符串 Base64 编码,得到 tasks
。
W3siYXZvcHRzIjoiL3MvMjQwcCg0OjMpL2FzLzEvci8zMCIsInJldHVybl9pbmZvIjp0cnVlLCJzYXZlX2FzIjoiL2EvYi5tcDQiLCJ0eXBlIjoidmlkZW8ifSx7ImF2b3B0cyI6Ii9pL0wyRXZZaTlqTG0xd05BPT0vaS9MekV2TWk4ekxtMXdOQT09Iiwic2F2ZV9hcyI6Ii9jb25jYXQvYS5tcDQiLCJ0eXBlIjoidmNvbmNhdCJ9XQ==
响应信息
-
任务提交成功:返回
200
,响应体是一组按任务提交先后顺序排序的task_id
。例如:[ "35f0148d414a688a275bf915ba7cebb2", "98adbaa52b2f63d6d7f327a0ff223348", "c3103189fa906a5354d29bd807e8dc51", … ]
-
任务提交失败:返回相应的出错信息,具体请参阅「状态码表」。
回调通知
任务处理完成后,向 notify_url
发送 HTTP POST
请求,请求体是回调信息。
curl -X POST \
<notify_url> \
-H "Authorization: UPYUN <Operator>:<Signature>" \
-H "Date: <Wed, 29 Oct 2014 02:26:58 GMT>" \
-H "Content-MD5: <Content-MD5>" \
-d "service=<service>" \
# 其他参数...
回调信息
回调信息是 JSON 字符串,参数名及说明如下:
参数 | 类型 | 说明 |
---|---|---|
service 或 bucket_name | string | 音/视频文件所在的服务名 |
status_code | integer | 处理结果状态码,200 表示成功处理,详见状态码表 |
path | array | 输出文件保存路径 |
description | string | 处理结果描述 |
task_id | string | 任务对应的 task_id |
info | json | 输出文件的元数据,仅当 return_info 为 true 时,有效 |
signature(旧) | string | 回调通知的签名,回调签名(旧)的参数 |
timestamp(旧) | integer | 服务端发送回调时的时间戳,回调签名(旧)的参数 |
回调签名
Authorization
详见签名认证,它提供给客户端,用于验证回调通知的合法性。
上传预处理
在上传音视频文件时,对上传的音视频进行处理,生成一个或多个新的文件,同时保存上传的音视频到又拍云存储。任务以异步的方式处理,处理完成后,回调通知用户处理结果。
支持的 API: FORM API。
参数名是 apps
,参数值是 JSON 数组。一个 apps
最多允许包含 10 个音视频处理任务。任务参数见功能。
举例
apps = [
{ // 异步音视频处理任务
"name": "naga", // 异步任务名称,必填。naga 表示异步音视频处理服务
"type": "<type>", // 功能标识,必填
"avopts": "<avopts>", // 处理参数,必填
"return_info": true/false, // 是否返回元数据,选填
"save_as": "<save_as>", // 结果音频/视频保存路径,选填
"notify_url": "<notify_url>" // 回调地址,不填时使用上传参数中的 notify-url
},
{
"name": "naga",
"type": "video",
"avopts": "/s/240p(4:3)/as/1/r/30",
"return_info": true,
"save_as": "/a/b.mp4",
},
......
]
回调通知
任务处理完成后,向 notify_url
地址发送回调通知。详见 「音视频处理」 > 「回调通知」。
进度查询
请求方法
通过 task_id
,以 GET
方法向 http://p0.api.upyun.com/status/
提交进度查询任务。
curl http://p0.api.upyun.com/status?service=<service>&task_ids=<task_id1>,<task_id2>,<task_id3> \
-H "Authorization: UPYUN <Operator>:<Signature>" \
-H "Date: <Wed, 29 Oct 2014 02:26:58 GMT>"
认证鉴权
Authorization
详见签名认证。代码实现
详见代码示例。
查询参数
参数 | 类型 | 必选 | 说明 |
---|---|---|---|
service | string | 是 | 音/视频文件所在的服务名 |
task_ids | string | 是 | 任务集,多个 task_id 使用 , 连接,最多 20 个 task_id |
响应信息
-
查询成功:返回
200
,响应体是tasks
。tasks
是 JSON 格式,存放各个任务(task_id
)的进度。例如:{ "tasks": { "35f0148d414a688a275bf915ba7cebb2": 100, "98adbaa52b2f63d6d7f327a0ff223348": 20, "c3103189fa906a5354d29bd807e8dc51": null, … } }
20
表示任务进度百分比,100
表示任务处理完成,-1
表示任务处理失败,null
表示任务尚未开始。如果长时间是 null
,请反馈给售后或您的商务经理。
- 查询失败:返回相应的出错信息,具体请参阅「状态码表」。
结果查询
请求方法
通过 task_id
,以 GET
方法向 http://p0.api.upyun.com/result/
提交处理结果查询任务。
curl http://p0.api.upyun.com/result?service=<service>&task_ids=<task_id1>,<task_id2>,<task_id3> \
-H "Authorization: UPYUN <Operator>:<Signature>" \
-H "Date: <Wed, 29 Oct 2014 02:26:58 GMT>"
认证鉴权
Authorization
详见签名认证。代码实现
详见代码示例。
查询参数
参数 | 类型 | 必选 | 说明 |
---|---|---|---|
service | string | 是 | 音/视频文件所在的服务名 |
task_ids | string | 是 | 任务集,多个 task_id 使用 , 连接,最多 20 个 task_id |
响应信息
-
查询成功:返回
200
,响应体是任务的回调信息。回调信息例如:{ "9d9c32b63a1034834e77672c6f51f661": { "path": ["/v2.mp4"], "signature": "4042c1f07f546d28", "status_code": 200, "service": "service", "description": "OK", "task_id": "9d9c32b63a1034834e77672c6f51f661", "timestamp": 1472010905 }, "3438a54b4991e8d4a46a003bc15e9867": { "path": ["/v2.mp4"], "signature": "1c49be9b672394ff", "status_code": 200, "service": "service", "description": "OK", "task_id": "3438a54b4991e8d4a46a003bc15e9867", "timestamp": 1472010684 } … }
-
查询失败:返回相应的出错信息,具体请参阅「状态码表」。
状态码表
状态码 | 说明 |
---|---|
200 | 处理成功 |
400 | 参数错误 |
401 | 参数错误 |
404 | 文件不存在 |
5xx | 服务端错误。如遇此类错误,请反馈给售后或您的商务经理 |
支持格式
类型 | 输入格式 | 输出格式 |
---|---|---|
视频容器格式 | AVI、MP4、FLV、MOV、3GP、ASF、WMV、M3U8(TS)、MPG、F4V、M4V、MKV、VOB(SVCD/DVD)等 | MP4、FLV、M3U8(TS) 等 |
音频容器格式 | MP3、OGG、M4A、SILK 等 | MP4、MP3、OGG 等 |
视频编码格式 | H.264/AVC 、H.263、H.263+、MPEG-2、MPEG-4、VP8、VP9、Quicktime、RealVideo、Windows Media Video 等 | H.264/AVC、VP8、H.265/HEVC、VP9 等 |
音频编码格式 | MP1、MP2、MP3、AAC、AC-3、Vorbis、PCM、RealAudio、Windows Media Audio 等 | AAC、MP3 等 |
预置模板
同等清晰度下,建议优先使用 16:9 的宽高比。特别地,窄带高清也可以使用。
清晰度 | 模板名 | 分辨率 | 码率 |
---|---|---|---|
4K | 2160p(16:9) | 3840×2160,16:9 | ≤ 8000Kbps |
2K | 1440p(16:9) | 2560×1440,16:9 | ≤ 4000Kbps |
FHD/全高清 | 1080p(16:9) | 1920×1080,16:9 | ≤ 2560Kbps |
HD/高清 | 720p(16:9) | 1280×720,16:9 | ≤ 1500Kbps |
HD/高清 | 720p(4:3) | 960×720,4:3 | ≤ 1500Kbps |
LD/标清 | 540p(16:9) | 960×540,16:9 | ≤ 800Kbps |
LD/标清 | 480p(16:9) | 854×480,16:9 | ≤ 800Kbps |
SD/流畅 | 480p(4:3) | 640×480,4:3 | ≤ 500Kbps |
SD/流畅 | 360p(16:9) | 640×360,16:9 | ≤ 500Kbps |
SD/流畅 | 240p(4:3) | 320×240,4:3 | ≤ 300Kbps |
视频转码
参数 | 类型 | 必选 | 说明 |
---|---|---|---|
type |
string | 是 | 固定值,video ,表示标准转码 |
avopts |
string | 是 | 视频转码参数,格式为 /key1/value1/key2/value2/... ,参数见「参数」 |
save_as |
string | 否 | 输出文件保存路径,默认使用原始视频所在目录+系统随机生成的文件名+原始视频后缀 |
return_info |
boolean | 否 | 回调信息是否包含输出文件的元数据,元数据格式为 JSON,默认 false |
注
save_as
的后缀名默认当作输出封装格式。格式除视频格式外,还支持 GIF/WebP,可以实现把视频转码成动态 GIF/动态 WebP。
常用参数
参数 | 类型 | 必选 | 说明 |
---|---|---|---|
/vb/<bitrate> |
integer | 否 | 视频比特率,单位 kbps,默认按照视频原始比特率处理 |
/s/<scale> |
string | 否 | 视频分辨率,默认按照原始分辨率处理。见「注」 |
/as/<auto_scale> |
boolean | 否 | 是否根据分辨率自动调整视频的比例,默认 false 。仅当传递了 s 参数时有效 |
/r/<frame_rate> |
integer | 否 | 视频帧率,默认按照原始帧率处理。推荐值:25 、30 |
/sp/<rotate> |
string | 否 | 旋转角度,默认按照原始视频角度处理。可选值:auto(自动扶正) 、 90 、 180 、 270 |
/sm/<map_metadata> |
boolean | 否 | 是否保留视频元数据,默认 true |
/acodec/<audio_codec> |
string | 否 | 设置音频编码器,默认按照音频原始编码器处理。可选值:libmp3lame 、 libfdk_aac 、 copy |
/vcodec/<video_codec> |
string | 否 | 设置视频编码器,可选值:libx264 、 libtheora 、 libx265 、 libvpx-vp9 、 libvpx 、 copy |
/an/<disable_audio> |
boolean | 否 | 是否禁掉音频,默认 false |
/vn/<disable_video> |
boolean | 否 | 是否禁掉视频,默认 false |
/su/<accelerate_factor> |
float | 否 | 视频加速倍数,默认 1.0 。取值范围 [1.0,10.0] |
/ar/<audio_sample_rate> |
integer | 否 | 音频采样率,单位 Hz,默认按照原始采样率处理。可选值:44100 、 48000 、 32000 、 22050 、 24000 、 16000 、 0 |
/ac/<audio_channel> |
float | 否 | 音频声道数,默认按照原始声道数处理。常用值:1 表示单声道(mono)、2 表示立体声(stereo)等 |
/sar/<sar> |
string | 否 | 采样长宽比,格式 w:h ,常用值 1:1 、 4:3 或 16:9 |
/dar/<dar> |
string | 否 | 显示长宽比,格式 w:h ,常用值 1:1 、 4:3 或 16:9 |
/pv/<pv> |
string | 否 | H264 Profile,常用值 baseline 、 main 、 high 等 |
/level/<level> |
float | 否 | H264 Level,常用值 3.0 、 3.1 、 4.0 、 4.1 、 4.2 等 |
/f/<format> |
string | 否 | 视频格式。当输出文件没有后缀时,需要指定,其余时候根据输出文件后缀名自动判定 |
注
s
参数有两种设置方法:1)使用预置模板,值是预置模板的模板名
,如720p(16:9)
;2)自定义,值是宽x高
,如1280x720
。
切片参数
参数 | 类型 | 必选 | 说明 |
---|---|---|---|
/ht/<hls_time> |
string | 否 | 每片时长,单位 s(秒),默认 10 |
注
- 使用
ht
参数时,save_as
参数必须以.m3u8
后缀结尾。
水印参数
参数 | 类型 | 必选 | 说明 |
---|---|---|---|
/wmImg/<watermark_img> |
string | 是 | 水印图片相对路径,需要安全的 Base64 编码。图片格式支持 png 和 webp |
/wmGravity/<wmGravity> |
string | 否 | 水印图片放置方位,默认 northeast 。见「注」 |
/wmDx/<watermark_dx> |
integer | 否 | 水印图片横偏移量,单位 px,当 wmGravity 为 northeast 时,默认 -20 。横偏移量取值正负的依据:往 east 方向偏移,为正;往 west 方向偏移,为负 |
/wmDy/<watermark_dy> |
integer | 否 | 水印图片纵偏移量,单位 px,当 wmGravity 为 northeast 时,默认 15 。纵偏移量取值正负的依据:往 south 方向偏移,为正;往 north 方向偏移,为负 |
注
- 9 个方位:
剪辑参数
参数 | 类型 | 必选 | 说明 |
---|---|---|---|
/ss/<start_time> |
string | 否 | 剪辑开始时间,格式为 HH:MM:SS ,默认视频开始时间 |
/es/<end_time> |
string | 否 | 剪辑结束时间,格式为 HH:MM:SS ,默认视频结束时间 |
动图参数
把 save_as
的后缀名指定为 gif
或 webp
,实现视频转码成动态图片。
参数 | 类型 | 必选 | 说明 |
---|---|---|---|
/cr/<concat_reverse> |
boolean | 否 | 向视频结尾处添加倒序的内容。功能效果是,正序内容+倒序内容 |
拼接参数
拼接的视频分辨率需要保持一致,拼接参数不能与其他参数混用。如果要混用,请分做两个任务,使用链式处理。
参数 | 类型 | 必选 | 说明 |
---|---|---|---|
/i/<video> |
string | 否 | 需要后置拼接视频文件的相对路径,需要安全的 Base64 编码。多个需要拼接视频按 /i/<video>/i/<video>/... 方式进行连接。见「注」 |
/h/<video> |
string | 否 | 需要前置拼接视频文件的相对路径,需要安全的 Base64 编码 。多个需要拼接视频按 /h/<video>/h/<video>/... 方式进行连接。见「注」 |
/codec/<codec> |
string | 否 | 设置视频编码器,默认不需要设置。可选值:copy 。见「注」 |
注
-
视频拼接顺序:待拼接视频按
h
出现顺序,依次拼接在原始视频(source
)前面;待拼接视频按i
出现顺序,依次拼接在原始视频(source
)后面。 -
如果
save_as
参数指定格式跟原始视频(source
)格式、拼接视频格式不一致,系统会自动转码原始视频、拼接视频成save_as
参数指定格式;如果save_as
参数未指定,拼接视频跟原始视频格式不一致,系统会自动转码拼接视频成原始视频格式。 -
如果拼接视频和原始视频的编码一致,可以设置
codec
参数为copy
,不对拼接视频进行编解码,提高拼接速度。
加密参数
参数 | 类型 | 必选 | 说明 |
---|---|---|---|
/encSch/cenc-aes-ctr |
string | 否 | 加密方案,固定值,cenc-aes-ctr ,使用加密时该参数需在最前面 |
/encKid/<hex> |
string | 否 | 加密密钥标识,32 位 hex 数据 |
/encKey/<hex> |
string | 否 | 加密密钥,解密需要,32 位 hex 数据 |
注
- 拼接方式:
/encSch/cenc-aes-ctr/encKey/密钥/encKid/密钥标识
- 目前只支持 MP4 视频加密
窄带高清
通过对视频的编码进行优化,平均降低视频大小 30%。
参数 | 类型 | 必选 | 说明 |
---|---|---|---|
type |
string | 是 | 固定值,nbhd ,表示窄带高清 |
avopts |
string | 是 | 视频转码参数,格式为 /key1/value1/key2/value2/... ,参数见「参数」 |
return_info |
boolean | 否 | 回调信息是否包含输出文件的元数据,元数据格式为 JSON,默认 false |
save_as |
string | 否 | 输出文件保存路径,默认原始视频所在目录+系统随机生成的文件名 |
常用参数
参数 | 类型 | 必选 | 说明 |
---|---|---|---|
/scene/<scene> |
string | 否 | 视频内容场景,默认 auto ,服务根据视频内容智能选择。场景参数见「注」 |
/s/<scale> |
string | 否 | 视频分辨率,默认按照原始分辨率处理。见「注」 |
/as/<auto_scale> |
boolean | 否 | 是否根据分辨率自动调整视频的比例,默认 false 。仅当传递了 s 参数时有效 |
/r/<frame_rate> |
integer | 否 | 视频帧率,默认按照原始帧率处理。推荐值:25 、 30 |
/sp/<rotate> |
string | 否 | 旋转角度,默认按照原始视频角度处理。可选值:auto(自动扶正) 、 90 、 180 、 270 |
/sm/<map_metadata> |
boolean | 否 | 是否保留视频元数据,默认 true |
/su/<accelerate_factor> |
float | 否 | 视频加速倍数,默认 1.0 。取值范围 [1.0,10.0] |
/ar/<audio_sample_rate> |
integer | 否 | 音频采样率,单位 Hz,默认按照原始采样率处理。可选值:44100 、 48000 、 32000 、 22050 、 24000 、 16000 、 0 |
/f/<format> |
string | 否 | 视频格式。当输出文件没有后缀时,需要指定,其余时候根据输出文件后缀名自动判定 |
注
-
scene
可选参数:auto
,表示智能选择;self_portrait
,表示自拍;animation
,表示动画;film_calm
,表示电视剧,包括综艺、访谈、在线教育等;film_dramatic
,表示电影。 -
s
参数有两种设置方法:1)使用预置模板,值是预置模板的模板名
,如720p(16:9)
;2)自定义,值是宽x高
,如1280x720
。
切片参数
参数 | 类型 | 必选 | 说明 |
---|---|---|---|
/ht/<hls_time> |
string | 否 | 每片时长,单位 s(秒),默认 10 |
注
- 使用
ht
参数时,save_as
参数必须以.m3u8
后缀结尾。
水印参数
参数 | 类型 | 必选 | 说明 |
---|---|---|---|
/wmImg/<watermark_img> |
string | 是 | 水印图片相对路径,需要安全的 Base64 编码。图片格式支持 png 和 webp |
/wmGravity/<wmGravity> |
string | 否 | 水印图片放置方位,默认 northeast 。见「注」 |
/wmDx/<watermark_dx> |
integer | 否 | 水印图片横偏移量,单位 px,当 wmGravity 为 northeast 时,默认 -20 。横偏移量取值正负的依据:往 east 方向偏移,为正;往 west 方向偏移,为负 |
/wmDy/<watermark_dy> |
integer | 否 | 水印图片纵偏移量,单位 px,当 wmGravity 为 northeast 时,默认 15 。纵偏移量取值正负的依据:往 south 方向偏移,为正;往 north 方向偏移,为负 |
注
- 9 个方位:
剪辑参数
参数 | 类型 | 必选 | 说明 |
---|---|---|---|
/ss/<start_time> |
string | 否 | 剪辑开始时间,格式为 HH:MM:SS ,默认视频开始时间 |
/es/<end_time> |
string | 否 | 剪辑结束时间,格式为 HH:MM:SS ,默认视频结束时间 |
视频截图
参数 | 类型 | 必选 | 说明 |
---|---|---|---|
type |
string | 是 | 固定值,thumbnail |
avopts |
string | 是 | 视频转码参数,格式为 /key1/value1/key2/value2/... ,参数见「截图参数」 |
return_info |
boolean | 否 | 回调信息是否包含输出文件的元数据,元数据格式为 JSON,默认 false |
save_as |
string | 否 | 输出文件保存路径,默认原始视频所在目录+系统随机生成的文件名。见「注」 |
截图参数
参数 | 类型 | 必选 | 说明 |
---|---|---|---|
/o/<thumb_single> |
boolean | 是 | 是否单张截图,单张截图为 true ,多张截图为 false |
/n/<thumb_amount> |
integer | 是 | 截图数量。当 o 参数为 false 时,有效;当 o 参数为 true 时,无效 |
/ss/<thumb_start> |
string | 否 | 截图开始时间,格式为 HH:MM:SS ,默认 00:00:00 |
/es/<thumb_end> |
string | 否 | 截图结束时间,格式为 HH:MM:SS ,默认视频结束时间。当 o 参数为 true 时,无效 |
/s/<thumb_scale> |
string | 否 | 截图尺寸,格式为 宽:高 ,默认视频原始尺寸 |
/f/<thumb_format> |
string | 否 | 截图输出格式,默认 jpg 。图片格式支持 png 和 jpg 。见「注」 |
注
-
多张截图时,自定义
save_as
参数时只需指定一个保存路径,具体每张图片保存路径根据规则进行类推,例如save_as
为/path/to/img.png
,输出文件保存路径第一张为/path/to/img1.png
,第二张为/path/to/img2.png
……以此类推。 -
自定义
f
和save_as
参数时,使用f
参数指定的格式作为输出格式;仅自定义save_as
参数时,使用save_as
参数指定的后缀名作为输出格式;两者都不自定义时,使用f
参数的默认值jpg
作为输出格式。 -
支持 m3u8 截图。
音频转码
参数 | 类型 | 必选 | 说明 |
---|---|---|---|
type |
string | 是 | 固定值,audio |
avopts |
string | 是 | 视频转码参数,格式为 /key1/value1/key2/value2/... ,参数见「参数」 |
return_info |
boolean | 否 | 回调信息是否包含输出文件的元数据,元数据格式为 JSON,默认 false |
save_as |
string | 否 | 输出文件保存路径,默认原始音频所在目录+系统随机生成的文件名 |
注
save_as
的后缀名作为输出封装格式。
常用参数
参数 | 类型 | 必选 | 说明 |
---|---|---|---|
/f/<format> |
string | 否 | 音频格式,当输出文件没有后缀时,需要指定,其余时候根据输出文件后缀名自动判定 |
/ac/<audio_channel> |
integer | 否 | 声道,默认 2 |
/ab/<audio_bitrate> |
integer | 否 | 比特率,单位 kbps,默认按照音频原始比特率处理 |
/vbr/<audio_vbr> |
integer | 否 | Variable bitrate, 默认按照音频原始 VBR 处理。取值范围 [0-9] |
/sm/<map_metadata> |
boolean | 否 | 是否保留音频 metadata,默认 true |
剪辑参数
拼接参数不能与其他参数混用,请注意。如果要混用,请分做两个任务,使用链式处理。
参数 | 类型 | 必选 | 说明 |
---|---|---|---|
/ss/<start_time> |
string | 否 | 剪辑开始时间,格式为 HH:MM:SS ,默认音频开始时间 |
/es/<end_time> |
string | 否 | 剪辑结束时间,格式为 HH:MM:SS ,默认音频结束时间 |
拼接参数
拼接参数不能与其他参数混用。如果要混用,请分做两个任务,使用链式处理。
参数 | 类型 | 必选 | 说明 |
---|---|---|---|
/i/<audio> |
string | 是 | 需要拼接音频文件的相对路径,需要安全的 Base64 编码。多个需要拼接音频文件按 /i/<audio>/i/<audio>/... 方式进行连接 |
注
-
音频拼接顺序:需要拼接音频按
i
出现顺序,依次拼接在原始音频(source
)后面。 -
如果
save_as
参数指定格式跟原始音频(source
)格式、拼接音频格式不一致,系统会自动转码原始音频、拼接音频成save_as
参数指定格式;如果save_as
参数未指定,拼接音频跟原始音频格式不一致,系统会自动转码拼接音频成原始音频格式。
元数据获取
获取音/视频文件的元信息。
参数 | 类型 | 必选 | 说明 |
---|---|---|---|
type |
string | 是 | 固定值,probe |
链式处理
多个任务按提交任务参数的先后顺序,对原文件进行链式处理。
参数 | 类型 | 必选 | 说明 |
---|---|---|---|
type |
string | 是 | 固定值,chain |
avopts |
string | 是 | 链式处理参数,格式为 /type1/key1/value1/type2/key2/value2... ,参数见「参数」 |
return_info |
boolean | 否 | 回调信息是否包含输出文件的元数据,元数据格式为 JSON,默认 false |
save_as |
string | 否 | 输出文件保存路径,默认原始音频所在目录+系统随机生成的文件名 |
链式处理参数
参数 | 类型 | 必选 | 说明 |
---|---|---|---|
/<type>/<avopts> |
string | 是 | 多个功能标识 type 以及其对应的处理参数 avopts |
请求样例
{
"type": "chain",
"avopts": "/video/i/Zm9vLm1wNA==/video/s/480p(16:9)/wmImg/L3Rlc3QvbG9nby5wbmc=",
"save_as": "/foo.jpg"
}
上述任务先解析 /video/i/Zm9vLm1wNA==
部分,和源视频进行拼接;之后解析 /video/s/480p(16:9)/vb/300/r/25/vcodec/libx264/wmImg/L3Rlc3QvbG9nby5wbmc=
,将上一步输出的视频的分辨率转码成 480p(16:9) 并同时加上水印;最后输出文件保存至 /foo.mp4
。
注
-
最多包含 4 个子任务。
-
截图任务、视频切片任务不产生音视频输出的任务,仅允许放置在子任务列表的末尾。
如有疑问请 联系我们