简介

音视频转码方便用户对音频、视频资源进行编码和格式转换。

• 支持自定义视频的编码格式、封装格式、分辨率、码率等参数进行转码，从而适用于不同的业务场景、播放终端及网络环境。

• 支持对视频内容进行自适应转码，在不损失画质的情况下降低编码码率和带宽，适用于有降低成本且保证画质清晰度的场景。

注意：接口规格不含任何空格与换行符，下列内容经过格式化以便阅读。

avthumb/<Format>
       /vcodec/<VideoCodec>
       /avsmart/<0|1>
       /smtQuality/<Quality>
       /refine/<Refine>
       /maxrate/<Maxrate>
       /r/<FrameRate>
       /ref/<Ref>
       /hr/<HighFrameRate>
       /vb/<VideoBitRate>
       /crf/<Crf>
       /h264Profile/<H264Profile>
       /h264Level/<H264Level>	
       /s/<Resolution>
       /s/<Resolution>>
       /s/<Resolution><
       /aspect/<Aspect>
       /autoscale/<Autoscale>
       /padW/<PadW>
       /padH/<PadH>
       /padVideoX/<PadVideoX>
       /padVideoY/<PadVideoY>
       /gop/<GroupOfPictures>
       /colorspace/<ColorSpace>	
       /keyFramePosition/<KeyFramePosition>
       /rotate/<Degree>
       /rotateinfo/<Degree>
       /flip/<Flip>
       /compressLevel/<level>	
       /ss/<SeekStart>
       /t/<Duration>
       /gifHighColor/<GIFHighColor>
       /deinterlace/<Deinterlace>
       /wmImage/<EncodedKodoScheme>
       /wmVideo/<EncodedKodoScheme>
       /wmGravity/<Gravity>
       /wmScale/<Scale>
       /wmScaleType/<ScaleType>
       /wmVideoOrder/<VideoOrder>
       /wmConstant/<Constant>
       /wmAlpha/<Alpha>
       /wmIgnoreLoop/<WmIgnoreLoop>
       /wmText/<EncodedText>
       /wmGravityText/<GravityText>
       /wmFont/<font>
       /wmFontStyle/<fontStyle>
       /wmFontColor/<fontcolor>
       /wmFontSize/<fontsize>
       /wmOffsetX/<offsetX>
       /wmOffsetY/<offsetY>
       /wmPos/<Position>
       /wmDuration/<Duration>
       /wmShortest/<WmShortest>
       /mosaic/<Mosaic>
       /mosaicGravity/<MosaicGravity>
       /mosaicOffsetX/<MosaicOffsetX>
       /mosaicOffsetY/<MosaicOffsetY>
       /mosaicSize/<MosaicSize>
       /mosaicStart/<MosaicStart>
       /mosaicDuration/<MosaicDuration>
       /stream/<Stream>
       /cut/<Cut>
       /vn/<VideoNo> 
       /sn/<SubtitleNo>
       /scodec/<SubtitleCodec>
       /subtitle/<SubtitleURL>
       /stFont/<SubtitleFont>
       /stFontSize/<SubtitleFontSize>
       /stOffsetX/<SubtitleOffsetX>
       /stOffsetY/<SubtitleOffsetY>
       /stripmeta/<StripMeta>
       /meta/<Meta>
       /useMovTags/<UseMovTags>
       /acodec/<AudioCodec>
       /ab/<BitRate>
       /ac/<ChannelNum>
       /ar/<SamplingRate>
       /aq/<AudioQuality>
       /audioProfile/<profile>
       /volume/<Volume>
       /loudnorm/<LoudNorm>
       /loudnormI/<LoudNormI>
       /loudnormLRA/<LoudNormLRA>
       /loudnormTP/<LoudNormTP>
       /loudnormF/<LoudNormF>
       /loudnormG/<LoudNormG>
       /loudnormRefine/<LoudNormRefine
       /an/<AudioNo>
       /speex/<Speex>
       /writeXing/<0|1>
       /amix/<AmixURL>
       /amixOffset/<AmixOffset>
       /amixStart/<AmixStart>
       /amixDuration/<AmixDuration>
       /multiArep/<MultiAudioReplaceURL>
       /multiArepOffset/<MultiAudioReplaceOffset>
       /multiArepStart/<MultiAudioReplaceStart>
       /multiArepDuration/<MultiAudioReplaceDuration>
       /sdr/<SDR>
       /pixFmt/<PixFmt>
       /limitWidth/<LimitWidth>
       /limitHeight/<LimitHeight>
       /limitSize/<LimitSize>
       /limitDuration/<LimitDuration>

