简介

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

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

avthumb/<Format>
       /vcodec/<VideoCodec>
       /avsmart/<0|1>
       /smtQuality/<Quality>
       /refine/<Refine>
       /maxrate/<Maxrate>
       /r/<FrameRate>
       /ref/<Ref>
       /hr/<HighFrameRate>
       /vb/<VideoBitRate>
       /stripmeta/<StripMeta>
       /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>
       /flip/<Flip>
       /compressLevel/<level>	
       /ss/<SeekStart>
       /t/<Duration>
       /gifHighColor/<GIFHighColor>
       /deinterlace/<Deinterlace>
       /wmImage/<Encodedkodocheme>
       /wmVideo/<Encodedkodocheme>
       /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>
       /stFont/<SubtitleFont>
       /stFontSize/<SubtitleFontSize>
       /stOffsetX/<SubtitleOffsetX>
       /stOffsetY/<SubtitleOffsetY>
       /stripmeta/<StripMeta>
       /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>

封装参数

视频参数

视频水印参数

音频参数

字幕参数

音视频转封装

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

加密参数

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

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

使用限制

• avthumb转码的结果会保存在原文件的空间中，但是文件名按照默认规则生成，为了方便获取转码后资源链接，建议自定义处理结果资源的名称，请参考处理结果另存 (saveas)。

• 转码操作若未指定音视频码率，转码结果的码率会小于等于原音视频码率，若指定码率大于原音视频码率，转码操作会使用原视频码率进行转码。

• 视频转码时，当视频实际处理帧率在(30, 60]时，按视频高帧率转码计费，价格参见。

• 我们为一些预设集设置了默认参数，如果用户觉得某些参数不适合自己的业务场景可以在后面加参数覆盖。如： avthumb/mp3/ab/64k 会把默认码率128k调整为64k。

• 不同格式的默认转码参数列表：

  格式	视频编码器	视频码率	音频编码器	音频码率	音频采样率
  flash	flv	512k	libmp3lame	64k	44100
  webm	libvpx	700k	libvorbis	128k	48k
  mp3	-	-	libmp3lame	128k	44100
  amr	-	-	amr_nb	12.20k	8000

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

  音频编码方案 acodec	可使用的音频采样频率 ar
  libfdk_aac	96000, 88200, 64000, 48000, 44100, 32000, 24000, 22050, 16000, 12000, 11025, 8000
  libmp3lame	48000, 44100, 32000, 24000, 22050, 16000, 12000, 11025
  libspeex	32000, 16000, 8000
  libopencore_amrnb	8000

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

  规格	时长限制（s）
  720p	9000
  1080p	5400
  2K	1800
  4K	600

• 支持对视频加多个不同类型的水印。以预转持久化形式，将视频转换成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
  

操作方式

• API方式：可以通过 持久化处理 的方式来调用：

  • 资源上传时自动触发：可以在上传时指定persistentOps参数
  • 对已有资源手动手动触发：调用pfop命令

• 控制台方式：您可以使用智能多媒体平台，可视化创建任务，使用详情请参考 任务。

示例

资源上传时触发

以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)

• 以 资源上传时自动触发 形式，将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"
    }
  

对已有资源手动触发

以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

• 以 对已有资源手动触发 形式，将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