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

接口规格

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

avthumb/<Format>
       /vcodec/<VideoCodec>
       /avsmart/<0|1>
       /smtType/<avsmart>
       /smtEnhance/<Enhance>
       /smtQuality/<Quality>
       /refine/<Refine>
       /maxrate/<Maxrate>
       /r/<FrameRate>
       /hr/<HighFrameRate>
       /vb/<VideoBitRate>
       /stripmeta/<StripMeta>
       /crf/<Crf>
       /h264Profile/<H264Profile>
       /h264Level/<H264Level>    
       /s/<Resolution>
       /aspect/<Aspect>
       /autoscale/<Autoscale>
       /padW/<PadW>
       /padH/<PadH>
       /padVideoX/<PadVideoX>
       /padVideoY/<PadVideoY>
       /gop/<GroupOfPictures>    
       /keyFramePosition/<KeyFramePosition>
       /rotate/<Degree>
       /flip/<Flip>
       /compressLevel/<level>    
       /ss/<SeekStart>
       /t/<Duration>
       /gifHighColor/<GIFHighColor>
       /deinterlace/<Deinterlace>
       /wmImage/<EncodedRemoteImageUrl>
       /wmGravity/<Gravity>
       /wmScale/<Scale>
       /wmScaleType/<ScaleType>
       /wmConstant/<Constant>
       /wmAlpha/<Alpha>
       /wmIgnoreLoop/<WmIgnoreLoop>
       /wmText/<EncodedText>
       /wmGravityText/<GravityText>
       /wmFont/<font>
       /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>
       /stripmeta/<StripMeta>
       /acodec/<AudioCodec>
       /ab/<BitRate>
       /ac/<ChannelNum>
       /ar/<SamplingRate>
       /aq/<AudioQuality>
       /audioProfile/<profile>
       /volume/<Volume>
       /loudnorm/<LoudNorm>
       /loudnormI/<LoudNormI>
       /loudnormLRA/<LoudNormLRA>
       /loudnormTP/<LoudNormTP>
       /an/<AudioNo>
       /speex/<Speex>
       /writeXing/<0|1>
       /amix/<AmixURL>
       /amixOffset/<AmixOffset>
       /amixStart/<AmixStart>
       /amixDuration/<AmixDuration>
       /multiArep/<MultiAudioReplaceURL>
       /multiArepOffset/<MultiAudioReplaceOffset>
       /multiArepStart/<MultiAudioReplaceStart>
       /multiArepDuration/<MultiAudioReplaceDuration>

封装格式

视频参数

视频水印参数

音频参数

加密参数
对视频内容进行私有加密，只能通过七牛云播放器解码播放。关于输出视频解密以及播放的要求可参考 qplayer 说明。

• 视频私有加密单独计费。如果只希望对视频加密而不进行转码操作，则需要将<VideoCodec>和<AudioCodec>值同时指定为copy。
• 当<VideoCodec>值不为copy且<AudioCodec> 值不同时为copy且指定了加密参数时，服务价格 = 视频转码价格 + 视频加密价格
• 当<VideoCodec>和<AudioCodec>值同时为copy 并且指定了加密参数时，服务价格 = 视频加密价格
• 视频加密服务计费方式为按时（分钟）计费。服务价格为：0.018 元/分钟。

接口备注

• 转码操作若未指定音视频码率，转码结果的码率会小于等于原音视频码率，若指定码率大于原音视频码率，转码操作会使用原视频码率进行转码。
• avthumb转码的结果会保存在原文件的空间中，但是文件名按照默认规则生成，为了方便获取转码后资源链接，建议自定义处理结果资源的名称，请参考处理结果另存 (saveas)。
• 当<VideoCodec>和<AudioCodec>值同时为copy，即不进行音视频编解码操作时以音视频转封装计费。
• 视频转码时，当视频实际处理帧率在(30, 60]时，按视频高帧率转码计费。
• 我们为一些预设集设置了默认参数，如果用户觉得某些参数不适合自己的业务场景可以在后面加参数覆盖。如： avthumb/mp3/ab/64k 会把默认码率128k调整为64k。
• 不同格式的默认转码参数列表：