封装参数

注意：不同的封装格式，有默认转码参数值，如果觉得某些参数不适合自己的业务场景，可以在后面加参数覆盖。如： avthumb/mp3/ab/64k 会把默认码率128k调整为64k。

视频参数

水印参数

支持对视频加多个不同类型的水印。

音频参数

字幕参数

转码条件参数

音视频转封装

• 当<VideoCodec>和<AudioCodec>值同时为copy，不进行音视频编解码操作，即音视频转封装。以音视频装封装计费。

操作方式

您可以通过以下几种方式来创建任务：

方式一：使用任务触发器

• 对符合规则策略的上传文件自动触发：在具体空间下，选择任务与工作流，进入任务触发器页面，点击新建 任务触发器；创建完成后，需要开启 上传触发开关，然后通过左侧文件管理或 API/SDK 上传文件到触发器指定的输入路径；将对符合规则策略的上传文件自动触发多媒体处理，并将结果文件保存到目标路径。

  

方式二：使用对象存储控制台

• 上传文件手动触发：在具体空间下， 上传文件 时，指定工作流模板 。

  

• 指定文件手动触发：有两种指定单个文件创建任务的入口

  • 第一个入口：在具体空间下，在文件列表中指定文件，在操作栏【更多】中点击【创建多媒体任务】。

    

    注意：仅对音视频/gif动图/webp动图文件提供该操作。
    

  • 第二个入口：在具体空间下，选择任务与工作流，进入任务管理页面，点击【新建任务】。

    

方式三：使用API

• 资源上传时手动触发：可以在构造上传凭证时在上传策略中，设置相关字段，在资源文件上传时触发处理。
• 对已有资源手动触发：可以在调用 持久化数据处理(pfop) 时，设置相关字段，对已存在空间中的资源文件发起处理。

方式四：使用SDK

• 查看各语言 SDK 使用指南中 持久化数据处理 章节，可在七牛官方SDK 进行下载。

操作示例

使用API

• 以 资源上传时手动触发 形式，将wav音频转换为mp3格式，音频码率为192k：

  {
        "scope":                "qiniu-ts-demo:sample.wav",
        "deadline":             1390528576,
        "persistentOps":        "avthumb/mp3/ab/192k",
        "persistentNotifyUrl":  "http://fake.com/qiniu/notify"
    }
  

• 以 对已有资源手动触发 形式，将mp4视频进行锐智转码（即视频瘦身），设置视频编码格式为libx264，分辨率为1920x1080，生成文件名为为sample_target.mp4的视频资源：

  POST /pfop/ HTTP/1.1
  Host: api.qiniu.com  
  Content-Type: application/x-www-form-urlencoded  
  Authorization: Qiniu <AccessToken>  
  
  bucket=qiniu-ts-demo
  &key=thinking-in-go.mp4
  &fops=avthumb/mp4/vcodec/libx264/s/1920x1080/avsmart/1/smtQuality/4|saveas/dGVzdDpzYW1wbGVfdGFyZ2V0Lm1wNA==&notifyURL=http%3A%2F%2Ffake.com%2Fqiniu%2Fnotify
  &notifyURL=http%3A%2F%2Ffake.com%2Fqiniu%2Fnotify
  

使用SDK

以Python Sdk为例

• 在 文件上传时触发 ，本例中将上传的视频转码为MP4的视频文件，保存到目标Bucket_Name,且文件名为自定义文件key，原上传视频保存到bucket_name空间，且文件名为key。

from qiniu import Auth, put_file, etag, urlsafe_base64_encode
import qiniu.config

# access_key，secret_key在个人面板的密钥管理处获得，非个人账号密码
access_key = '...'
secret_key = '...'

# 初始化Auth状态
q = Auth(access_key, secret_key)

# 你要测试的空间， 并且这个key在你空间中存在
bucket_name = '...'
key = '...'

# 是使用的队列名称,不设置代表不使用私有队列，使用公有队列。
pipeline = 'your_pipeline'

