接口规格

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

1. avthumb/<Format>
2. /ab/<BitRate>
3. /aq/<AudioQuality>
4. /ar/<SamplingRate>
5. /r/<FrameRate>
6. /vb/<VideoBitRate>
7. /vcodec/<VideoCodec>
8. /acodec/<AudioCodec>
9. /scodec/<SubtitleCodec>
10. /subtitle/<SubtitleURL>
11. /ss/<SeekStart>
12. /t/<Duration>
13. /s/<Resolution>
14. /autoscale/<Autoscale>
15. /aspect/<Aspect>
16. /stripmeta/<StripMeta>
17. /h264Crf/<H264Crf>
18. /rotate/<Degree>
19. /wmImage/<EncodedRemoteImageUrl>
20. /wmGravity/<Gravity>
21. /wmText/<text>
22. /wmGravityText/<gravity_text>
23. /wmFont/<font>
24. /wmFontColor/<fontcolor>
25. /wmFontSize/<fontsize>
26. /writeXing/<Xing>
27. /an/<AudioNo>
28. /vn/<VideoNo>
29. /sn/<SubtitleNo>
30. ／hlsMethod/<HLSMethod>

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

参数设置举例

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

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

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

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

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

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

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

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

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

1. POST /pfop/ HTTP/1.1
2. Host: api.qiniu.com
3. Content-Type: application/x-www-form-urlencoded
4. Authorization: QBox <AccessToken>
5.  
6. bucket=qiniu-ts-demo&key=sample.wav&fops=avthumb%2Fmp3%2Far%2F44100%2Faq%2F3&notifyURL=http%3A%2F%2Ffake.com%2Fqiniu%2Fnotify

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

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

1. POST /pfop/ HTTP/1.1
2. Host: api.qiniu.com
3. Content-Type: application/x-www-form-urlencoded
4. Authorization: QBox <AccessToken>
5.  
6. bucket=qiniu-ts-demo
7. &key=thinking-in-go.mp4
8. &fops=avthumb%2Fflv%2Fr%2F30%2Fvb%2F256k%2Fvcodec%2Flibx264%2Far%2F22050%2Fab%2F64k%2Facodec%2Flibmp3lame
9. &notifyURL=http%3A%2F%2Ffake.com%2Fqiniu%2Fnotify

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

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

1. POST /pfop/ HTTP/1.1
2. Host: api.qiniu.com
3. Content-Type: application/x-www-form-urlencoded
4. Authorization: QBox <AccessToken>
5.  
6. bucket=qiniu-ts-demo
7. &key=thinking-in-go.mp4
8. &fops=avthumb%2Fogv%2Fr%2F30%2Fvb%2F1800k%2Fvcodec%2Flibtheora%2Far%2F44100%2Fab%2F128k%2Facodec%2Flibvorbis
9. &notifyURL=http%3A%2F%2Ffake.com%2Fqiniu%2Fnotify

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

注意：

• 支持的视频编码器(Codec)有：libx264 libvpx libtheora libxvid等。
• 支持的音频编码器(Codec)有：libmp3lame libfaac libvorbis等。
• 我们为一些预设集设置了默认参数，如果用户觉得某些参数不适合自己的业务场景可以在后面加参数覆盖。如： avthumb/mp3/ab/64k 会把默认码率128k调整为64k。

默认参数列表：

示例

触发持久化

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

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

1. from qiniu import Auth, PersistentFop, build_op, op_save, urlsafe_base64_encode
2.  
3. # 对已经上传到七牛的视频发起异步转码操作
4. # access_key，secret_key在个人面板的密钥管理处获得，非个人账号密码
5. access_key = '...'
6. secret_key = '...'
7. q = Auth(access_key, secret_key)
8.  
9. # 要转码的文件所在的空间和文件名。
10. bucket_name = '...'
11. key = '...'
12.  
13. # 是使用的队列名称,不设置代表不使用私有队列，使用公有队列。
14. pipeline = 'your_pipeline'
15.  
16. # 要进行转码的转码操作。
17. fops = 'avthumb/mp4/s/640x360/vb/1.25m'
18.  
19. # 可以对转码后的文件进行使用saveas参数自定义命名，当然也可以不指定文件会默认命名并保存在当前空间
20. saveas_key = urlsafe_base64_encode('目标Bucket_Name:自定义文件key')
21. fops = fops+'|saveas/'+saveas_key
22.  
23. pfop = PersistentFop(q, bucket_name, pipeline)
24. ops = []
25. ops.append(fops)
26. ret, info = pfop.execute(key, ops, 1)
27. print(info)
28. assert ret['persistentId'] is not None

预转持久化

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

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

1. from qiniu import Auth, put_file, etag, urlsafe_base64_encode
2. import qiniu.config
3.  
4. # access_key，secret_key在个人面板的密钥管理处获得，非个人账号密码
5. access_key = '...'
6. secret_key = '...'
7.  
8. # 初始化Auth状态
9. q = Auth(access_key, secret_key)
10.  
11. # 你要测试的空间， 并且这个key在你空间中存在
12. bucket_name = '...'
13. key = '...'
14.  
15. # 是使用的队列名称,不设置代表不使用私有队列，使用公有队列。
16. pipeline = 'your_pipeline'
17.  
18. # 设置转码参数
19. fops = 'avthumb/mp4/vcodec/libx264'
20.  
21. # 通过添加'|saveas'参数，指定处理后的文件保存的bucket和key，不指定默认保存在当前空间，bucket_saved为目标bucket，bucket_saved为目标key
22. saveas_key = urlsafe_base64_encode('bucket_saved:bucket_saved')
23.  
24. fops = fops+'|saveas/'+saveas_key
25.  
26. # 在上传策略中指定fobs和pipeline
27. policy={
28. 'persistentOps':fops,
29. 'persistentPipeline':pipeline
30. }
31.  
32. token = q.upload_token(bucket_name, key, 3600, policy)
33.  
34. # 视频所在的本地路径
35. localfile = './python_video.flv'
36.  
37. ret, info = put_file(token, key, localfile)
38. print(info)
39. assert ret['key'] == key
40. assert ret['hash'] == etag(localfile)