• <Format> 为 mp4 且 <AudioCodec> 为 libmp3lame 时，<SamplingRate> 的值不可小于 16000；另外，特定音频编码方案 <AudioCodec> 可使用的音频采样频率 <SamplingRate> 如下表所示：

• 使用avsmart参数时，为避免转码处理超时，目前对于视频时长有一些限制。不同规格的视频时长限制如下：

• 支持对视频加多个不同类型的水印。以预转持久化形式，将视频转换成mp4格式，对视频资源加2个图片水印和2个文字水印，示例如下：

 {
        "scope":                "test:sample.mp4",
        "deadline":             1608652800,
        "persistentOps":        
                "avthumb/mp4/
                /wmImage/aHR0cDovL3Rlc3QtMi5xaW5pdWRuLmNvbS9sb2dvLnBuZw/wmGravity/NorthWest==
                /wmImage/aHR0cDovLzd4bHY0Ny5jb20wLnowLmdsYi5jbG91ZGRuLmNvbS_kuoznu7TnoIEucG5n==
                /wmText/d2Vsb3ZlcWluaXU=/wmFontColor/cmVk/wmFontSize/60/wmGravityText/North==
                /wmText/d2Vsb3ZlcWluaXU=/wmFontColor/cmVk/wmFontSize/20/wmGravityText/South
                |saveas/dGVzdDpzYW1wbGVfdGFyZ2V0Lm1wNA==",
        "persistentPipeline":   "newtest",
        "persistentNotifyUrl":  "http://fake.com/qiniu/notify"
 }

• 水印锚点参数表

NorthWest     |     North      |     NorthEast
              |                |    
              |                |    
--------------+----------------+--------------
              |                |    
West          |     Center     |          East 
              |                |    
--------------+----------------+--------------
              |                |    
              |                |    
SouthWest     |     South      |     SouthEast

参数设置举例

• 以预转持久化形式，将wav音频转换为mp3格式：

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

• 以预转持久化形式，将wav音频转换为mp3格式，比特率为192k：

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

• 以预转持久化形式，将mp4视频转换为flv格式，帧率为24，使用x264进行视频编码：

  {
      "scope":                "qiniu-ts-demo:thinking-in-go.mp4",
      "deadline":             1390528576,
      "persistentOps":        "avthumb/flv/r/24/vcodec/libx264",
      "persistentNotifyUrl":  "http://fake.com/qiniu/notify"
  }

• 以预转持久化]形式，将mp4视频转换为avi格式，使用mp3进行音频编码，且音频比特率为64k：

  {
      "scope":                "qiniu-ts-demo:thinking-in-go.mp4",
      "deadline":             1390528576,
      "persistentOps":        "avthumb/avi/ab/64k/acodec/libmp3lame",
      "persistentNotifyUrl":  "http://fake.com/qiniu/notify"
  }

• 以持久化数据处理(即触发持久化)形式，将wav音频转换为mp3格式，VBR参数为3，采样频率为44100：

  POST /pfop/ HTTP/1.1
  Host: api.qiniu.com  
  Content-Type: application/x-www-form-urlencoded  
  Authorization: QBox <AccessToken>  

  bucket=qiniu-tsdemo
  &key=sample.wav
  &fops=avthumb%2Fmp3%2Far%2F44100%2Faq%2F3
  &notifyURL=http%3A%2F%2Ffake.com%2Fqiniu%2Fnotify

• 以持久化数据处理（即触发持久化）形式，将mp4视频进行锐智转码（即视频瘦身），设置视频编码格式为x264，分辨率为480x260，默认开启视频增强：

  POST /pfop/ HTTP/1.1
  Host: api.qiniu.com  
  Content-Type: application/x-www-form-urlencoded  
  Authorization: QBox <AccessToken>  

  bucket=qiniu-ts-demo
  &key=thinking-in-go.mp4
  &fops=avthumb%2Fmp4%2Fvcodec%2Flibx264%2Fs%2F480x360%2Favsmart%2F1
  &notifyURL=http%3A%2F%2Ffake.com%2Fqiniu%2Fnotify

