jancd/qiniu-developer-faq huggingface dataset:
#  DNS 服务器问题确认及修改

最近更新时间: 2018-12-29 15:44:56

## 一，确认是否是DNS问题。

用户出现上传下载慢的问题，可以使用dig命令来检测dns服务器地址是否设置正确。如下图所示，蓝色框中即为dns服务器地址。

![](https://dn-odum9helk.qbox.me/d1879337a0222244cad8fee6e9149776)

把蓝色框中的ip地址放入(<http://www.ipip.net/ip.html> )的搜索框，如下图。

![](https://dn-odum9helk.qbox.me/7b6ce6096376e2c9b7f5c208c0f2636e)

查询到的结果就是你的dns服务器所在的地理位置及运营商。

如果信息显示的城市结果离你很远，或者跨运营商了，就表明dns设置存在问题。

比如，dns 设置为8.8.8.8或114.114.114.114可能会导致cdn网络无法定位你的位置，从而无法选择最优节点。

## 二，修改DNS设置。

确认dns出问题后，登录<http://www.ip.cn/dns.html>

查找你所在地的DNS服务器地址,根据自己的系统参照下面的更改设置方法进行修改：

WIN XP：

<http://jingyan.baidu.com/article/0a52e3f4007606bf62ed7292.html>

Win7：

<http://jingyan.baidu.com/article/f71d60375584591ab641d13c.html>

win8:

<http://jingyan.baidu.com/article/2c8c281df7e5d90009252a6d.html>

win8.1:

<http://jingyan.baidu.com/article/656db9189c6661e381249c84.html>

Windows 10:

<http://jingyan.baidu.com/article/1612d50058aa86e20e1eee96.html>

MAC OS:

<http://jingyan.baidu.com/article/fc07f9891f626712ffe519cf.html>

Unix:

<http://os.51cto.com/art/201004/194716.htm>

linux:

<https://jingyan.baidu.com/article/d3b74d64e80e281f77e609f6.html>

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  常见的证书申请状态有哪些？

最近更新时间: 2017-08-31 16:01:22

# 已完成

证书验证成功并已签发证书，可以使用。

# 域名循环验证中

已提交证书申购，等待用户DNS验证域名所有权。

# DNS验证超时

24小时内没有通过DNS验证。

原因：

  1. 没有进行DNS验证；
  2. TXT解析内容填写错误

# 订单被拒绝/安全审核失败

  * 用户短时间多次提交或重复信息提交订单；
  * 域名中包含非法关键字导致安全审核失败。

# 提交订单审核不通过

  * 域名中含有敏感信息，未通过CA机构的反钓鱼审核，请尝试更换域名。
  * 域名是被列入CA机构黑名单，请尝试更换域名。
  * 相同信息频繁申请或信息不是真实信息，请尝试更换信息。 

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  SSL 证书相关的一些问题

最近更新时间: 2017-08-31 16:00:21

  1. 目前七牛免费证书是 DV 单域名证书，即1个证书对应 1 个域名。不支持多域名和泛域名绑定。
  2. OV 和 EV 证书支持多个标准域名，多个标准域名 + 多个泛域名。但是要激活证书多域名的能力，首次绑定必须 ≥2 个域名。
  3. 申请主域名如 qiniu.com 的 SSL 证书，默认会在证书域名中添加 www 域名如 www.qiniu.com ，因此无需重复申请；
  4. 同样，如果您申请 www 的二级域名，将同时为您添加主域名使用权限。但如果您是申请的三级域名，如 www.abc.qiniu.com ，则只能支持该域名，不会支持 abc.qiniu.com。
  5. 证书过期后怎么办？证书管理中可以查看证书的有效期，当证书快过期时用户可以重新申请证书并绑定域名。免费证书依然免费。（一键续费功能待开放）

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  Symantec 证书为什么相比其他证书要贵一些？

最近更新时间: 2017-08-31 16:02:49

# 原因一

传输层加密仅仅是 SSL 证书的作用之一；SSL 证书更主要的用处其实在于验证网站及其背后企业的真实性以及合法性。

  * 更贵的 SSL 证书的验证过程通常更加严谨。DV（Domain Validation）级别的证书（如你提到的 GeoTrust QuickSSL）在签发之前只会验证你对域名的使用权，并不对域名使用者本身进行任何验证。而更高端一点的 OV（Organization Validation）会验证域名背后的公司 / 组织的真实性和合法性（个人用户通常是无法获得 OV 证书的）。并且和 DV 不同，OV 证书签发之前是需要 paperwork 的，需要提交相关的证明、执照等材料。过程更复杂、签发更严谨，价格自然就更高。
  * 另外，你购买证书时往往还同时为顾客购买了一份保险（warranty）：如果由于 CA 的失误给一个诈骗 / 非法的公司或组织颁发了证书，并且顾客在这种网站上消费造成了财产损失，CA 会在一定程度上对顾客进行赔付。不同价格的证书的赔付额度差异很大，条款亦可能有所不同。例如 RapidSSL 的保额为 $10,000 美元，而 Symantec Secure Site Pro 则为 $1,750,000 美元。
  * 总结：购买 SSL 证书时所付出的成本除了用于加密之外，其实更多的是为了让访客相信你的网站是合法的、可信赖的。

# 原因二

比较价格的时候，只考虑外观效果（绿锁）和加密强度这两个因素是不完全的，其他因素：

  * 证书的适用范围、功能、有效期
  * 颁发公司的公信力
  * 证书这种东西，信任链的顶层就是颁发公司，知名公司的信用当然比一个名不见经传的小公司值钱得多
  * 颁发公司对证书密钥的保护能力
  * 服务条款的差别
  * 证书维护、更新、废弃，担保、赔偿

# 原因三

证书不仅是加密用的，也是身份的证明。一个信任的CA颁发的证书，证明效力就要比不信任的CA颁发的证书更好。贵的证书也是这样，它的证明效力，要比便宜的证书多很多的。

# 原因四

付费证书的价值在于其签名，签名意义在于标示你是可信的服务方而非伪造的钓鱼者。另外赛门铁克 pro 系列证书除支持 RSA 算法外还支持 ECC 算法。

# 原因五

另外 单纯从技术角度，symantec和 GeoTrust 的区别如下：

  * 算法支持上 Symantec（支持RSA DSA ECC三种算法）Geotrust（支持RSA DSA两种算法）
  * 兼容性 Symantec > Geotrust ； Symantec（原verisign）可兼容市面上所有的浏览器，对移动端的支持也是最好的
  * OCSP 响应速度：Symantec > Geotrust 
  * CA 安全性 方面 Symantec > Geotrust ，symantec是国际知名安全厂商，CA的安全级别也是国际第一的安全系数。
  * Symantec 证书除实现加密传输以外，还另外有恶意软件扫描和漏洞评估的附加功能。GeoTrust证书没有
  * Symantec对证书有商业保险赔付保障，金额最高为175万美金，GeoTrust最高为150万美金

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  证书链是什么？

最近更新时间: 2017-05-24 14:18:39

  * 完整的证书内容一般分为3级，服务端证书-中间证书-根证书，即 end-user certificates， intermediates Certificates 和 root Certificates。

    * end-user ：用来加密传输数据的公钥的证书，是https中使用的证书。开发者牛小七把证书部署在qiniu.com 的服务器上。
    * intermediates：CA用来认证公钥持有者身份的证书，即确认https使用的end-user证书是属于qiniu.com的证书。
    * root：用来认证intermediates证书是合法证书的证书。
  * 简单来说，end-user证书上面几级证书都是为了保证end-user证书未被篡改，保证是CA签发的合法证书，进而保证end-user证书中的公钥未被篡改。我们使用end-user certificates来确保加密传输数据的公钥(public key)不被篡改，而又如何确保end-user certificates的合法性呢？这个认证过程跟公钥的认证过程类似，首先获取颁布end-user certificates的CA的证书，然后验证end-user certificates的signature。一般来说，root CAs不会直接颁布end-user certificates的，而是授权给多个二级CA，而二级CA又可以授权给多个三级CA，这些中间的CA就是intermediates CAs，它们才会颁布end-user certificates。

  * 七牛云证书管理，会在用户上传证书的时检测证书的完整性，证书链不完整会自动帮用户补全证书链，但无法保证补全的证书链100%是正确的。所以需要用户选择使用自传的证书还是系统补全后的证书。

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  postman 调试接口

最近更新时间: 2017-08-22 15:38:03

调试表单上传方法

  1. [表单上传](https://developer.qiniu.com/kodo/manual/1272/form-upload)   

  2. 表单上传必须的三个元素 上传 host 、文件本身以及上传 token   

  3. 不同区域存储空间对应的 host 不同，[参考文档](https://developer.qiniu.com/kodo/manual/1671/region-endpoint)   

  4. 上传 token 生成，[参考文档](https://developer.qiniu.com/kodo/manual/1208/upload-token)
  5. 打开 postman ,输入下图中指定内容

![](https://dn-odum9helk.qbox.me/FnXLVAL94YjZaYrmnIYyAoIHZ0sG)

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  域名已经做解析如何通过验证

最近更新时间: 2018-01-25 17:41:54

# 域名解析方法

解决方法：在验证域名前加上 `_dnsauth`。

以 jsdemo.gugaobai.top 为例，如果做了 A 记录解析或者 cname 解析，有些域名商是不可以同时再做 TXT 解析的  
此时解析 _dnsauth.jsdemo.gugaobai.top 这个域名也可以通过验证

![](https://dn-odum9helk.qbox.me/FhkyxbjBaqWbkIe4hSUsf4PXnXzp)

  

证书签发后可以下载至本地使用

![](https://dn-odum9helk.qbox.me/FmM6dXiGoEt5JV9rlNd5eMkpIs29)

# 文件验证方法

### 1\. 补全证书信息时选择文件验证

![](https://dn-odum9helk.qbox.me/FqWeQfcgd88sakOv5oA8CFj-ulAa)

### 2\. 获取验证信息

![](https://dn-odum9helk.qbox.me/FtqdhfSBolTtKNhHGw6hAzx0kiA9)

### 3\. 本地生成一个名为 fileauth.txt 的文件，内容为上面的txt记录值

![](https://dn-odum9helk.qbox.me/Fq611qROCWzUcyE8Hcu_kEns9RIj)

### 4\. 上传至域名对应的七牛空间（或者用户自己的服务器），设置前缀为记录名（如 .well-known/pki-validation/）

![](https://dn-odum9helk.qbox.me/FnaDaIjTkFFOYfa6mXS705OvFFap)

### 5\. 确认文件上传成功

![](https://dn-odum9helk.qbox.me/FhQrSm6KUTtMSDbA2WUuX8q184iF)

![](https://dn-odum9helk.qbox.me/FlNY4XOIFd5MJJsbpZpfzaSgjU7A)

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  SSL证书申请未通过 CA 机构审核

最近更新时间: 2017-09-18 18:13:45

在七牛申请 ssl 证书，申请失败的订单，可以将鼠标放在订单状态后的圆形提示图表，看到失败原因的简短说明：  
![](https://dn-odum9helk.qbox.me/Fn3Qv5EcV2mLPQla0v6hQQdGbMEN)  
若提示 “CA 审核不通过” 最有可能是由于您的域名中包含 CA 所不允许的某些敏感词，而敏感词列表，CA 并未透露给七牛。  
根据以往经验，我们总结了一些会导致审核失败的敏感词:

  * live（不包含 .live 顶级域名）
  * bank
  * banc
  * ban.c
  * alpha
  * test
  * example
  * credit
  * 内、外网IP地址
  * 主机名
  * pw（包含 .pw 顶级域名）
  * apple
  * ebay
  * trust
  * root
  * amazon
  * android
  * visa
  * google
  * discover
  * financial
  * wordpress
  * pal
  * hp
  * lv
  * free 

根据 CA 中心的建议，出现这种情况可以选择：

  * 使用不含以上敏感词的域名绑定免费证书 
  * 购买付费性数字证书来绑定域名 

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  cdn 日志下载全选

最近更新时间: 2019-06-04 12:08:21

**Q: cdn 日志下载全选但是为什么只下载了第一个？**  
**A:**
当浏览器检测到非用户操作产生的新弹出窗口，则会对其进行阻止。因为浏览器认为这可能是一个广告，不是一个用户希望看到的页面。所以当下载全选的时候，会出现类似拦截窗口的界面  
  
  
  
![](https://dn-odum9helk.qbox.me/FpoAheeo1UzIqsxshycoNNI1o7xF)  
  
  
  
点解拦截按钮，然后允许弹出窗口访问即可

![](https://dn-odum9helk.qbox.me/FodNZfkPD-Xh8oXJJsq6ZhIXh9ke)

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  常见问题 - 未备案冻结域名

最近更新时间: 2020-02-14 16:59:14

# 简介

在域名备案被工信部吊销后，七牛将会对您的域名进行冻结，本文列出了部分您可能需要了解的问题。

Q：未备案冻结的域名如何解冻？

Q：如何查询备案？

Q：域名之前备案过了还会因为未备案冻结？

Q：备案吊销后如何处理？

Q：某些工具可以查询到备案，但还是被冻结了？  
  
如果本文仍然无法解决您的问题，您也可以通过 **[工单系统](https://support.qiniu.com/tickets/new)**
将您的问题反馈给我们。

* * *

# Q：未备案冻结的域名如何解冻？

备案完成后，可以先在「**[域名信息备案管理系统](http://beian.miit.gov.cn/publish/query/indexFirst.action)**
」查询备案是否已经公示，确认已经公示后，在 **七牛开发者平台** 页面选择
[**CDN**](https://portal.qiniu.com/cdn/overview) ，选择
[**域名管理**](https://portal.qiniu.com/cdn/domain) ，点击您需要解冻域名后的 **解冻**
字样，即可发起解冻任务。备案完成后，工信部一般会延迟1个工作日左右进行公示，解冻域名将以实际公示情况为准。  
  
![](https://dn-odum9helk.qbox.me/FnOXskzkK4SgtUiQrgcw_bBrRUm6)

# Q：如何查询备案？

您可以通过「[**域名信息备案管理系统**](http://beian.miit.gov.cn/publish/query/indexFirst.action)」对备案信息进行查询。  
查询方式：左侧「公共查询」-「备案查询」-「备案信息查询」，在网站域名处输入您的备案主域名，正确验证码后点击提交，如果域名没有备案信息，会提示`「没有符合条件的记录」`。  
  
![](https://dn-odum9helk.qbox.me/FoezLDYDG7V8oo-o76o0P11FAE3t)

# Q：为什么域名之前备案过了还会被未备案冻结？

  
备案吊销是指对备案信息做收回并注销，由有管辖权力的部门停止原来准许进行某项活动的对象停止该项活动并收回准许文本的执行过程，一般带有强制性。起因基本是由于该对象违背或违反了发放文本时的约定所致，七牛检测到备案信息失效后，会对域名执行冻结操作。

# Q：备案吊销后如何处理？

  
确认备案被吊销后，您可以在原域名备案处，重新进行备案。

# Q：某些工具可以查询到备案，但还是被冻结了？

网络上的备案查询工具都有一定的延迟，需要以工信部官网的公示结果为准，查询方式参考「如何查询备案」。

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  账单问题 - 存储CDN回源流出流量

最近更新时间: 2019-12-11 17:40:10

# 问：账单中「标准存储CDN回源流出流量」是什么含义？

答：  
下图为CDN访问的简化流程图，后续步骤号码将对应流程图中标号。  
![](https://dn-odum9helk.qbox.me/FlzgLWCIX8jz_s2Ua41TjYP-HzAN)

## 场景1：CDN节点「**没有缓存** 」时，需要回源站拉取资源并缓存，访问步骤为：

1： 客户访问端发送访问请求到CDN节点。  
2： CDN节点进行回源，发送请求到七牛云存储。  
3： 七牛云存储返回数据给CDN节点。  
4： CDN节点缓存数据，并由CDN返回数据给客户端。  
计费说明：该过程中，产生的计费项目为流程 3 产生的**存储CDN回源流出流量** \+ 流程 4 产生的**CDN访问流量** 。

## 场景2：CDN节点「**有缓存** 」时，访问步骤为：

1： 客户访问端发送访问请求到CDN节点。  
4： CDN节点返回数据给客户端。

计费说明：该过程中，产生的计费项目为流程 4 产生的**CDN访问流量**
。所以，并不是每次请求都会产生这两项计费。如果CDN有缓存没有进行回源，就不会产生**存储CDN回源流出流量** 。

* * *

# 问：如何区分 存储CDN回源流出流量 和 CDN访问流量 呢？

答：**存储CDN回源流出流量** 是由七牛的存储机房流出的流量（流程3），**CDN访问流量** 是由CDN节点流出的流量（流程4）。

* * *

# 问：为什么账单中 存储CDN回源流出流量 比 CDN访问流量 还高呢？

答：CDN回源流出流量高的可能原因有

  1. 业务主要是视频业务，但是创建域名时域名场景选择了网页平台，下载时边下边播，回源时完整回源，导致即使只观看一小部分，也会产生完整的回源流量费用。`建议空间可以绑定不同域名，视频业务使用点播平台域名播放`，域名场景不影响使用，但会针对特定场景有一定的优化。
  2. 资源访问时，如果`每次都带了不同的query参数`，或者`把缓存时间设置非常小`，会导致强制CDN节点回源，所以每次访问都会产生了**存储CDN回源流出费用** 。

* * *

# 问：可以关闭存储CDN回源流出流量吗？

答：不能，CDN节点至少需要有1次回源拉取行为才能完成缓存，在此过程中存储产生的流量都需要进行计费。

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  常见问题 - CDN功能咨询

最近更新时间: 2019-12-31 16:33:12

# 简介

七牛默认使用 CDN 域名访问存储资源，如果您正在使用 CDN 产品，可能会涉及到资源的缓存/预取问题，本文列出了部分您可能需要了解的问题列表。

Q：CDN 是否支持 websocket 加速？  
Q：CDN 是否支持 HTTP2 访问？  
Q：微信小程序要求的 TLS 版本必须大于等于1.2怎么处理？  
Q：CDN是否支持 Gzip 处理？  
Q：CDN 支持 指定端口访问 吗？  
Q：CDN 支持 海外访问加速 吗？

  
如果本文仍然无法解决您的问题，您也可以通过 **[工单系统](https://support.qiniu.com/tickets/new)**
将您的问题反馈给我们。

* * *

  
**Q:CDN 是否支持 websocket 加速？**  
暂不支持 websocket 加速。

  
**Q:CDN 是否支持 HTTP2 访问？**  
支持，在 控制台 - CDN - 域名管理 中，修改 https 配置可以开启 http2 访问。

  
**Q:微信小程序要求的TLS版本必须大于等于1.2怎么处理？**  
域名需要先开启 HTTPS，然后开启 HTTP 2 功能，HTTP 2.0 默认使用 TLS1.2 及以上版本。

  
**Q:CDN 是否支持 Gzip 处理？**  
支持。

  
**Q:CDN 支持指定端口访问吗？**  
CDN 域名仅支持默认的 80/443 端口访问，不支持自定义端口访问，但是 CDN 配置回源时，支持回源到您的服务器的指定端口。

  
**Q:CDN 支持支持海外访问加速吗？**  
支持，您可以在创建域名时，选择覆盖范围为 海外/全球 ，如果您的域名已经创建，您可以通过
**[工单系统](https://support.qiniu.com/tickets/new)** 反馈给我们，我们将在后台为您修改。  
大陆：仅使用国内的加速节点，海外用户访问将被调度到国内节点。  
海外：仅使用海外的加速节点，国内用户访问将被调度到海外节点。  
全球：使用覆盖全球的加速节点，根据用户所在位置自动调度到最优加速节点。

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  常见问题 - 缓存刷新/资源预取

最近更新时间: 2020-07-13 11:22:42

# 简介

七牛默认使用 CDN 域名访问对象存储资源，如果您正在使用 **对象存储 / CDN 产品**
，可能会涉及到资源的缓存/预取问题，本文列出了部分您可能需要了解的问题列表。

Q：资源已经在源站删除，为什么还能访问？

Q：资源已经覆盖/重新上传，为什么还能访问到旧文件？

Q：如何刷新 CDN 缓存？

Q：刷新文件 和 刷新目录 分别是什么含义？

Q：刷新 和 文件预取 有什么区别？

Q：如何修改缓存时间？

Q：为什么已经上传的文件有时会出现404，等待一段时间就会正常？

Q：CDN 节点的缓存会实时和源站同步更新吗？

Q：如何查看刷新任务是否处理成功？

Q：为什么刷新任务已经执行成功，还是访问到旧缓存？

Q：CDN 访问为什么会存在缓存问题？  
  
如果本文仍然无法解决您的问题，您也可以通过 **[工单系统](https://support.qiniu.com/tickets/new)**
将您的问题反馈给我们。

* * *

  
**Q:资源已经在源站删除，为什么还能访问？**  
当前访问到了该资源在 CDN 节点的缓存。  
资源从源站删除之后，缓存仍然会在 CDN 节点保存，所以用户仍然可以访问到，需要刷新 CDN 缓存。  
说明：如果您使用了七牛的对象存储，默认绑定CDN加速域名，如果需要刷新缓存，请参考文档[刷新缓存的方法](https://developer.qiniu.com/fusion/kb/1325/refresh-
the-cache-and-the-effect-of-time)

  
**Q:资源已经覆盖/重新上传，为什么还能访问到旧文件？**  
当前访问到了旧文件在 CDN 节点的缓存。  
在源站某个资源的内容变更之后，旧缓存仍然会在 CDN 节点保存，刷新 CDN 缓存即可重新回源获取资源。  
说明：如果您使用了七牛的对象存储，默认绑定CDN加速域名，如果需要刷新缓存，请参考文档[刷新缓存的方法](https://developer.qiniu.com/fusion/kb/1325/refresh-
the-cache-and-the-effect-of-time)

  
**Q:如何刷新 CDN 缓存？**  
刷新缓存方法请参考文档[刷新缓存的方法](https://developer.qiniu.com/fusion/kb/1325/refresh-the-
cache-and-the-effect-of-time)  
方法1: portal.qiniu.com 控制台刷新缓存，点击左侧 cdn — 刷新预取  
方法2: api 接口地址：<https://developer.qiniu.com/fusion/api/1229/cache-refresh>  
方法3: qshell命令行工具：<https://developer.qiniu.com/kodo/tools/1302/qshell>

  
**Q: 刷新文件 和 刷新目录 分别是什么含义？**  
缓存刷新分为 刷新文件 和 刷新目录。

  * 刷新文件：是以单条url为单位进行缓存刷新。
  * 目录刷新：是以目录为单位，将该域名对应目录下的所有文件进行缓存刷新。

  
**Q: 刷新 和 文件预取 有什么区别？**  
刷新的含义为清空缓存，预取的含义为主动进行缓存

  * 刷新后，所有 CDN 节点上对应的资源缓存失效，用户再次触发访问时，CDN 节点将执行回源拉取，刷新操作用于文件更新或删除后，保证用户能访问到最新资源。
  * 预取后，资源将被主动缓存到 CDN 节点，用户通过 CDN 访问对应预取过的资源时，不需要重复回源，可以提升用户的访问速度。

  
**Q:如何修改缓存时间？**  
如果需要部分前缀或后缀文件不缓存，可以在控制台-
域名管理中，修改该域名的缓存配置为自定义，根据您的业务需求设置缓存时间。修改完成后，节点对新的缓存将会依据配置进行，如需清空旧配置情况时已触发的缓存，可以尝试刷新目录缓存。

  
**Q:为什么已经上传的文件有时会出现404，等待一段时间就会正常？**  
如果在文件上传完成之前触发访问，会报错 404 ，404 默认会缓存 10 秒左右，如果重复请求该资源，会在上传完成后 10 秒内访问正常.

  
**Q:CDN 节点的缓存会实时和源站同步更新吗？**  
CDN 缓存更新依赖主动触发刷新任务，或者根据控制台配置的缓存有效时间，过期后重新回源拉取，默认情况下不会主动更新。

  
**Q:如何查看刷新任务是否处理成功？**  
方法1:可以在控制台 - cdn - 刷新预取 - 操作记录中查看  
方法2:调用CDN的接口查询，文档参考 [刷新查询](https://developer.qiniu.com/fusion/api/1229/cache-
refresh#4).

  
**Q:提交任务报错 [403023] urls admin submitted belong to more than one user**  
提交刷新/预取任务的域名必须是当前账户在 CDN 域名管理中已经创建的域名，无法刷新其他账户或未创建的域名.

  
**Q:为什么刷新任务已经执行成功，还是访问到旧缓存？**  
1\. 检查本地浏览器缓存是否清空，可以尝试更换浏览器或者无痕模式。  
2\. 确认下访问 URL 是否携带了其他参数，刷新时是否连带参数进行刷新。  
3\. https 和 http 部分场景下独立缓存，如果之前刷新的是 https 链接，并且用 http 访问过该资源，可以再尝试刷新 http
的链接试下。

  
**Q:CDN 访问为什么会存在缓存问题？**  
CDN 服务利用多级缓存原理进行加速，所以通过 CDN 的访问默认都会被缓存。

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  未备案域名访问限制

最近更新时间: 2020-06-29 10:37:47

七牛 CDN 支持为海外业务客户提供加速服务，但对于未备案域名访问有以下限制。

## 国内 ip 无法访问未备案域名

对于海外未备案域名，七牛 CDN 可提供在纯海外区域（不含中国大陆）的加速访问；但受到相关监管规则限制，目前国内 ip 默认无法访问未备案的海外加速域名。  
如果实际业务需要域名可被国内 ip
访问，建议您在[工信部域名信息备案管理系统](http://beian.miit.gov.cn/state/outPortal/loginPortal.action)进行备案，然后重新将域名配置为全球加速。  
![](https://dn-odum9helk.qbox.me/FjbnY1GsizDDg72obPo3IzlA2uYz)

如有其他配置需求，可联系七牛销售进行申请和业务审核。

## 备案吊销情况说明

原有已备案的纯海外加速域名如果备案被吊销，七牛将同样禁止国内 ip 访问。因此对于有备案的海外加速域名，强烈建议转为全球加速区域。

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  检测到域名源站发生改变，需重新修改回源鉴权配置

最近更新时间: 2020-12-11 09:45:34

# 一、提示“检测到域名源站发生改变，需重新修改回源鉴权配置”原因

当“私有空间”切换为“公开空间”时，『七牛控制台』-『CDN』-『域名管理』-『配置』界面提示“**检测到域名源站发生改变，需重新修改回源鉴权配置** ”

![](https://dn-odum9helk.qbox.me/FrlOz7pZBpZtDlaSdEeJT4dzq7sbe)  
  

# 二、如何去掉这行红字？

1、找到『回源鉴权』，点击『修改配置』

![](https://dn-odum9helk.qbox.me/FoeTFqrReu5J5Atcq_5yqZu0mw2q)  
  

2、找到『开启』，点击一下，让其变成『关闭』状态

![](https://dn-odum9helk.qbox.me/FpmKTchI432sCr_aYaDRY-n9dsqb)  
  

3、点击『确认』，点击之后，域名会自动处理，一般在 15 - 20 分钟内会处理完成

![](https://dn-odum9helk.qbox.me/FszcsB8cHgEsg2QgiUW-CV-Vsbo)  
  

> **如果长时间验证不通过，建议拨打 400-808-9176 转 2 号线，联系技术支持处理。**

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  监测到域名源站在七牛私有 BUCKET，建议打开回源鉴权功能

最近更新时间: 2020-12-11 09:46:06

# 一、提示“监测到域名源站在七牛私有 BUCKET，建议打开回源鉴权功能”原因

当“公开空间”切换为“私有空间”时，『七牛控制台』-『CDN』-『域名管理』-『配置』界面提示“**监测到域名源站在七牛私有
BUCKET，建议打开回源鉴权功能。** ”

![](https://dn-odum9helk.qbox.me/Fr12swz7pZBpZtDlaSdEeJT4dzq7)  
  

# 二、如何去掉这行提示？

1、找到『回源鉴权』，点击『修改配置』

![](https://dn-odum9helk.qbox.me/F23ifoeTFqrReu5J5Atcq_5yqZu)  
  

2、找到『关闭』，点击一下，让其变成『开启』状态

![](https://dn-odum9helk.qbox.me/Fszcsdenjg45g2QgiUW-CV-Vsbo)  
  

3、点击『确认』，点击之后，域名会自动处理，一般在 15 - 20 分钟内会处理完成

![](https://dn-odum9helk.qbox.me/Fpmdhcnfe432sCr_aYaDRY-n9d)  
  

> **如果长时间验证不通过，建议拨打 400-808-9176 转 2 号线，联系技术支持处理。**

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  如何自主切换域名覆盖范围？

最近更新时间: 2020-12-11 09:45:05

### **自 2020年10月20日 起，『七牛控制台』-『域名管理』目前已支持用户自主切换域名覆盖区域（中国大陆、全球、海外）**

  

1、在『域名管理』-『配置』界面，点击『修改』按钮  
![](https://dn-odum9helk.qbox.me/FmPqEExrLha1-mg6BFhBcAW3tNbZ)  
  

2、选择好“服务区域”后，点击『确认』，点击之后域名会自动处理，一般在 15 - 20 分钟内会处理完成  
![](https://dn-odum9helk.qbox.me/FvetdDsW6y836y3V7PuI29O5431W)  
  

> **注意**  
>  以下两种情况暂不支持『七牛控制台』自主切换：
>
>   1. 对于未备案域名不能从海外加速切换至全球或国内
>   2. 特殊计费方式的域名需要联系技术支持说明情况后，由七牛技术支持操作
>

> **如果长时间验证不通过，建议拨打 400-808-9176 转 2 号线，联系技术支持处理。**

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  如何查询CDN资源访问量？

最近更新时间: 2021-01-06 16:11:33

Q1: 如何查询访问量最大的CDN资源？  
---  
可以在 [**七牛控制台 - 访问分析**
__](https://portal.qiniu.com/cdn/statistics/log/access)界面查询 top100
资源URL，操作详情参考：[**统计分析** __](https://developer.qiniu.com/fusion/3846/data-
statistics-fusion)  
  
  

Q2: 如何查询每个资源的访问量和访问次数？  
---  
查询每个资源的访问量和访问次数，需要您下载CDN日志，根据CDN日志自己统计分析下。  
CDN日志下载方式：  
1\. 在 [**七牛控制台** __](https://developer.qiniu.com/fusion/manual/3847/cdn-log-
fusion)下载。  
2\. 调用 [**API接口** __](https://developer.qiniu.com/fusion/api/1226/download-
the-log)下载。  
  
以上内容是否对您有帮助？

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  CDN 下线或冻结域名解析逻辑变更

最近更新时间: 2021-09-23 18:19:58

# 背景

由于近期出现不法分子通过七牛 CNAME 域名传播违规资源的情况，受相关信息监管部门要求，七牛 CDN 将调整用户主动操作下线或欠费冻结后的域名解析逻辑。

# 调整说明

2021年10月10日之前，用户主动下线或欠费冻结加速域名后，加速域名会被解析回用户源站。为避免相关合规风险，自2021年10月11日起，**下线或欠费冻结的域名会解析至不可用地址。**  
因此，在用户主动下线或欠费冻结之后，将无法通过加速域名访问源站内容。

# 应对方案

若希望在域名下线后，可以继续通过加速域名访问源站，可自行修改 DNS 配置，将加速域名的 CNAME 记录指向您的源站即可。  
![image.png](https://dn-odum9helk.qbox.me/FkdTbkIRsyswhwY-mm-9X12NDtqY)

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  persistent ID 的常见问题

最近更新时间: 2023-09-01 16:05:24

# **什么是 persistent ID？**

七牛给每个 [持久化处理](https://developer.qiniu.com/dora/manual/3686) 作业，都会分配一个唯一的 ID
，用来记录和查询。

# **如何获取 persistent ID？**

使用 [持久化处理 API 接口](https://developer.qiniu.com/dora/manual/1291)
提交请求，可以在返回信息中得到 persistent ID 。

# **任务查询方式**

通过【API创建的任务】，用户可以使用以下3种方式进行查询：

  1. 通过任务查询接口，发起查询请求。

  2. 登录 proral ，在任务列表中进行查询。

  3. 创建任务时，设置回调地址，七牛将会向你设置的 URL 发起 `Content-Type: application/json` 的 POST 请求。请参考[持久化处理结果通知 __](https://developer.qiniu.com/dora/api/1294/persistent-processing-status-query-prefop)。

# **任务查询API**

## 接口规格

    
    
    <persistentId>
    

参数名称 | 必填 | 说明  
---|---|---  
| 是 | 上传预处理或持久化处理接口返回的`<persistentId>`。  
  
使用 [持久化处理作业查询](https://developer.qiniu.com/dora/manual/1294) 服务，具体方法是浏览器地址栏输入
https://api.qiniu.com/status/get/prefop?id= 后跟 persistent ID 。

# **控制台查询**

登录【智能多媒体控制台】，进入【导航栏->任务】页面，进入 [任务列表 __](https://portal.qiniu.com/dora/media-
gate/task)页面。

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

> **查询条件说明：**
>
>   * 切换区域
>
>     * 任务资源所属区域：**华东、华北、华南、东南亚、北美**
>   * 按时间查询
>
>     * 当前支持查询 **近7天** 的任务
>
>     * 选择队列：任务执行的队列
>
>     * 选择区域：任务资源所属区域
>
>     * 选择任务状态：
>
> **全部、成功、失败、处理中、已提交、已取消** （当用户删除pipeline时，并且有任务还在等待中）
>
>   * 按任务ID查询
>
>     * 输入任务ID，进行精确匹配查询
>

>
> **搜索结果说明：**
>
>   * 对应查询条件以列表形式展示任务信息：任务ID、资源名称、状态、队列。
>   * 点击【加载更多】，展示更多任务。
>

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  avthumb参数vcodec格式及解释

最近更新时间: 2023-08-30 14:19:49

http://developer.qiniu.com/code/v6/api/dora-api/av/avthumb.html

## 参数`/vcodec/<VideoCodec>`：视频编码方案，支持方案：libx264 ，libvpx ，libtheora ，libxvid
，libvpx-vp9 等。

videoEncoders | description  
---|---  
a64multi | Multicolor charset for Commodore 64 (codec a64_multi)  
a64multi5 | Multicolor charset for Commodore 64, extended with 5th color (colram) (codec a64_multi5)  
amv | AMV Video  
asv1 | ASUS V1  
asv2 | ASUS V2  
avrp | Avid 11 10-bit RGB Packer  
avui | Avid Meridien Uncompressed  
ayuv | Uncompressed packed MS 4444  
bmp | BMP (Windows and OS/2 bitmap)  
cljr | Cirrus Logic AccuPak  
dnxhd | VC3/DNxHD  
dpx | DPX image  
dvvideo | DV (Digital Video)  
ffv1 | FFmpeg video codec # 1  
ffvhuff | Huffyuv FFmpeg variant  
flashsv | Flash Screen Video  
flashsv2 | Flash Screen Video Version 2  
flv | FLV / Sorenson Spark / Sorenson H.263 (Flash Video) (codec flv1)  
gif | GIF (Graphics Interchange Format)  
h261 | H.261  
h263 | H.263 / H.263-1996  
h263p | H.263+ / H.263-1998 / H.263 version 2  
libx264 | libx264 H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10 RGB (codec h264)  
libx265 | libx265 H.265 / AVC / MPEG-4 AVC / MPEG-4 part 10 RGB (codec h265)  
libaom-av1 | Alliance for Open Media AV1  
huffyuv | Huffyuv / HuffYUV  
jpeg2000 | JPEG 2000,  
jpegls | JPEG-LS  
ljpeg | Lossless JPEG  
mjpeg | MJPEG (Motion JPEG)  
mpeg1video | MPEG-1 video  
mpeg2video | MPEG-2 video  
mpeg4 | MPEG-4 part 2  
libxvid | libxvidcore MPEG-4 part 2 (codec mpeg4)  
msmpeg4v2 | MPEG-4 part 2 Microsoft variant version 2  
msmpeg4 | MPEG-4 part 2 Microsoft variant version 3 (codec msmpeg4v3)  
msvideo1 | Microsoft Video-1  
pam | PAM (Portable AnyMap) image  
pbm | PBM (Portable BitMap) image  
pcx | PC Paintbrush PCX image  
pgm | PGM (Portable GrayMap) image  
pgmyuv | PGMYUV (Portable GrayMap YUV) image  
png | PNG (Portable Network Graphics) image  
ppm | PPM (Portable PixelMap) image  
prores | Apple ProRes  
prores_aw | Apple ProRes (codec prores)  
prores_ks | Apple ProRes (iCodec Pro) (codec prores)  
qtrle | QuickTime Animation (RLE) video  
r10k | AJA Kona 10-bit RGB Codec  
r210 | Uncompressed RGB 10-bit  
rawvideo | raw video  
roqvideo | id RoQ video (codec roq)  
rv10 | RealVideo 1.0  
rv20 | RealVideo 2.0  
sgi | SGI image  
snow | Snow  
sunrast | Sun Rasterfile image  
svq1 | Sorenson Vector Quantizer 1 / Sorenson Video 1 / SVQ1  
targa | Truevision Targa image  
libtheora | libtheora Theora (codec theora)  
tiff | TIFF image  
utvideo | Ut Video  
v210 | Uncompressed 422 10-bit  
v308 | Uncompressed packed 444  
v408 | Uncompressed packed QT 4444  
v410 | Uncompressed 444 10-bit  
libvpx | libvpx VP8 (codec vp8)  
libvpx-vp9 | libvpx VP9  
wmv1 | Windows Media Video 7  
wmv2 | Windows Media Video 8  
xbm | XBM (X BitMap) image  
xface | X-face image  
xwd | XWD (X Window Dump) image  
y41p | Uncompressed YUV 411 12-bit  
yuv4 | Uncompressed packed 420  
zlib | LCL (LossLess Codec Library) ZLIB  
zmbv | Zip Motion Blocks Video  
copy | 编码与同原始视频  
  
以上内容是否对您有帮助？

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  使用七牛进行视频的剪辑

最近更新时间: 2019-01-07 16:16:27

七牛提供了很丰富的一视频处理功能， 比如视频转码， 截图， 水印，旋转， 切片等，
这篇简单介绍下[视频剪辑](http://developer.qiniu.com/docs/v6/api/reference/fop/av/avthumb.html)的简单操作。

比如我的七牛空间中有一个 MP4 文件：<http://dn-odum9helk.qbox.me/wangjiawei/1.mp4> 。 我们先来看下这个
MP4 的[视频信息](http://dn-odum9helk.qbox.me/wangjiawei/1.mp4?avinfo),
我们可以看到一个视频的时长信息`"duration": "239.285333"`表示 239
秒。现在我们打算做这样的截取`从第一分钟开始，截取时长为一分钟`。
我们来看下我们的[音视频处理接口](http://developer.qiniu.com/docs/v6/api/reference/fop/av/avthumb.html),
其中有两个参数：

参数名称 | 类别 | 必填 | 说明  
---|---|---|---  
`<Format>` | A/V | 是 | 目标视频的格式（比如 flv、mp4 等），参考 [支持转换的视频格式]  
`/ss/<SeekStart>` | A/V |  | 指定视频截取的开始时间，单位：秒。用于视频截取，从一段视频中截取一段视频。  
`/t/<Duration>` | V |  | 指定视频截取的长度，单位：秒。用于视频截取，从一段视频中截取一段视频。  
  
可以用来做视频剪辑。

  * 根据需求我们可以将开始时间 `ss` 设置为 `60`, 剪辑时长一分钟，可以将 `t` 设置为 `60`， 这样我们的处理规则就是：`avthumb/mp4/ss/60/t/60`。

  * 然后使用我们的 [PFOP](http://developer.qiniu.com/docs/v6/api/reference/fop/pfop/pfop.html) 即可以将视频截取出来。

  * 但是这样处理后的文件名是不规则的， 如果你想指定处理后的文件名可以参考我们的 [saveas 接口](http://developer.qiniu.com/docs/v6/api/reference/fop/saveas.html) 。 比如我们想处理后保存在空间`rwxf`, 文件名保存成`processed.mp4`。

    1. 我们首先需要对 `rwxf:processed.mp4` 进行[urlsafebase64编码](http://developer.qiniu.com/docs/v6/api/overview/appendix.html)后得到 `cnd4Zjpwcm9jZXNzZWQubXA0`。
    2. 这样我们的处理命令就变成了：`avthumb/mp4/ss/60/t/60|saveas/cnd4Zjpwcm9jZXNzZWQubXA0`。
  * 进行 PFOP 处理后，如果想要查询处理的状态可以通过[持久化状态查询](http://developer.qiniu.com/docs/v6/api/reference/fop/pfop/prefop.html)接口来进行查询。

下面我们给一个简单的 php demo：

    
    
    <?php
    require_once __DIR__. '/../autoload.php';
    
    use Qiniu\Auth;
    use Qiniu\Processing\PersistentFop;
    
    $accessKey = '<your_ak>';
    $secretKey = '<your_sk>';
    $auth = new Auth($accessKey, $secretKey);
    $config = new \Qiniu\Config();
    
    $bucket = 'rwxf';
    $key = '1.mp4';   
    $pipeline = 'abc'; //队列名称，使用独立队列可以加快处理速度。  
    $pfop = new PersistentFop($auth, $config);
    $savedkey = 'processed.mp4';
    $entry = \Qiniu\base64_urlSafeEncode("$bucket:$savedkey");
    $fops = "avthumb/mp4/ss/60/t/60|saveas/$entry";
    list($id, $err) = $pfop->execute($bucket, $key, $fops);
    echo "\n====> pfop avthumb result: \n";
    if ($err != null) 
    {            
         var_dump($err);
    } 
    else 
    {            
         echo "PersistentFop Id: $id\n";
    }
    

以上代码要配合我们的 [phpsdk](https://github.com/qiniu/php-sdk) 才可以运行。

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  avthumb参数acodec格式及解释

最近更新时间: 2022-09-02 10:16:37

<http://developer.qiniu.com/code/v6/api/dora-
api/av/avthumb.html>[__](http://developer.qiniu.com/code/v6/api/dora-
api/av/avthumb.html)

## 参数 `/acodec/<AudioCodec>`：音频编码方案，支持方案：libmp3lame ， libfaac ， libvorbis
，libfdk_aac 等。

audioEncoders | description  
---|---  
aac | AAC (Advanced Audio Coding)  
libfaac |   
ac3 | ATSC A/52A (AC-3)  
ac3_fixed | ATSC A/52A (AC-3) (codec ac3)  
adpcm_adx | SEGA CRI ADX ADPCM  
g722 | G.722 ADPCM (codec adpcm_g722)  
g726 | G.726 ADPCM (codec adpcm_g726)  
adpcm_ima_qt | ADPCM IMA QuickTime  
adpcm_ima_wav | ADPCM IMA WAV  
adpcm_ms | ADPCM Microsoft  
adpcm_swf | ADPCM Shockwave Flash  
adpcm_yamaha | ADPCM Yamaha  
alac | ALAC (Apple Lossless Audio Codec)  
libopencore_amrnb | OpenCORE AMR-NB (Adaptive Multi-Rate Narrow-Band) (codec amr_nb)  
comfortnoise | RFC 3389 comfort noise generator  
dca | DCA (DTS Coherent Acoustics) (codec dts)  
eac3 | ATSC A/52 E-AC-3  
flac | FLAC (Free Lossless Audio Codec)  
g723_1 | G.723.1  
libilbc | iLBC (Internet Low Bitrate Codec) (codec ilbc)  
mp2 | MPEG audio layer 2 High Frequency  
libmp3lame | libmp3lame MP3 (MPEG audio layer 3) (codec mp3)  
nellymoser | Nellymoser Asao  
pcm_alaw | PCM A-law / G.711 A-law  
pcm_f32be | PCM 32-bit floating point big-endian  
pcm_f32le | PCM 32-bit floating point little-endian  
pcm_f64be | PCM 64-bit floating point big-endian  
pcm_f64le | PCM 64-bit floating point little-endian  
pcm_mulaw | PCM mu-law / G.711 mu-law  
pcm_s16be | PCM signed 16-bit big-endian  
pcm_s16be_planar | PCM signed 16-bit big-endian planar  
pcm_s16le | PCM signed 16-bit little-endian  
pcm_s16le_planar | PCM signed 16-bit little-endian planar  
pcm_s24be | PCM signed 24-bit big-endian  
pcm_s24daud | PCM D-Cinema audio signed 24-bit  
pcm_s24le | PCM signed 24-bit little-endian  
pcm_s24le_planar | PCM signed 24-bit little-endian planar  
pcm_s32be | PCM signed 32-bit big-endian  
pcm_s32le | PCM signed 32-bit little-endian  
pcm_s32le_planar | PCM signed 32-bit little-endian planar  
pcm_s8 | CM signed 8-bit  
pcm_s8_planar | PCM signed 8-bit planar  
pcm_u16be | PCM unsigned 16-bit big-endian  
pcm_u16le | PCM unsigned 16-bit little-endian  
pcm_u24be | PCM unsigned 24-bit big-endian  
pcm_u24le | PCM unsigned 24-bit little-endian  
pcm_u32be | PCM unsigned 32-bit big-endian  
pcm_u32le | PCM unsigned 32-bit little-endian  
pcm_u8 | PCM unsigned 8-bit  
real_144 | RealAudio 1.0 (14.4K) (codec ra_144)  
roq_dpcm | id RoQ DPCM  
s302m | SMPTE 302M  
sonic | Sonic  
sonicls | Sonic lossless  
tta | TTA (True Audio)  
vorbis | Vorbis  
libvorbis | ibvorbis (codec vorbis)  
wavpack | 无损音频压缩格式  
wmav1 | Windows Media Audio 1  
wmav2 | Windows Media Audio 2  
copy | 编码同原始音频  
  
以上内容是否对您有帮助？

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  视频支持格式

最近更新时间: 2017-08-28 15:20:50

格式 | 是否支持  
---|---  
g2 | true  
3gp | true  
a64 | true  
ac3 | true  
adts | true  
adx | true  
aiff | true  
alaw | true  
amr | true  
asf | true  
asf_stream | true  
ass | true  
ast | true  
au | true  
avi | true  
avm2 | true  
bit | true  
caf | true  
cavsvideo | true  
crc | true  
data | true  
daud | true  
dirac | true  
dnxhd | true  
dts | true  
dv | true  
dvd | true  
eac3 | true  
f32be | true  
f32le | true  
f4v | true  
f64be | true  
f64le | true  
ffm | true  
ffmetadata | true  
filmstrip | true  
flac | true  
flv | true  
framecrc | true  
framemd5 | true  
g722 | true  
g723_1 | true  
gif | true  
gxf | true  
h261 | true  
h263 | true  
h264 | true  
hls | true  
ico | true  
ilbc | true  
image2 | true  
image2pipe | true  
ipod | true  
ircam | true  
ismv | true  
ivf | true  
jacosub | true  
latm | true  
m4v | true  
matroska | true  
md5 | true  
microdvd | true  
mjpeg | true  
mkvtimestamp_v2 | true  
mlp | true  
mmf | true  
mov | true  
mp2 | true  
mp3 | true  
mp4 | true  
mpeg | true  
mpeg1video | true  
mpeg2video | true  
mpegts | true  
mpjpeg | true  
mulaw | true  
mxf | true  
mxf_d10 | true  
null | true  
nut | true  
ogg | true  
oma | true  
psp | true  
rawvideo | true  
rm | true  
roq | true  
rso | true  
rtp | true  
rtsp | true  
s16be | true  
s16le | true  
s24be | true  
s24le | true  
s32be | true  
s32le | true  
s8 | true  
sap | true  
segment | true  
smjpeg | true  
smoothstreaming | true  
sox | true  
spdif | true  
srt | true  
stream_segment | true  
ssegment | true  
svcd | true  
swf | true  
tee | true  
truehd | true  
u16be | true  
u16le | true  
u24be | true  
u24le | true  
u32be | true  
u32le | true  
u8 | true  
vc1 | true  
vc1test | true  
vcd | true  
vob | true  
voc | true  
w64 | true  
wav | true  
webm | true  
webvtt | true  
wtv | true  
wv | true  
yuv4mpegpipe | true  
  
以上内容是否对您有帮助？

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  视频文字水印支持字体列表

最近更新时间: 2023-09-14 17:32:12

**支持字体列表如下：**

文字字体  
（需经过URL安全的Base64编码） | 中文意思 | 支持语音 | 字体样式  
（需经过URL安全的Base64编码）  
---|---|---|---  
WenQuanYi Zen Hei | 文泉驿正黑 | 中/英文 | medium  
WenQuanYi Zen Hei Mono | 文泉驿等宽正黑 | 中/英文 | medium  
WenQuanYi Micro Hei | 文泉驿微米黑 | 中/英文 | regular  
WenQuanYi Micro Hei Mono | 文泉驿等宽微米黑 | 中/英文 | regular  
Source Han Sans SC | 思源黑体 | 中/英文 | normal、heavy、extralight、regular、bold、light、medium  
Source Han Serif SC | 思源宋体 | 中/英文 | semibold、bold、extralight、regular、light、medium、heavy  
FZFangSong-Z02S | 方正仿宋 | 中/英文 | regular  
FZHei-B01S | 方正黑体 | 中/英 | regular  
FZKai-Z03S | 方正楷体 | 中/英 | regular  
FZShuSong-Z01S | 方正书宋 | 中/英 | regular  
Roboto | Roboto | 英文 | Black、BlackItalic、Bold、Italic、Light、LightItalic、Medium、MediumItalic、Regular、Thin、ThinItalic  
Marcellus | Marcellus | 英文 | Regular  
Lato | Lato | 英文 | Black、BlackItalic、Bold、BoldItalic、Italic、Light、LightItalic、Regular、Thin、ThinItalic  
Montserrat | Montserrat | 英文 | Black、Bold、ExtraBold、ExtraLight、Light、Medium、Regular、SemiBold、Thin  
Poppins | Poppins | 英文 | Bold、Light、Medium、Regular、SemiBold  
Droid Sans Fallback | Droid Sans Fallback | 中文 | Bold、Light、Medium、Regular、SemiBold  
  
以上内容是否对您有帮助？

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  关于七牛的流媒体队列

最近更新时间: 2017-08-28 15:23:18

七牛的流媒体队列 （英文简称 pipeline ）

七牛首创云端音视频、流媒体处理服务，依托高性能硬件及私有任务队列机制，保障任务高效完成。

# 共有队列

共有队列是所有的客户都在使用的队列, 所以如果任务量比较大需要排队比较久。这个共有队列就是不定状态的 如果需要快速处理需要使用私有队列。

问题1：怎么样查看自己提交的数据处理的情况呢？

答案：每个处理都会返回一个类似于 z0.58b5338645a2653715350b20 z0.开头得的 PersistentId 可以通过 get
[请求这个接口查到](https://developer.qiniu.com/dora/api/persistent-processing-status-
query-prefop) 处理的状态

    
    
    {
        "code": 1,
        "desc": "The fop is waiting for execution",
        "id": "z0.58b5338645a2653715350b20",
        "inputBucket": "echohu",
        "inputKey": "./hh.wmv",
        "items": [
            {
                "cmd": "avthumb/mp4|saveas/dmlkZW86dGVzdDExMC5tcDQ=",
                "code": 1,
                "desc": "The fop is waiting for execution",
                "returnOld": 0
            }
        ],
        "pipeline": "0.default",
        "reqid": ""
    }
    

参考：[处理化数据处理查询](https://developer.qiniu.com/dora/api/persistent-processing-
status-query-prefop)

"pipeline": "0.default"如果是0.default 就是使用默认的共有队列

# 私有队列

创建私有队列

在七牛的 portal 平台的主界面,点击 多媒体处理 的“立即添加”。这个就是私有队列 pipeline ![](https://dn-
odum9helk.qbox.me/Fl1HWJAUBpOJC_mNI0epwfVIDQLw)

在代码处理时候传入这个得名字即是使用它下面给出php demo的使用私有队列 队列名是abc

    
    
      <?php
      require_once 'path_to_sdk/vendor/autoload.php';
    
      use Qiniu\Auth;
      use Qiniu\Storage\UploadManager;
    
      $accessKey = 'Access_Key';
      $secretKey = 'Secret_Key';
      $auth = new Auth($accessKey, $secretKey);
    
      $bucket = 'Bucket_Name';
    
      //转码时使用的队列名称 
      $pipeline = 'abc';
    
      //要进行转码的转码操作 
      $fops = "avthumb/mp4/s/640x360/vb/1.25m";
    
      //可以对转码后的文件进行使用saveas参数自定义命名，当然也可以不指定文件会默认命名并保存在当间
      $savekey = Qiniu\base64_urlSafeEncode('目标Bucket_Name:自定义文件key');
      $fops = $fops.'|saveas/'.$savekey;
    
      $policy = array(
        'persistentOps' => $fops,
        'persistentPipeline' => $pipeline
      );
      $uptoken = $auth->uploadToken($bucket, null, 3600, $policy);
    
      //上传文件的本地路径
      $filePath = './php-logo.png';
    
      $uploadMgr = new UploadManager();
    
      list($ret, $err) = $uploadMgr->putFile($uptoken, null, $filePath);
      echo "\n====> putFile result: \n";
      if ($err !== null) {
          var_dump($err);
      } else {
          var_dump($ret);
      }
    

还有关于价格私有队列收费价格看这里的多媒体处理 [价格](http://www.qiniu.com/pricing)

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  关于图片 EXIF 信息中旋转参数 Orientation 的理解

最近更新时间: 2019-01-04 17:43:35

EXIF（Exchangeable Image File）是 “可交换图像文件”
的缩写，当中包含了专门为数码相机的照片而定制的元数据，可以记录数码照片的拍摄参数、缩略图及其他属性信息，简单来说，Exif 信息是镶嵌在 JPEG/TIFF
图像文件格式内的一组拍摄参数，需要注意的是 EXIF 信息是不支持 png,webp 等图片格式的。 对于七牛，可以在图片后面加? exif
参数来获取图片的 exif 信息。

对于 Orientation 参数，简单的说是记录图片拍摄的相机的旋转信息，浏览器 (需要浏览器支持) 可以根据这个参数中的 val
信息自动旋转图片到正确的方向。

**eg：**

  * 在浏览器中输入以下图片链接，由于浏览器自动旋转了，我们可以看到一个显示正常的图片：

<http://dn-odum9helk.qbox.me/exif.png>

  * 其实这张图片拍摄的时候相机是有旋转的，我们可以去掉图片的 exif 信息显示如下：

<http://dn-odum9helk.qbox.me/exif.png?imageMogr2/strip>

  * 可以查询到图片的 exif 信息如下：

<http://dn-odum9helk.qbox.me/exif.png?exif>

    
    
    {"ColorSpace":{"val":"sRGB","type":3},"ExifVersion":{"val":"Exif Version 2.1","type":7},"FlashPixVersion":{"val":"FlashPix Version 1.0","type":7},"Orientation":{"val":"Right-top","type":3},"PixelXDimension":{"val":"3264","type":4},"PixelYDimension":{"val":"2448","type":4},"ResolutionUnit":{"val":"Inch","type":3},"XResolution":{"val":"72","type":5},"YResolution":{"val":"72","type":5}}
    

由以上我们可以得到图片拍摄时的 val 信息得到图片拍摄时相机的旋转信息是 Right-top 信息，我们可以由以下文档得到相机拍摄时应该是在逆时针选择了
90 度的基础上拍摄的：  
<http://sylvana.net/jpegcrop/exif_orientation.html>  
<http://www.impulseadventure.com/photo/exif-orientation.html>

![111](https://dn-odum9helk.qbox.me/71a7c382de4df5315df4c71614f9fdcf)

![222](https://dn-odum9helk.qbox.me/8942949faa9b806a94e86406472323fc)

需要注意的是，七牛显示的 exif 信息 Orientation":{"val":"Right-top","type":3}，其中 type
信息是可以忽略，以 value 信息为准

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  如何创建音视频处理私有队列

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

在七牛进行音视频处理，推荐使用私有队列（pipeline）。 创建私有队列方法如下：

# 第一步

登录[七牛云智能多媒体平台 __](https://portal.qiniu.com/dora/media-
gate/pipeline)，切换到【队列】页面，点击图片红点所示处 “新建队列”

![](https://dora-doc.qiniu.com/WX20210721-142015.png)

# 第二步

填写队列名称，点击 "确定创建”  
![](https://dora-doc.qiniu.com/WX20210721-142105.png)

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  图片鉴黄服务接口协议

最近更新时间: 2017-08-15 15:38:10

## 请求

### 请求报文格式

    
    
    GET <DownloadURI>?nrop HTTP/1.1
    Host: <DownloadHost>
    

### 请求头部

头部名称 | 必填 | 说明  
---|---|---  
Host | 是 | 下载服务器域名，可为七牛三级域名或自定义二级域名，参考[域名绑定](https://developer.qiniu.com/fusion/manual/1367)  
  
* * *

## 响应

### 响应报文格式

    
    
    HTTP/1.1 200 OK
    Content-Type: application/json
    Cache-Control: no-store
    
    {
        // ...nrop data...
    }
    

### 响应头部

头部名称 | 必填 | 说明  
---|---|---  
Content-Type | 是 | MIME类型，固定为application/json  
Cache-Control | 是 | 缓存控制，固定为no-store，不缓存  
  
### 响应内容

■ 如果请求成功，返回包含如下内容的JSON字符串（已格式化，便于阅读）：

    
    
    {
        "code": "<ResultCode         int>",
        "message": "<ResultMessage   string>",
        "fileList": [
            {
                "rate": <Rate        float>,
                "label": <Category   int>,
                "name": "<FileName   string>",
                "review": <Review    boolean>
            }
        ],
        "statistic": [
            <Statistics              int>,
            ...
        ],
        "reviewCount": <ReviewCount  int>,
        "nonce": "<Nonce             string>",
        "timestamp": "<Timestamp     string>"
    }
    

字段名称 | 必填 | 说明  
---|---|---  
`code` | 是 | 处理状态(0：调用成功; 1：授权失败； 2：模型ID错误； 3：没有上传文件； 4：API版本号错误； 5：API版本已弃用； 6：secretId 错误； 7：任务Id错误，您的secretId不能调用该任务； 8：secretId状态异常； 9：尚未上传证书； 100：服务器错误； 101：未知错误)  
`message` | 是 | 与`code`对应的状态描述信息  
`fileList` | 否 | 鉴别的图片文件列表  
`rate` | 是 | 介于0-1间的浮点数，表示该图像被识别为某个分类的概率值，概率越高、机器越肯定；您可以根据您的需求确定需要人工复审的界限。  
`label` | 是 | 介于0-2间的整数，表示该图像被机器判定为哪个分类，分别对应： 0：色情； 1：性感； 2：正常  
`name` | 是 | 鉴别图片文件的文件名  
`review` | 是 | 是否需要人工复审该图片  
`statistic` | 否 | 图像机器判定结果统计数组，分别对应判定为0-3的数据总量  
`callRecordId` | 否 | 调用的唯一标识符，用于后续的人工复审的结果反馈  
`APIVersion` | 是 | API的版本  
`reviewCount` | 否 | 需要人工复审的图片数量  
`nonce` | 是 | 随机数  
`timestamp` | 是 | 当前的服务器的Unix时间，UTC格式时间字符串  
  
■ 如果请求失败，请参考以上`code`和`message`字段的说明。

## 示例

在Web浏览器中输入以下图片地址：

    
    
    http://qiniuphotos.qiniudn.com/gogopher.jpg?nrop
    

返回结果（内容经过格式化以便阅读）

    
    
    {
        "code": 0,
        "message": "succeed.",
        "fileList": [
            {
                "rate": 0.9558794498443604,
                "label": 2,
                "name": "czfh1cATkoExQ_AMVyg1zw==.resize",
                "review": false
            }
        ],
        "statistic": [
            0,
            0,
            1
        ],
        "reviewCount": 0,
        "nonce": "0.31666339887306094",
        "timestamp": "Wed, 06 May 2015 07:42:27 GMT"
    }
    

**另一种方式安装。**

在左边的“添加资源”中，点击下面的“第三方数据处理” > "图片签黄"。

**![00157466c70adc4c151d1b2eb96b3f9](https://oi2ix6x26.qnssl.com/attachments/download/695143/00157466c70adc4c151d1b2eb96b3f9/)**

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  如何知道缩略图是否已经成功生成

最近更新时间: 2017-08-28 15:04:35

> 在上传图片 API 中使用预处理指令生成缩略图之后，如何知道缩略图是否已经成功生成？

可以通过持久化处理返回的persistenId查询，可以看到处理后的key值，通过拼接到下述链接获取  
<http://api.qiniu.com/status/get/prefop?id=>  
具体文档参考  
<http://developer.qiniu.com/code/v6/api/dora-api/pfop/prefop.html>

但是不建议大家使用pfop生成缩略图，因为缩略图生成过程通常比较快，而且缩略图有缓存机制（但不是存到你的存储空间），用户下次访问的时候，会直接访问上次已经生成好的缩略图。因此可以直接在线生成缩略图即可

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  七牛图片拼接

最近更新时间: 2019-01-04 17:53:21

我们知道，七牛提供了很多图片处理的指令，比如图片缩放，裁减，加水印等。但是即使这样，有的时候，我们还是会有新的需求，比如图片拼接。

这个看上去七牛没有直接提供支持的指令，但是我们稍微动下脑筋，同样能根据已有的功能来实现图片拼接。  
大多数情况下，图片拼接并不是要实现太复杂的拼接效果。所以我们可以使用图片水印和裁剪这两种指令来实现图片的基本拼接功能。

这个方法的基本步骤是：

  1. 创建一个比较大的背景图片，该图片的格式是png格式，背景透明。比如我们创建一个1000x1000的透明背景大图。之所以要选大的，就是为了尽量覆盖较多的图片大小。如果你的目标图片比这个还大，那么继续放大就行。因为大的背景方便裁剪。
  2. 根据七牛支持的图片水印功能，分别把图片添加到这个背景图片之上，添加的位置可以通过 watermark 指令（图片水印）的 gravity 参数来设置。下面是 gravity 参数的可选值。  
![](https://dn-odum9helk.qbox.me/FvL2o-CY16aknq05ot-upakqZev1)

  3. 将添加了水印的背景图片根据实际需要，裁减到指定的大小即可。

我们创建一个 1000X1000 大小的，背景透明的 png 格式图片 bg.png 上传到七牛空间。

然后我们将要拼接的图片 movie1.png，movie2.png 和 movie3.png 上 传到七牛的空间，分别获得外链如下：

文件 | 外链  
---|---  
bg.png | <http://dn-odum9helk.qbox.me/bg.png>  
movie1.png | [http://dn-odum9helk.qbox.me/movie1.png](http://dn-odum9helk.qbox.me/506059e90960285ab5ab832d6d1dbd91.png)  
movie2.png | [http://dn-odum9helk.qbox.me/movie2.png](http://dn-odum9helk.qbox.me/506059e90960285ab5ab832d6d1dbd91.png)  
movie3.png | [http://dn-odum9helk.qbox.me/movie3.png](http://dn-odum9helk.qbox.me/506059e90960285ab5ab832d6d1dbd91.png)  
  
这三个图片都是300x300的图片。我们需要将他们拼接起来构成300x900的大图片。  
实时处理方式：

    
    
    http://7xq8fj.com1.z0.glb.clouddn.com/bg.png?watermark/1/gravity/NorthWest/image/aHR0cDovLzd4cThmai5jb20xLnowLmdsYi5jbG91ZGRuLmNvbS9waWMxLnBuZw==|watermark/1/gravity/West/image/aHR0cDovLzd4cThmai5jb20xLnowLmdsYi5jbG91ZGRuLmNvbS9waWMyLnBuZw==|watermark/1/gravity/SouthWest/image/aHR0cDovLzd4cThmai5jb20xLnowLmdsYi5jbG91ZGRuLmNvbS9waWMzLnBuZw==|imageMogr2/gravity/NorthWest/crop/!300x900
    

持久化的方式： 根据 pfop 的接口参数，对应的 fops 参数为

    
    
    watermark/1/gravity/NorthWest/image/aHR0cDovLzd4cThmai5jb20xLnowLmdsYi5jbG91ZGRuLmNvbS9waWMxLnBuZw==|watermark/1/gravity/West/image/aHR0cDovLzd4cThmai5jb20xLnowLmdsYi5jbG91ZGRuLmNvbS9waWMyLnBuZw==|watermark/1/gravity/SouthWest/image/aHR0cDovLzd4cThmai5jb20xLnowLmdsYi5jbG91ZGRuLmNvbS9waWMzLnBuZw==|imageMogr2/gravity/NorthWest/crop/!300x900|saveas/...
    

其中saveas的参数根据实际情况来替换。

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  部分 mp4 在网页播放器兼容问题

最近更新时间: 2021-07-21 15:18:20

浏览器web播放器支持的格式是比较标准的，所以部分的不是标准格式的视频会在 web 端播放不出来

# 解决方案

使用代码，调用七牛的接口转为标准的 MP4 。参考：[音视频转码](https://developer.qiniu.com/dora/api/audio-
and-video-transcoding-avthumb)

`fops = 'avthumb/mp4'` 设置为标准的 mp4

python

    
    
    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'
    
    # 通过添加'|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)
    
    

php

    
    
      <?php
      require_once 'path_to_sdk/vendor/autoload.php';
    
      use Qiniu\Auth;
      use Qiniu\Storage\UploadManager;
    
      $accessKey = 'Access_Key';
      $secretKey = 'Secret_Key';
      $auth = new Auth($accessKey, $secretKey);
    
      $bucket = 'Bucket_Name';
      
      //转码时使用的队列名称 
      $pipeline = 'abc';
    
      //要进行转码的转码操作 
      $fops = "avthumb/mp4";
      
      //可以对转码后的文件进行使用saveas参数自定义命名，当然也可以不指定文件会默认命名并保存在当间
      $savekey = Qiniu\base64_urlSafeEncode('目标Bucket_Name:自定义文件key');
      $fops = $fops.'|saveas/'.$savekey;
     
      $policy = array(
        'persistentOps' => $fops,
        'persistentPipeline' => $pipeline
      );
      $uptoken = $auth->uploadToken($bucket, null, 3600, $policy);
    
      //上传文件的本地路径
      $filePath = './php-logo.png';
    
      $uploadMgr = new UploadManager();
    
      list($ret, $err) = $uploadMgr->putFile($uptoken, null, $filePath);
      echo "\n====> putFile result: \n";
      if ($err !== null) {
          var_dump($err);
      } else {
          var_dump($ret);
      }
    
    

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  点播如何保存，再进行视频格式（mp4）的转码

最近更新时间: 2017-08-28 15:41:58

# 1.点播保存

业务服务器有两个版本，v1和v2，下面分别介绍如何进行视频流的保存：

**v1：**

v1版本服务器是通过saveAs(saveAsName, saveAsFormat, saveAsStart,
saveAsEnd)方法进行视频流的保存的，其中

saveAsName是保存的视频的名称。

saveAsFormat是目标视频的格式，指定format为null进行操作，立即生成m3u8。

saveAsStart, saveAsEnd分别为想保存视频的起止时间，以Unix时间戳的格式传入，这个时间可以通过segments方法获得。

**v2：**

v2版本服务器是通过save(long start, long
end)方法进行视频流的保存的，默认只能保存成m3u8文件，其参数为想保存视频的起止时间，以Unix时间戳的格式传入，这个时间可以通过historyRecord方法获得。

【注意】

如果是转存mp4（或其他格式）,不建议在saveas的时候直接指定format为mp4，那样有些已知的问题，比如转出来的视频播放卡住，快进，无法拖动进度条等等。因此推荐用户指定format为null，先保存成m3u8文件再使用存储SDK的avthumb接口进行转码操作。

# 2.视频转码

视频的转码可以使用存储SDK的avthumb接口来操作。下面是相关文档链接：

avthumb的接口文档：<http://developer.qiniu.com/code/v6/api/dora-api/av/avthumb.html>

Java SDK相关：<http://developer.qiniu.com/code/v7/sdk/java.html>

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  gif 转 mp4

最近更新时间: 2019-12-20 13:37:39

使用[音视频转码 (avthumb)](https://developer.qiniu.com/dora/api/audio-and-video-
transcoding-avthumb) 进行转码

例子：

使用 php 进行转码操作：

    
    
    <?php  
    require_once '/---/--/php-sdk-7.0.8/autoload.php';
    
    use Qiniu\Auth;  
    use Qiniu\Processing\PersistentFop;
    
    //对已经上传到七牛的视频发起异步转码操作
    
    $accessKey = ' ';  
    $secretKey = ' ';  
    $auth = new Auth($accessKey, $secretKey);
    
    //要转码的文件所在的空间和文件名  
    $bucket = ' ';  
    $key = ' ';
    
    //转码是使用的队列名称  
    $pipeline = ' ';  
    $pfop = new PersistentFop($auth, $bucket, $pipeline);  
    $fops = "avthumb/mp4/s/640x360/vb/1.25m";  
    $savekey = Qiniu\base64\_urlSafeEncode('目标空间:转码后文件名称');  
    $pfops = $fops.'|saveas/'.$savekey;
    
    list($id, $err) = $pfop-\>execute($bucket, $key, $pfops);  
    echo "\n====\> pfop avthumb result: \n";  
    if ($err != null) {  
    var\_dump($err);  
    } else {  
    echo "PersistentFop Id: $id\n";  
    }
    
    //查询转码的进度和状态  
    list($ret, $err) = $pfop-\>status($id);  
    echo "\n====\> pfop avthumb status: \n";  
    if ($err != null) {  
    var\_dump($err);  
    } else {  
    var\_dump($ret);  
    }
    

之后使用 `http://api.qiniu.com/status/get/prefop?id=<PersistentFop Id>` 查询转码状态

在空间中也能看到转码后的mp4

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  视频教程 - 多媒体数据处理

最近更新时间: 2019-01-07 17:02:12

[多媒体数据处理视频教程](https://dn-odum9helk.qbox.me/spjc/5.mp4)

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  图片瘦身无效

最近更新时间: 2021-07-23 18:20:34

# 问题描述

开启图片瘦身策略或者在图片资源 url 后添加`imageslim`并未发现图片有瘦身的效果

# 问题原因

可以参考如下几种原因排查问题

## 原因一

查看自定义加速域名是否开启了忽略 url 参数？如果开启了，请关闭忽略 url 参数以及刷新文件后在查看访问的效果。

![](https://dn-odum9helk.qbox.me/FpbzlU251Xn9GkAqF3fs0m39qB3D)

## 原因二

如果你是开启了图片瘦身策略，只能对文件名带有显著.jpg，.png 的后缀的文件有瘦身的效果。

例如：  
https://url/b 这个图片瘦身是无效的，  
https://url/b.jpg 这个是图片瘦身有效的。

## 原因三

这个资源本身不是图片格式，无法进行图片瘦身。您可以通过在文件名后添加`imageInfo`查看图片的元信息，如果不是图片格式，会提醒`"error":
"unsupported format"`。如果是图片格式，则会返回正常的图片元信息。例如：https://url/b.jpg?imageInfo

## 原因四

图片资源体积过大，导致图片处理超时，则返回原图。  
返回原图时，可以打开浏览器的开发者模式，查看响应头，带有 response header「X-Slim-Origin」有2种取值：“0”:
表征内部处理正常，“1”: 表征内部处理异常，返回原图

## 原因五

图片资源已损坏，这种情况一般是对象存储空间中的其他资源的图片瘦身正常，只有单独的一张或者几张图片瘦身无效。建议你更换未损坏的图片资源。

## 原因六

私有bucket 不支持 CDN中间源的图片瘦身处理。

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交
#  imageMogr2对gif转成webp格式并缩放报错解决方法

最近更新时间: 2019-01-07 10:29:58

#### 报错：error: "The original image abnormal"

>
> imageMogr2将gif转为web并且缩放时，使用imageMogr2/format/webp|imageMogr2/thumbnail/100x报错

**报错链接** ：[https://dn-
odum9helk.qbox.me/test.gif?imageMogr2/format/webp|imageMogr2/thumbnail/100x](https://dn-
odum9helk.qbox.me/test.gif?imageMogr2/format/webp%7CimageMogr2/thumbnail/100x)

![blob.png](https://dn-odum9helk.qbox.me/Fl5eNfaKeFhQ2Wvh6jnRWfeAE-Sn)

**报错原因** ：imageMogr2参考工具[imageMagick](http://www.imagemagick.com.cn/
"imagemagick")，由于 imageMagick 对 animated webp
进行缩放处理不支持，导致在imageMogr2将.gif转成.webp格式的文件时缩放报错

**解决方法** ：2种。

1）使用管道符，使用imageMogr2缩放.gif图片后再转成.webp格式文件

如：[https://dn-
odum9helk.qbox.me/test.gif?imageMogr2/thumbnail/100x|imageMogr2/format/webp](https://dn-
odum9helk.qbox.me/test.gif?imageMogr2/thumbnail/100x%7CimageMogr2/format/webp)

![blob.png](https://dn-odum9helk.qbox.me/FspfjQHf8LQW0XPCyHD77KEB_7UA)

2）不使用管道符，在缩放.gif图片时直接指定目标格式为.webp，

如：<https://dn-
odum9helk.qbox.me/test.gif?imageMogr2/thumbnail/100x/format/webp>

![blob.png](https://dn-odum9helk.qbox.me/FnTR-neYs6nvRC6qbwIfU_uq7on0)

**参考** ：

[高级图片处理imageMogr2](https://developer.qiniu.com/dora/api/1270/the-advanced-
treatment-of-images-imagemogr2)

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

* __
* __
* __
* __
* __

文档反馈 (如有产品使用问题，请[ 提交工单](https://support.qiniu.com/tickets/category))

提交