jancd/qiniu-developer_ShareGPT huggingface dataset:
human: 如何处理七牛云的智能多媒体服务预置系统预设说明

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > 使用指南 > 开发指南 >多媒体处理能力 >预置系统预设说明

#  预置系统预设说明

最近更新时间: 2021-01-19 13:45:21

本文主要介绍一些媒体处理相关的配置经验，提供一些系统预置的预设，为用户提供参考。  
​

# **普通转码系统预设**

> 没有特殊说明的参数，则跟源视频一样。

  1. **视频转码预设**

封装格式(format) | 预设名称 | 视频编码格式( vcodec) | 分辨率( s)  
---|---|---|---  
mp4 | 转封装-MP4 | H.264 | -  
| MP4-流畅 | H.264 | 320*240  
| MP4-标清 | H.264 | 640*480  
| MP4-高清 | H.264 | 1280*720  
| MP4-全高清 | H.264 | 1920*1080  
| MP4-2K | H.264 | 2560*1440  
| MP4-4K | H.264 | 3840*2160  
m3u8 | 转封装-M3U8 | H.264 | -  
| M3U8-流畅 | H.264 | 320*240  
| M3U8-标清 | H.264 | 640*480  
| M3U8-高清 | H.264 | 1280*720  
| M3U8-全高清 | H.264 | 1920*1080  
| M3U8-2K | H.264 | 2560*1440  
| M3U8-4K | H.264 | 3840*2160  
flv | 转封装-FLV | H.264 | -  
| FLV-流畅 | H.264 | 320*240  
| FLV-标清 | H.264 | 640*480  
| FLV-高清 | H.264 | 1280*720  
| FLV-全高清 | H.264 | 1920*1080  
| FLV-2K | H.264 | 2560*1440  
| FLV-4K | H.264 | 3840*2160  
ts | 转封装-TS | H.264 | -  
  
  2. **音频转码预设**

封装格式(format) | 预设名称 | 音频编码格式( acodec) | 音频码率( ab)  
---|---|---|---  
mp3 | MP3-64 | mp3 | 64  
| MP3-128 | mp3 | 128  
| MP3-160 | mp3 | 160  
| MP3-192 | mp3 | 192  
| MP3-320 | mp3 | 320  
| AAC-64 | aac | 64  
| AAC-128 | aac | 128  
| AAC-160 | aac | 160  
| AAC-256 | aac | 256  
  
​

# **截图系统预设**

截图类型 | 预设名称 | 截图格式(format) | 开始时间(offset) | 宽*高(w×h)  
---|---|---|---|---  
单张截图 | 预置单张截图 | Jpg | 00时00分01秒 | 和源视频保持一致  
  
**备注：**

  1. 预设未注明的参数，同源视频保持一致。
  2. 表中 ”-“ ，表示同源视频保持一致。

​

# **自定义预设**

当系统预设不能满足需求时，用户可以自定定义转码参数，即创建“自定义预设”。