# 设置转码参数
fops = 'avthumb/mp4/vcodec/libx264'

# 通过添加'|saveas'参数，指定处理后的文件保存的bucket和key，不指定默认保存在当前空间，bucket_saved为目标bucket，bucket_saved为目标key
saveas_key = urlsafe_base64_encode('bucket_saved:bucket_saved')

fops = fops+'|saveas/'+saveas_key

# 在上传策略中指定fobs和pipeline
policy={
  'persistentOps':fops,
  'persistentPipeline':pipeline
 }

token = q.upload_token(bucket_name, key, 3600, policy)

# 视频所在的本地路径
localfile = './python_video.flv'

ret, info = put_file(token, key, localfile)
print(info)
assert ret['key'] == key
assert ret['hash'] == etag(localfile)

• 对已有资源手动触发，本例将空间名为bucket_name中的视频 key转码为MP4的视频文件，并且保存到目标Bucket_Name,且文件名为自定义文件key。

from qiniu import Auth, PersistentFop, build_op, op_save, urlsafe_base64_encode

# 对已经上传到七牛的视频发起异步转码操作
# access_key，secret_key在个人面板的密钥管理处获得，非个人账号密码
access_key = '...'
secret_key = '...'
q = Auth(access_key, secret_key)

# 要转码的文件所在的空间和文件名。
bucket_name = '...'
key = '...'

# 是使用的队列名称,不设置代表不使用私有队列，使用公有队列。
pipeline = 'your_pipeline'

# 要进行转码的转码操作。
fops = 'avthumb/mp4/s/640x360/vb/1.25m'

# 可以对转码后的文件进行使用saveas参数自定义命名，当然也可以不指定文件会默认命名并保存在当前空间
saveas_key = urlsafe_base64_encode('目标Bucket_Name:自定义文件key')
fops = fops+'|saveas/'+saveas_key

pfop = PersistentFop(q, bucket_name, pipeline)
ops = []
ops.append(fops)
ret, info = pfop.execute(key, ops, 1)
print(info)
assert ret['persistentId'] is not None

计费说明

转码费用计算公式

• 转码费用 = 输出文件时长 x 转码单价，价格单位： 元／分钟。
• 输出时长：对于每月转码输出文件，按分钟计费，累计总时长不足一分钟不计费
• 输出规格按输出视频分辨率的长边和短边属于输出规格划定的范围进行判定，以普通转码输出HD (1920 x 1080) 规格为例：
  • 输出视频的分辨率长边不大于1920且短边不大于1080，则属于HD输出规格。
  • 输出视频的长边大于1920或输出视频的短边大于1080，该属于更高输出规格。

特定参数计费模式，价格参见

1. 使用 avthumb 命令时，当 VideoCodec 和 AudioCodec 两个参数值同时设为 copy，服务收费=音视频转封装价格。
2. 使用 avthumb 命令时，且不启用锐智转码，当视频实际处理帧率在(30, 60]时，服务收费= 普通转码高帧率价格 。价格参见。
3. 使用 avthumb 命令时，且启用锐智转码，即使用 avsmart 参数，与普通音视频转码计费有区别，服务价格=锐智转码价格。
4. 使用 avthumb 命令时，且同时启用GPU转码，即使用prehw 参数，当前公测阶段，GPU转码收费跟普通转码价格一样，后续可能会调整价格。
5. 使用 avthumb 命令时，且同时启用SDR转HDR，即使用 hdr 参数，服务价格=SDR to HDR 价格。
6. 使用 avthumb 命令时，不设置分辨率参数（ s ）、或帧率相关参数，那么计费会默认跟随源视频的特性。
   • 示例1：转码不设置分辨率，源视频分辨率为1920*1080，则计费会按 HD 规格计费；
   • 示例2：转码不设置帧率相关参数，源视频帧率为50，则计费会按高帧计费；

注意

七牛云的数据处理API均支持管道，通过管道操作符 | 实现串行处理，即将一个资源经由多个 <fop> 串行处理。

处理规格如下：

<fop1>|<fop2>|<fop3>|<fopN>

• <fop> (File Operation的缩写)，表示数据处理指令及其所需要的参数。
• 整个串行处理中，只要有处理成功的 fop，就会有相应的计量计费。