• 以持久化数据处理（即触发持久化）形式，将mp4视频转换为flv格式，帧率为30，视频比特率为256k，使用x264进行视频编码，音频采样频率为22050，音频比特率为64k，使用mp3进行音频编码：

  POST /pfop/ HTTP/1.1
  Host: api.qiniu.com  
  Content-Type: application/x-www-form-urlencoded  
  Authorization: QBox <AccessToken>  

  bucket=qiniu-ts-demo
  &key=thinking-in-go.mp4
  &fops=avthumb%2Fflv%2Fr%2F30%2Fvb%2F256k%2Fvcodec%2Flibx264%2Far%2F22050%2Fab%2F64k%2Facodec%2Flibmp3lame
  &notifyURL=http%3A%2F%2Ffake.com%2Fqiniu%2Fnotify

• 以持久化数据处理（即触发持久化）形式，将mp4视频转换为ogv格式，帧率为30，视频比特率为1800k，使用libtheora进行视频编码，音频采样频率为44100，音频比特率为128k，使用libvorbis进行音频编码：

  POST /pfop/ HTTP/1.1
  Host: api.qiniu.com  
  Content-Type: application/x-www-form-urlencoded  
  Authorization: QBox <AccessToken>  

  bucket=qiniu-ts-demo
  &key=thinking-in-go.mp4
  &fops=avthumb%2Fogv%2Fr%2F30%2Fvb%2F1800k%2Fvcodec%2Flibtheora%2Far%2F44100%2Fab%2F128k%2Facodec%2Flibvorbis
  &notifyURL=http%3A%2F%2Ffake.com%2Fqiniu%2Fnotify

• 以持久化数据处理（即触发持久化）形式，为指定视频资源打上图片水印http://78re52.com1.z0.glb.clouddn.com/resource%2Flogo.jpg, 位置是右上角；同时给视频打上文字水印weloveqiniu，颜色为红色，大小为3磅（60缇），字体为黑体，位置为正上方；生成文件名为为sample_target.mp4的新mp4视频资源：

POST /pfop/ HTTP/1.1
Host: api.qiniu.com  
Content-Type: application/x-www-form-urlencoded  
Authorization: QBox <AccessToken>  

bucket=test&key=sample.mp4&fops=avthumb%2fmp4%2fwmImage%2faHR0cDovL3Rlc3QtMi5xaW5pdWRuLmNvbS9sb2dvLnBuZw==%2fwmText%2fd2Vsb3ZlcWluaXU=%2fwmFontColor%2fcmVk%2fwmFontSize%2f60%2fwmGravityText%2fNorth%2csaveas%2fdGVzdDpzYW1wbGVfdGFyZ2V0Lm1wNA==&notifyURL=http%3A%2F%2Ffake.com%2Fqiniu%2Fnotify

注意：要在Authorization头部的<AccessToken>前添加QBox和半角空格。

以 Python Sdk 为例，需要在音视频转码的示例的基础修改数据处理命令 fops ，将其修改为：

fops = avthumb/mp4/wmImage/aHR0cDovL3Rlc3QtMi5xaW5pdWRuLmNvbS9sb2dvLnBuZw==/wmText/d2Vsb3ZlcWluaXU=/wmFontColor/cmVk/wmFontSize/60/wmGravityText/North

示例

触发持久化

以Python Sdk为例，本例将空间名为bucket_name中的视频 key转码为MP4的视频文件，并且保存到目标Bucket_Name,且文件名为自定义文件key。

注意:
其他语言 SDK 可在官方 SDK下载，可以通过查看 SDK 使用指南中触发持久化使用。

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

预转持久化

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

注意:
其他语言 Sdk 可在官方 Sdks 下载，可以通过查看 Sdk 使用指南中预转持久化使用。

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)