可通过控制台，创建对应类型的自定义预设：

  * [创建普通转码预设 __](https://developer.qiniu.com/dora/manual/6492/transcoding-preset)

  * [创建锐智转码预设 __](https://developer.qiniu.com/dora/manual/6850/perceptive-transcoding-preset)

  * [创建截图预设 __](https://developer.qiniu.com/dora/manual/6494/screenshot-of-the-preset)

  * [创建水印预设 __](https://developer.qiniu.com/dora/manual/6493/the-watermark-default)

  * [创建视频拼接预设 __](https://developer.qiniu.com/dora/manual/6851/video-stitching-preset)

​

以上内容是否对您有帮助？
human: 如何处理七牛云的智能多媒体服务任务创建

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > 使用指南 > 开发指南 >任务创建

#  任务创建

最近更新时间: 2020-09-03 11:58:29

任务创建的方式包含以下三种：

  * 自动触发：通过配置任务触发器，当文件上传时会自动触发并处理任务，仅支持对增量数据做触发。
  * 指定文件触发：指定 Bucket 中的文件，发起处理任务请求。
  * 主动触发：通过调用 API 发起处理任务请求。

# **自动触发**

可通过控制台创建，参见 [新建任务工作流](https://developer.qiniu.com/dora/manual/6489/task-
workflow) 。

# **指定文件触发**

可通过控制台创建，参见 [新建任务](https://developer.qiniu.com/dora/manual/6488/task-01) 。

# **主动触发**

开发者可以通过 API 发起任务处理。可以进入【控制台- 任务列表】查询，也可通过 `persistentId`查询。

## 示例

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

**注意** :  
其他语言 SDK 可在[官方 SDK](https://developer.qiniu.com/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
    
    

以上内容是否对您有帮助？
human: 如何处理七牛云的智能多媒体服务回调升级

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > 使用指南 > 开发指南 >回调升级

#  回调升级

最近更新时间: 2020-12-30 14:46:55

智能多媒体平台的功能升级，健壮了任务处理的计算编排能力，回调同样做了升级，您的业务系统可能需要适配最新的回调格式。

  * [查看新版V3回调内容 __](https://developer.qiniu.com/dora/6504/receive-notifications)
  * [查看老版V2回调内容 __](https://developer.qiniu.com/dora/7518/task-to-inform)

​  
本文会告知如何升级回调，以及V2和V3的差异。阅读本文前，请先登录控制台，选择【智能多媒体平台】>【工作流】，在该页面进行确认：  
![img](https://dora-doc.qiniu.com/WX20201230-144151.png)

  * 如果仅可见【V3回调版本】，说明您的回调默认已是V3版本，无需阅读本文。
  * 如果同时可见【V2回调版本】和【V3回调版本】，说明您正在使用V2回调版本，**请继续阅读下面的内容** 。

> **注意：**
>
> 如果您仍在使用V2版本的回调，建议您将使用的回调逐步迁移到V3，以便您可以使用升级后的工作流去创建任务处理流程。

​  
升级回调后，您的工作流可以满足：

>   * 支持更多处理的计算能力；
>   * 支持串联/并行的组合方式；
>   * 支持部分节点的条件处理逻辑，举例：avinfo, 对>=720p的视频文件做某种处理；
>   * 不仅可以针对原片进行处理，还可对中间处理结果进行处理。
>

​

# **如何升级回调**

如果您的工作流不是最新的回调版本，登录控制台，可通过以下2种方式去升级。

  1. **开启回调升级**

  * 登录 **[智能多媒体](https://developer.qiniu.com/dora/7514/the-callback-to-upgrade)** ，点击左侧【导航栏->工作流】，进入工作流列表页，点击 **编辑** ，进入工作流编辑页面。

  * 开启 【回调升级】开关键，会提示您升级回调，点击 **确认** 按钮，即可升级成功，升级后不能恢复。

![img](https://dora-doc.qiniu.com/WX20201210-110958.png)

  2. **编辑工作流节点**

  * 当您需要对【工作流->增加处理节点】时，会提示您升级回调，点击 **确认** 按钮，即可升级成功，升级后不能恢复。如果不升级将无法增加处理节点。

![img](https://dora-doc.qiniu.com/WX20201210-112551.png)

以上内容是否对您有帮助？
human: 如何处理七牛云的智能多媒体服务数据处理机制介绍

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > 数据处理机制 >数据处理机制介绍

#  数据处理机制介绍

最近更新时间: 2021-07-22 16:34:34

# 简介

七牛云存储内建了一个非常高效易用的`数据处理框架`。数据处理框架可以对存储在七牛云上的文件执行一系列符合规范的数据处理操作。

**数据处理框架** 对于资源类型没有限制，但是特定的数据处理操作则会有各自适合的处理对象；例如对非图片类型的资源进行缩略图操作，可能会返回错误的结果。

数据处理机制，分为以下三种触发场景：

触发场景 | 处理类别 | 说明  
---|---|---  
访问资源时 | 同步处理 | 只需要在资源URL后加上具体数据操作指令和参数。  
对已有资源，手动触发 | 持久化处理 | 针对已存在空间中的资源手动触发处理流程，与上传时的数据处理支持相同，这个过程也为异步且可查询操作进度。具体请参考[状态查询 __](https://developer.qiniu.com/dora/1294/persistent-processing-status-query-prefop)。  
资源上传时，自动触发 | 持久化处理 | 上传过程中自动触发数据处理，可在上传策略中设置 `persistentOps` 和` persistentNotifyUrl` 字段，在资源上传完成后七牛云存储会以异步的方式执行数据处理操作，并持久化存储数据处理结果。支持查询数据处理操作的进度。具体请参考[状态查询 __](https://developer.qiniu.com/dora/1294/persistent-processing-status-query-prefop)。  
  
下面分别描述这两种数据处理的区别：

  * 同步处理：收到处理请求后立刻进行实时计算并返回处理结果, 适用于计算量较小可以快速返回结果的任务。
  * 持久化处理：收到处理请求后立刻创建一个异步任务并返回该异步任务ID, 该任务会根据调度策略被最终调度执行完毕, 适用于计算量较大需要较长处理时间的任务。

# **同步处理**

适用于计算量较小可以快速返回结果的资源处理场景，使用
[同步处理](https://developer.qiniu.com/dora/api/8266/synchronous-processing)。

# **持久化处理**

适用于计算量较大、处理时间较长的资源处理场景，使用
[持久化处理](https://developer.qiniu.com/dora/api/1291/persistent-data-processing-
pfop)。

# **管道**

数据处理命令后，可以使用 [管道](https://developer.qiniu.com/dora/api/8273/the-pipe)
实现串行处理，即将一个资源经由多个 `<fop>` 串行处理。

# **处理结果另存**

可以通过 [处理结果另存(saveas)__](https://developer.qiniu.com/dora/1305/processing-
results-save-saveas)，实时保存图片到指定空间。

以上内容是否对您有帮助？
human: 如何处理七牛云的智能多媒体服务同步处理

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > 数据处理机制 >同步处理

#  同步处理

最近更新时间: 2021-07-22 16:21:49

# **简介**

**同步处理** ，用于计算量较小可以快速返回结果的资源处理场景，很适合图片资源、文件资源的处理。您可以在 `访问文件URL时`
，添加一个或多个数据处理指令，以直接获取处理后的结果。

  * 比较典型的一个场景是 `图片查看`，客户端可以上传一张高精度的图片，然后在查看图片的时候根据屏幕规格生成缩略图。这样既可以明显降低网络流量，而且可以提高图片显示速度，还能降低移动设备的内存占用。

下面描述同步处理的详细用法。

# **请求报文**

## 请求语法

    
    
    GET <imageDownloadURI>?<接口规格> HTTP/1.1
    Host: <imageDownloadHost>
    

## 头部信息

头部名称 | 必填 | 说明  
---|---|---  
Host | 是 | 下载服务器域名，可为七牛三级域名或自定义二级域名，参考[七牛自定义域名绑定流程 __](https://support.qiniu.com/question/68977)。  
  
# **响应报文**

## 响应语法

    
    
    HTTP/1.1 200 OK
    Content-Type: <imageMimeType>
    
    <imageBinaryData>
    

## 头部信息

头部名称 | 必填 | 说明  
---|---|---  
Content-Type | 是 | MIME类型，成功时为图片的MIME类型，失败时为application/json。  
Cache-Control |  | 缓存控制，失败时为no-store，不缓存。  
  
## 响应内容

  * 如果请求成功，返回图片的二进制数据。
  * 如果请求失败，返回包含如下内容的 JSON 字符串（已格式化，便于阅读）：

    
    
    {
        "code":     <HttpCode  int>, 
        "error":   "<ErrMsg    string>",
    }
    

字段名称 | 必填 | 说明  
---|---|---  
code | 是 | HTTP状态码，请参考响应状态码。  
error | 是 | 与HTTP状态码对应的消息文本。  
  
## 响应状态码

HTTP状态码 | 含义  
---|---  
200 | 处理成功。  
400 | 请求报文格式错误。  
404 | 资源不存在。  
599 | 服务端操作失败。如遇此错误，请将完整错误信息（包括所有的HTTP响应头部）[提交工单 __](https://support.qiniu.com/tickets/category)给我们。  
  
# **示例**

**原图**

    
    
    https://dn-odum9helk.qbox.me/resource/gogopher.jpg
    

![img](https://dn-odum9helk.qbox.me/resource/gogopher.jpg)

**针对该原图生成一张480x320大小的缩略图**

    
    
    https://dn-odum9helk.qbox.me/resource/gogopher.jpg?imageView2/2/w/320/h/480
    

![img](https://dn-
odum9helk.qbox.me/resource/gogopher.jpg?imageView2/2/w/320/h/480)

以上内容是否对您有帮助？
human: 如何处理七牛云的智能多媒体服务闲时任务策略

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > 数据处理机制 >持久化处理（pfop）
>闲时任务策略

#  闲时任务策略

最近更新时间: 2024-04-29 10:45:46

为了高效利用系统资源，形成转码成本的优势，七牛云最新推出的【闲时任务功能】，利用非峰值时间段的机器资源，来处理低实时性的多媒体处理需求，从而实现更低价格，帮助客户将成本降低至普通任务价格的
30%。

# **适用场景**

闲时任务适合所有对多媒体任务处理实时性要求低的场景。

**案例一：某视频网站**

客户积累了大量存量视频，存量视频作为既有文件，对转码处理时间点不敏感。客户采用闲时任务进行「普通转码」和「SDR 转 HDR」功能。

**案例二：某直播平台**

某直播平台开展低实时性在线业务，部分在线视频业务，对部分转码档位处理时间要求较低，客户采用闲时任务进行「音视频拼接」、「视频截图」功能。

**案例三：某海外电商直播企业**

由于时差的关系，闲时时段对应其海外场景中的业务峰值。客户利用闲时转码开展业务，成本降低 70%。

# **注意事项**

当前只有部分多媒体处理支持设置闲时任务，当客户选择闲时任务模式时，该任务会进入序列中等待不定时的空闲机器资源，处理质量与普通任务没有区别。

  1. [普通转码 __](https://developer.qiniu.com/dora/1248/audio-and-video-transcoding-avthumb)（GPU转码不支持）

  2. [锐智转码2.0 __](https://developer.qiniu.com/dora/6097/perceptive-transcoding-avsmart-1)（1.0不支持闲时，如需使用请升级到2.0）

  3. [音视频拼接 __](https://developer.qiniu.com/dora/1246/audio-and-video-stitching-avconcat)

  4. [音视频分段 __](https://developer.qiniu.com/dora/4154/dora-segment)

  5. 视频截图：[视频单帧缩略图 __](https://developer.qiniu.com/dora/1313/video-frame-thumbnails-vframe)、[视频采样缩略图 __](https://developer.qiniu.com/dora/1315/video-sampling-thumbnails-vsample)、[视频雪碧截图 __](https://developer.qiniu.com/dora/12439/video-sprite-screenshots)

# **使用指引**

**Step1：发起任务**

当前仅支持通过调用 API 发起闲时任务的处理请求。

  1. [上传时自动触发 __](https://developer.qiniu.com/dora/1291/persistent-data-processing-pfop)，设置参数`persistentType/1` ，即开启闲时任务
  2. [对已有资源手动触发 __](https://developer.qiniu.com/dora/1291/persistent-data-processing-pfop)，设置参数`type/1`，即开启闲时任务

**Step2：状态通知和查询**

任务处理过程的状态，可通过以下两种方式获取：

  1. **状态通知**

  * 设定 `persistentNotifyUrl` 或者 `notifyURL` 字段，则该URL会收到主动的通知。

  * 服务端完成所有的数据处理后，会以`HTTP POST` 的方式将处理状态发送给用户指定的通知URL。

  2. **状态查询**

  * 方式1：登录【智能多媒体服务控制台】，进入【导航栏->任务】页面，进入任务列表页面，选定 **全部任务类型** 的下拉选框，筛选普通任务、闲时任务进行任务查询。

![img](https://dora-
doc.qiniu.com/%E4%BC%81%E4%B8%9A%E5%BE%AE%E4%BF%A120240423-115936.png)

  * 方式2：开发者可以使用上传时返回的 `persistentId` 来随时查询数据处理的状态。[查询接口 __](https://developer.qiniu.com/dora/1294/persistent-processing-status-query-prefop)：
    
        [GET] http://api.qiniu.com/status/get/prefop?id=<persistentId>  
    

**Step3：用量统计**

  1. 您可以登录 **[智能多媒体服务 -> 概览 __](https://portal.qiniu.com/dora/media-gate/overview?activeTab=%E5%9F%BA%E7%A1%80%E9%9F%B3%E8%A7%86%E9%A2%91%E5%A4%84%E7%90%86&subActiveTab=0&thirdActiveTab=0)**。

  2. 在概览页面进行**资源用量查询** ，选中需要查询的服务类型，再切换普通任务、闲时任务，查看用量数据统计。

![img](https://dora-
doc.qiniu.com/%E9%97%B2%E6%97%B6%E7%94%A8%E9%87%8F%E7%BB%9F%E8%AE%A1.png)

# **定价**

闲时任务定价是普通任务的3折，[点击查看闲时任务定价详情 __](https://www.qiniu.com/prices/dora)。

以上内容是否对您有帮助？
human: 如何处理七牛云的智能多媒体服务管道

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > 数据处理机制 >管道

#  管道

最近更新时间: 2021-07-21 18:27:54

# **简介**

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

**备注** ：

  * 管道数量限制为30个。

# **接口形式**

处理规格如下：

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

  * `<fop>` (File Operation的缩写)，表示数据处理指令及其所需要的参数。
  * 各 `<fop>` 之间用`|`分割，我们称之为`管道`(pipeline)。

可以看到每一步的输出都是下一步的输入，而最后一步的输出即为最终下载到的资源内容。每调用一次这类串行化接口，就必须实时地按序执行所有接口，有可能引起不必要的计算耗时。

# **示例**

将一个原图缩略，然后在缩略图上打上另外一个图片作为水印：

  * **基于原图生成缩略图并打上水印**
    
        https://dn-odum9helk.qbox.me/resource/gogopher.jpg?imageView/2/h/200|watermark/1/image/aHR0cHM6Ly9kb3JhLWRvYy5xaW5pdS5jb20vcWluaXV5dW4ucG5n/ws/0.2
    

![链接](https://dn-
odum9helk.qbox.me/resource/gogopher.jpg?imageView/2/h/200%7Cwatermark/1/image/aHR0cHM6Ly9kb3JhLWRvYy5xaW5pdS5jb20vcWluaXV5dW4ucG5n/ws/0.2)

  * **对音视频进行转码，并对转码后的结果另存**
    
        "persistentOps":"avthumb/mp3/ab/192k|saveas/dGVzdDoxLm1wMw=="
    

​

# **样式别名**

如果觉得 `url?<fop1>|<fop2>|<fop3>|<fopN>` 这样的形式够冗长，还可以为这些串行的 `<fop>`
集合定义一个`样式别名`。如此一来，就可以用友好URL风格进行访问。

我们先来熟悉七牛[qrsctl __](https://developer.qiniu.com/kodo/tools/qrsctl#8)工具的两个命令行：

    
    
    // 定义 url 和数据处理之间的分隔符为 separator 
    qrsctl separator <bucket> <separator>
    
    // 定义数据处理的别名为 aliasName
    qrsctl style <bucket> <aliasName> <fop>
    

例如:

    
    
    // 定义 url 和数据处理之间的分隔符为 "-"
    qrsctl separator <bucket> "-"
    
    // 定义该数据处理样式名为 "iphone" 
    qrsctl style <bucket> "iphone" "imageView/2/h/200|watermark/1/image/aHR0cHM6Ly9vZHVtOWhlbGsucW5zc2wuY29tL3Fpbml1LWxvZ28ucG5n"
    

## **示例**

  * 原始URL
    
        https://dn-odum9helk.qbox.me/resource/gogopher.jpg?imageView/2/h/200|watermark/1/image/aHR0cHM6Ly9vZHVtOWhlbGsucW5zc2wuY29tL3Fpbml1LWxvZ28ucG5n
    

  * 友好风格URL:
    
        https://dn-odum9helk.qbox.me/resource/gogopher.jpg-iphone
    

​

以上内容是否对您有帮助？
human: 如何处理七牛云的智能多媒体服务音视频分段（segment）

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > 音视频处理 >音视频分段（segment）

#  音视频分段（segment）

最近更新时间: 2024-06-28 17:53:36

# **简介**

音视频分段(segment)，用于按时长或时间点对原视频分段，不改变原音/视频的编码格式、分辨率、码率等，将原音/视频切成多个较小的文件。

**注意** ：如果原音视频文件的编码格式无法封装到目标封装格式，那么会返回错误。

# **接口规格**

`segment/<Format>/segtime/<SegmentTime>/pattern/<Pattern>`

参数名称 | 类别 | 必填 | 说明  
---|---|---|---  
`<Format>` | A/V | 是 | 指定分段文件的封装格式，不改变原音/视频的编码情况下可以改变封装格式，如 h264+aac 编码的 mp4文件可以分段为h264+aac 编码的 mkv 小文件。  
`/segtime/<SegmentTime>` | A/V | 否 | 自定义分段后每一小段音/视频流的播放时长。单位为秒，最小值为5，默认值为5。  
`/pattern/<Pattern>` | A/V | 是 | 自定义分段后每一小段音/视频流的文件名称。  
**命名支持魔法变量** ：  
`$(count)`：必填，必须存在的六位占位符数字串，qiniu可以自己定义。  
`$(fname)`：非必填，上传的原始文件名。  
**示例** ：  
源文件名：`file.mp4`，cmd为：`segment/mp4/segtime/10/pattern/cWluaXUtJChmbmFtZSkkKGNvdW50KQ==`，其中
`cWluaXUtJChmbmFtZSkkKGNvdW50KQ==` 是自定义ts文件名，qiniu-$(fname)$(count)
的[URL安全的Base64编码](https://developer.qiniu.com/kodo/manual/appendix#urlsafe-
base64)。最后得到类似：qiniu-file000000.mp4,qiniu-file000001.mp4,…………、qiniu-
filexxxxxx.mp4的小段音视频文件  
  
  
# **示例**

用户可以根据需要自定义命令，例如：

`segment/mp4/segtime/10/pattern/cWluaXUtJChmbmFtZSkkKGNvdW50KQ==`
命令的调用将对原音/视频以10秒左右的时间进行分段，最后将生成多个小段音视频文件。

## **响应内容**

如果请求成功，返回类似如下内容的 JSON 字符串

    
    
    "result": [
        {
            "index": 0,
            "segment_end_time": "10.857422",
            "segment_filename": "qiniu-000000",
            "segment_start_time": "0.000000"
        },
        {
            "index": 1,
            "segment_end_time": "21.177422",
            "segment_filename": "qiniu-000001",
            "segment_start_time": "10.857422"
        },
        {
            "index": 2,
            "segment_end_time": "21.857422",
            "segment_filename": "qiniu-000002",
            "segment_start_time": "21.177422"
        }
    ]
    

# **操作方式**

可以通过 [持久化处理 __](https://developer.qiniu.com/dora/1291/persistent-data-
processing-pfop)的方式来调用：

  * `资源上传时自动触发`：可以在上传时指定[persistentOps](https://developer.qiniu.com/kodo/manual/put-policy#put-policy-persistent-ops-explanation)参数
  * `对已有资源手动手动触发`：调用[pfop __](https://developer.qiniu.com/dora/1291/persistent-data-processing-pfop)命令

# **计费说明**

音视频分段服务涉及转封装但不涉及转码，服务价格=音视频装封装价格，定价参考 [智能多媒体服务定价
__](https://www.qiniu.com/prices/dora)。

以上内容是否对您有帮助？
human: 如何处理七牛云的智能多媒体服务视频单帧缩略图（vframe）

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > 音视频处理 >视频单帧缩略图（vframe）

#  视频单帧缩略图（vframe）

最近更新时间: 2024-06-28 17:22:31

# **简介**

视频单帧缩略图接口(vframe)用于从视频流中截取指定时刻的单帧画面并按指定大小缩放成图片。

# **接口规格**

    
    
    vframe/<Format>
          /offset/<Second>
          /w/<Width>
          /h/<Height>
          /rotate/<Degree>
    

参数名称 | 必填 | 说明  
---|---|---  
`<Format>` | 是 | 输出的目标截图格式，支持`jpg`、`png`等。  
`/offset/<Second>` | 是 | 指定截取视频的时刻，单位：秒，精确到毫秒。  
`/w/<Width>` | 否 | 缩略图宽度，单位：像素（px）  
`/h/<Height>` | 否 | 缩略图高度，单位：像素（px）  
`/rotate/<Degree>` | 否 | 指定顺时针旋转的度数，可取值为`90`、`180`、`270`、`auto`，默认为不旋转。  
  
**注意：**  
1、当指定`w`而不指定`h`时，缩略图的高度将等比缩放；当指定`h`而不指定`w`时，缩略图的宽度将等比缩放。  
2、`w` 与 `h` 中，长边取值范围 [20,3840]，短边取值范围 [20,2160]。

# **操作方式**

  * **API方式** ：  
1）可以通过 [同步处理 __](https://developer.qiniu.com/dora/8266/synchronous-
processing)的方式来调用。

    * **注意** ：建议视频文件不能太大，举例用户设置该接口的超时时间为10s，那么同步处理的视频文件最好不超过450MB ，否则可能会超时导致处理失败。

2）可以通过 [持久化处理 __](https://developer.qiniu.com/dora/1291/persistent-data-
processing-pfop)的方式来调用：

    * `资源上传时自动触发`：可以在上传时指定[persistentOps](https://developer.qiniu.com/kodo/manual/put-policy#put-policy-persistent-ops-explanation)参数
    * `对已有资源手动手动触发`：调用[pfop](https://developer.qiniu.com/dora/1313/video-frame-thumbnails-vframe)命令
  * **控制台方式** ：您可以使用[智能多媒体平台 __](https://portal.qiniu.com/dora/media-gate)，可视化创建任务，使用详情请参考[任务 __](https://developer.qiniu.com/dora/6488/task-01)。

# **示例**

取视频第7秒的截图，图片格式为jpg，宽度为480px，高度为360px：

[资源上传时自动触发](https://developer.qiniu.com/dora/1313/video-frame-thumbnails-
vframe)：上传的`token`中指定`persistentOps`

    
    
    {
          "scope":                "qiniu-ts-demo:thinking-in-go.mp4",
          "deadline":             1390528576,
          "persistentOps":        "vframe/jpg/offset/7/w/480/h/360",
          "persistentNotifyUrl":  "http://fake.com/qiniu/notify"
    }
    

[对已有资源手动触发](https://developer.qiniu.com/dora/1313/video-frame-thumbnails-
vframe)：

    
    
    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=vframe%2fjpg%2foffset%2f7%2fw%2f480%2fh%2f360
    

以 Python Sdk 为例，具体可以看下[音视频转码的示例](https://developer.qiniu.com/dora/api/audio-
and-video-transcoding-avthumb)。需要在音视频转码的示例的基础修改数据处理命令 `fops` ，将其修改为：

    
    
    fops = vframe%2fjpg%2foffset%2f7%2fw%2f480%2fh%2f360
    

**注意** ：其他语言 Sdk 可在[官方 Sdks ](https://developer.qiniu.com/sdk)下载，可以通过查看 Sdk
使用指南中`资源上传时自动触发`，`对已有资源手动触发`使用。

# **计费说明**

视频单帧缩略图，以 **截取图片总张数** 来计量计费。服务价格=视频截图价格，定价参考 [智能多媒体服务定价
__](https://www.qiniu.com/prices/dora)。

以上内容是否对您有帮助？
human: 如何处理七牛云的智能多媒体服务视频色彩增强

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > 画质增强 >视频色彩增强

#  视频色彩增强

最近更新时间: 2024-03-29 16:31:35

# **简介**

**视频色彩增强**
，人眼对色彩是非常敏感，很大程度上会影响用户的主观感受，在色域上增强技术分SDR域和HDR域的算法，比如SDR转HDR、SDR增强等算法，都是对色彩进行处理的算法，实现视频宽色域、高位深、HDR高动态范围等色彩增强。

  * **SDR 增强** ：针对HDR输入视频，转为SDR视频，尽可能保留了HDR的高亮度和宽色域信息，色彩更接近原始HDR视频，提升视频色彩质量。如果不设置SDR增强，会导致转码后丢失HDR色域，导致转码前后色彩差距大。

  * **SDR转HDR** ：基于智能算法将 SDR 视频转换为 HDR 视频，色域提升至BT2020，色深提升至10bit，亮度提升至最高1000nit，从而提升视频的对比度，色彩丰富度，实现更好的视觉效果。

# **应用场景**

  * 视频网站SDR片源色彩优化：对HDR格式尽量保留还原，让视频获得更好的色彩表达与视觉质量提升。

  * 升级HDR电影、电视剧等视频：将SDR格式的电影、电视剧视频，通过基于深度学习的SDR转HDR算法功能，即可获得宽色域、展现更多色彩细节的HDR格式视频。

# **接口规格**

    
    
    avthumb/<format>
           /sdr/<SDR>
           /colorspace/<ColorSpace> 
           /hdr/<HDR>
           /maxLuminance/<MaxLuminance>
           /...
    

参数名称 | 类别 | 必填 | 说明  
---|---|---|---  
`<Format>` | A/V | Y | **封装格式** ，目标音频（比如 mp3 m4a 等）或视频（比如 avi 、flv 、mp4等）格式。具体细节请参考 [支持转换的封装格式 __](https://support.qiniu.com/hc/kb/article/182125/?from=draft)。  
**注意** ：视频编码格式为`libaom-av1`时， 仅支持封装格式为 mp4、mkv、wmv。  
`/sdr/<SDR>` | V | N | **是否启用增强 SDR，设置为 “1” 时开启** 。  
1、当输入源为`HDR`时，设置为 “1” 时，转为SDR视频，不支持hdr的设备上也能尽可能还原hdr效果。  
2、默认关闭，跟随源视频，即hdr到hdr，sdr到sdr。  
**注意** ： 不支持hdr的设备播放hdr视频，没有hdr效果。  
`/colorspace/<ColorSpace>` | V | N | **指定 SDR 的色彩空间** 。  
1、暂时只支持取值 bt709，若不设置则输出的色彩空间同输入源。  
2、若输入源是 HDR 视频，必须设置 `sdr/1` 才会生效。  
`/hdr/<HDR>` | V | N | **是否启用 SDR 转 HDR，设置为 “1” 时开启** 。  
1、当输入源为`SDR`时，设置为 “1” 且指定输出为 H.265 编码时，才能转为 ` HDR` 视频。  
2、不能与锐智转码相关参数（avsmart、smtMaxvbr、smtQuality）和 pixFmt 同时使用。  
**注意** ：使用 SDR to HDR 的收费跟普通转码有区别，请参考 [音视频增强
__](https://www.qiniu.com/prices/dora?source=dora)。  
`/maxLuminance/<MaxLuminance>` | V | N | **设置输出 HDR 视频最大亮度** 。  
1、单位 nit，参数范围 500 nit ~ 1000 nit，默认值为 0，即根据视频内容自适应调整。  
2、必须设置` hdr/1` 才会生效。  
`...` |  |  | 其他参数使用，请参考 [普通音视频转码（avthumb）](https://developer.qiniu.com/dora/api/audio-and-video-transcoding-avthumb)  
  
# **示例**

**1.SDR增强效果**

![img](https://dora-doc.qiniu.com/sdr1.png)

**2.SDR转HDR效果**

![img](https://dora-doc.qiniu.com/hdr1.png)

## 接口响应

锐智转码为异步处理，因此响应分为2步：

  1. 创建异步处理任务，如成功，返回异步处理任务 ID。示例：16864pauo1vc9nhp12;
  2. 返回异步处理结果；

**异步处理返回码** :

返回码 | 含义  
---|---  
0 | 成功。  
1 | 等待处理  
2 | 正在处理  
3 | 处理失败  
4 | 处理成功但通知失败  
  
**注意** ：如果处理失败，可通过 [持久化处理状态查询
__](https://developer.qiniu.com/dora/1294/persistent-processing-status-query-
prefop)查看具体失败原因。

# **操作方式**

  * **API方式** ：可以通过 [持久化处理 __](https://developer.qiniu.com/dora/1291/persistent-data-processing-pfop)的方式来调用：

    * `资源上传时自动触发`：可以在上传时指定[persistentOps](https://developer.qiniu.com/kodo/manual/put-policy#put-policy-persistent-ops-explanation)参数
    * `对已有资源手动手动触发`：调用[pfop](https://developer.qiniu.com/dora/12665/VideoColorEnhancement)命令
  * **控制台方式** ：您可以使用[智能多媒体平台 __](https://portal.qiniu.com/dora/media-gate)，可视化创建任务，使用详情请参考[任务 __](https://developer.qiniu.com/dora/6488/task-01)。

以上内容是否对您有帮助？
human: 如何处理七牛云的智能多媒体服务视频超分

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > 画质增强 >视频超分

#  视频超分

最近更新时间: 2024-08-15 17:21:51

# **简介**

视频超分辨能力可以将输入视频的宽高放大2倍尺寸输出，基于深度学习算法，提高视频的清晰度、画质和主观质量，从而提高播放和观影体验。

## **应用场景**

  * **升级老旧片源** ：针对画质不理想的老片源进行升级，基于深度学习的视频超分辨算法，可将低分辨率的视频，增强转化为高分辨视频。
  * **短视频增强** ：针对低分辨率视频，不适应如今对高分辨率影片的要求，通过视频超分辨算法对影片细节进行增强修复，利用AI模型达到高分辨率输出的同时有效细节更清晰。
  * **视频转清晰度** ：以视频超分辨率重构技术为基础，辅以丰富的图像增强工具，实现标清转高清、高清转 4K 等画质提升应用场景。

## **使用限制**

  * 输入分辨率限制，仅支持小于等于1920x1080
  * 视频输出帧率默认等于源视频帧率，取值范围为[1,60]，超出范围取60帧
  * 当前仅支持 **华东区域** 的资源处理

# **参数说明**

    
    
    aicvt/format/<Format>
         /vcodec/<VideoCodec> 
         /srMode/<SRMode> 
         /superResolution/<SuperResolution> 
    

参数名称 | 类别 | 必填 | 说明  
---|---|---|---  
/format/ | A/V | Y | 必填，输出封装格式，具体细节请参考[支持转换的封装格式 __](https://support.qiniu.com/hc/kb/article/182125/?from=draft)。  
暂不支持m3u8  
/vcodec/ | V | N | 视频编码格式，具体细节请参考[支持转换的视频编码格式 __](https://developer.qiniu.com/dora/kb/1385/avthumb-parameter-vcodec-format-and-explanation)。  
支持使用H.264和H.265编码，默认使用H.264。  
/srMode/ | V | N | 视频超分模式，默认为 ` base` 模式。  
1\. `base`：基础版，稳定的超分辨率效果；  
2\. `faceEnhance`：人脸增强版，采用了独有的人脸增强模块，智能识别并优化人脸区域。  
/superResolution/ | V | N | 开启超分辨率功能（AI功能），取值范围为：[2,3]的整数，按照源视频的宽高2倍或3倍尺寸输出。  
  
# **操作方式**

可以通过 [持久化处理 __](https://developer.qiniu.com/dora/1291/persistent-data-
processing-pfop)的方式来调用：

  * `资源上传时自动触发`：可以在上传时指定 [persistentOps __](https://developer.qiniu.com/kodo/manual/put-policy#put-policy-persistent-ops-explanation)参数
  * `对已有资源手动手动触发`：调用 [pfop __](https://developer.qiniu.com/dora/1246/audio-and-video-stitching-avconcat)命令

# **示例**

  * 以`对已有资源手动触发` 的形式，将thinking-in-go.mov进行视频超分，转化为mp4格式，设置2倍尺寸输出：
    
        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.mov&fops=aicvt/format/mp4/superResolution/2=&notifyURL=http://fake.com/qiniu/notify
    

**注意** ：要在`Authorization`头部的`<AccessToken>`前添加`Qiniu`和半角空格。访问权限，见[管理凭证
__](https://developer.qiniu.com/kodo/manual/access-token)方式。数据处理命令`fops`
，将其设置为：

    
        fops = aicvt/format/mp4/superResolution/2
    

  * 以 `资源上传时自动触发` 形式，将thinking-in-go.mov进行视频超分，转化为mp4格式，设置2倍尺寸输出：
    
         {
          "scope":                "qiniu-ts-demo:thinking-in-go.mov",
          "deadline":             1390528576,
          "persistentOps":        "aicvt/format/mp4/superResolution/2",
          "persistentNotifyUrl":  "http://fake.com/qiniu/notify"
      }
    

**注意** :  
其他语言 Sdk 可在[官方 Sdks ](https://developer.qiniu.com/sdk)下载，可以通过查看 Sdk 使用指南中
`对已有资源手动触发`，`资源上传时自动触发`使用。

# **计费说明**

视频超分定价，参考 [智能多媒体服务定价->画质增强->视频超分 __](https://www.qiniu.com/prices/dora)。

  * 视频超分费用 = 输出文件时长 x 单价。
  * 输出时长：按分钟计费，累计总时长不足一分钟不计费
  * 输出规格按输出视频分辨率的长边和短边属于输出规格划定的范围进行判定，以视频超分输出HD (1920 x 1080) 规格为例： 
    * 输出视频的分辨率长边不大于2560且短边不大于1440，则属于2K输出规格。

以上内容是否对您有帮助？