上传参数

上传请求必须至少包括文件上传,云形支持范围广泛的可选参数,你可以添加到上传请求中

所需文件参数

指定文件上传需要所有上传云化支持从各种源上传文件,包括从a本地路径,a远程URL,a私有存储URLS3或Google云存储器a数据流,aBase64数据URI或FTP URL.

从本地路径上传

上传资产可指定本地路径媒体文件仅在使用云端SDKs时使用此选项例举 :

从远程 URL上传

资产在线公开提供时,可指定远程HTTP或HTTPSURL取代上传实文件或文件数据云形从远程URL检索文件并直接上传到云形选项允许快速迁移现有媒体文件例举 :

从私有存储URL上传

私有存储机(Amazon S3或Google云存储机)桶中存有媒体文件时,您可以从存储桶URL上传文件

启动此选项时,您的存储桶必须是白列表.需要以下步骤:

1. 空文件添加到桶中,云名为文件名,在下列文件夹结构下:.wellknown/cloudinary/
   

   • 通过添加此文件,表示您可访问此桶并允许云形从此桶上传到产品环境并使用指定的云名
   • 如果您想将桶白列多云产环境,您可以为每个云名添加适当命名文件。

2. 提供云形读桶访问权限
   -如何设置阅读访问 私家亚马逊S3桶
   -如何设置读Google存储桶

存储桶白列表后,可传递亚马逊S3s3://my-bucket/...或谷歌存储gs://mybucket/...URL上传方法

S3示例

Google云示例

如何设置阅读访问 私家亚马逊S3桶

1. 亚马逊AWSS3控制台选择相关桶
2. 桶策略属性粘贴下下列策略文本
   保留版本化值显示于下,但改变公元前名你的桶
   如果策略已经存在, 则将文本附加到现有策略中 :

如何设置读Google存储桶

1. GCP控制台转Google桶主页
2. 选择编辑桶权限
3. 添加service@cloudinary-gcs-production.iam.gserviceaccount.com以成员身份分送存储对象查看器角色化

上传数据流

可上传实数据流(字节数组缓冲区):

通过Base64数据URI上传

上传文件时可具体说明数据URIBase64编码文件(不大于60MB)例举 :

FTP URL上传

可指定远程媒体文件上传FTP URL.专用FTP服务器用户名和密码必须列作参数,FTP URL语法取表ftp/ : @ : / .例举 :

可选上传参数

上头上传方法支持从命名和存储选项到添加标签和元数据以及请求分析或添加或甚至在存储前转换资产等多选参数本节提供一些常用选参数的额外信息

• 公共身份证
• 资产类型
• 存储类型
• 资产版本

公共身份证

上传到云形系统的每一资产都配有专用标识符形式公共标识符,即URL安全字符串,用于引用上载资源并建动送变URL贝斯特登录入口官网下载也可以浏览并搜索云内公共标识资源媒体探索者web接口

上传API调用时不提供公共标识码,上传API调用响应时会随机分配公共标识码随机生成公共标识看上去像这个8jsb1xofxdqamu2rzwt9q.产生交付URL类资产

https://res.www.aaaalireno.com/demo/image/upload/8jsb1xofxdqamu2rzwt9q.jpg

可设置公共标识参数上传资产时使用该参数,如果希望交付URL更容易读和方便SEO使用时使用该参数。例举 :

本节包含以下题目:

• 公共身份证命名偏好
• 公有标识中包含路径

公共身份证命名偏好

通知云端使用上传文件原名使用文件名参数设置真实性.文件名解析以只包括保护URL字符,并附随机字符集以确保公共标识的独特性并包含唯一文件名参数并设置它虚伪,你可以告诉云人不试图使公共身份证独有性,并使用归并文件名下代码示例上传图像文件样本文件.jpg并保证公有资产标识样本文件:

公有标识中包含路径

公共ID值可包括路径元素(斜率),用于结构化化提供URL并辅助SEO例举 :

也可以通过将公共身份证拆分二分实现,即只说明公共身份证最后元素公共标识并定义公共标识路径文件夹参数化使用同上例子,但这次带文件夹参数 :

资产类型

云形支持多种不同文件格式,分三大类资产类型高山市资源类型API中说:

• 图像显示包括动画图像、PDFs和3D模型支持文件格式见支持图像格式并上传三维模型.
• 视频播放:所有视频和音频文件支持视频格式并支持音频格式.
• 原生(任何其他文件类型)

本节包含以下题目:

• 向上传调用传递资源类型参数
• 自动资源类型
• 上传视频
• 上传三维模型
• 上传非媒体文件为原始文件

向上传调用传递资源类型参数

• 何时RESTAPI上传中,资源类型即上传端点
• 上传时使用后端SDK图像显示默认值资源类型.上传视频或原始文件类型时,必须传递资源类型或带值汽车或相关特定资产类型
• 使用时图像直接从浏览器上传资源类型设置汽车默认值
• 上传受密码保护PDF图像资产不支持必要时,可设置密码保护PDF资源类型至原生上传命令记住,像任何其他生文件一样, 原创PDF原样提供,但PDF转换不支持原创资产

注意简洁性 本指南中多例显示上传图像文件使用这些代码示例作为自带视频或原始文件上传基础时,不要忘记添加资源类型选项 。

自动资源类型

上头上传方法支持提供汽车表示值资源类型参数化发送此值时,云形自动检测上传文件的资产类型并自动设置相关资源类型值存储资产

例举 :

上头汽车值特别有用 当您不知道用户上传文件类型或上传多个不同资产类型文件时使用时汽车成像资源类型连同其他上传选项,只应用与特定资产类型相关的上传选项仅使用不同资产类型的任何选项均静默忽略

上传视频

上传视频通常工作相同并支持与上传图像相同的选项上传视频时记住下列指南

• 默认值上传方法资源类型SDKs参数图像显示,所以你必须设置资源类型上传视频时参数可设置资源类型参数切换汽车指令云型自动检测资产类型或设置参数视频播放预知上传视频文件
• 默认上传同步执行,上传视频完成后立即提供变送大于100MB视频需要使用块上传.
• 临Τ文件尺寸限制转换大视频飞精确限值取决于您的账号平面图.因此,最佳实践生成视频转换热切上传

简单视频上载示例

音频文件(如MP3s)也可以以a形式上传视频播放资源库音频文件作为视频文件处理,没有视觉元素,并像视频一样上传使用视频播放成像资源类型.例举上传本地音频文件audio_sample.mp3:

上传三维模型

云化支持三维模型各种格式.格式需要文件集时(例如模型中所用的纹理或其他图像),应拉链全文件夹并上传单ZIP文件至云化

令产品库使用三维模型并性能变换上传3D模型图像显示资产类型云化

ZIP文件通常上传原生文件类型未指定云形检测3D模型并上传图像显示类型特效手动上传自媒体探索者

程序化上传3D模型时,可明文设置资源类型至图像显示.例举上传三维模型样本3Dzip文件 :

上传非媒体文件为原始文件

非图像或视频文件处理为raw文件原始文件上传时原封不动存储上传原始文件无变换可用然而,您可以通过动态CDN URL交付原创资产,方式与交付图像视频资产方式相同。

样本响应原创上传调用 略微不同于原创调用图像或视频上传响应:

转换原始文件

上头原路反转上传参数使您能够在上传文件上执行某些异步操作视此参数指定选项而定,您可以将某些原始文件转换为其他格式或生成相关原始文件,可与您上传图像或视频文件并用

例举 :

• 定义性容积算作值原路反转上传Office文档指令时参数引用文档转换上加从您的图像文件生成原生办公文档
• 定义性goolech语言上传视频指令Google AI视频纹理上加生成自动转录原生文件上传视频

• 定义性提取文本上传PDF文件从PDF文件提取全部文本并存储入原生文件.公共标识文件格式化[pdf_public_id].extract_text.json.

  注解

  文本提取结果使用 提取文本选项可能与使用后结果不同 OCR文本检测提取加载例举OCR加法包含文本每一行精确坐标此外,如果您的PDF含有带文本图像,OCR附加程序将捕捉到文本,但 raw_convert:"extract_text"选项不会

存储类型

默认时,当资产上传云化时,原资产和变换版都通过CDN公开提供限制访问资产的一种方式是基于资产存储类型

云化支持三种不同的存储类型类型API中说:

• 上传资产公开提供这是上传文件时默认存储类型
• 私有原创资产只能由签名URL访问
• 验证原创资产和所有资产衍生工具只能通过签名URL存取

本节包含以下题目:

• 私有资产
• 验证资产

私有资产

可上传资产为私有限制访问原资产并只允许访问衍生资产版本原始资产只能用签名URL访问,但默认时,所有衍生版本都可访问该资产激活衍生资产可进一步限制访问严格变换模式化模式还禁止访问衍生资产版本,但那些经专门启用(例如带水印)后可供向用户公开交付的资产除外。严格变换启动后, 您需要要么热切生成所有衍生资产, 标记允许的特定变换或使用签名URL

上传资产为私有资产类型参数切换私有替代默认上传上传资产时例举 :

资产上传为'私有'没有签名 URL无法公开存取URL返回错误

https://res.www.aaaalireno.com/demo/image/private/sample.jpg

验证资产

可上传资产为验证进一步限制对原资产和衍生(变换)资产版本的存取验证资产及其衍生版本不需某种形式的认证无法存取更多信息见经认证访问媒体资产.

上传资产认证资产设置存储类型类型参数)to验证替代默认上传上传资产时例举 :

贝斯特登录入口官网下载如果资产上传为“认证”,则该资产及其衍生资源都无法不经认证访问URL返回错误

https://res.www.aaaalireno.com/demo/image/authenticated/sample.jpg

替换现有资产

现有图像或视频资产代之以新上传文件覆盖覆盖设为真实性并:

• 上传新媒体资产并具体说明公共标识与现有资产相同
• 资产通过use_filename=true上传选项
• 使用上传预置中位选项

if备份激活产品环境后,当资产替换后,前一版备份并在需要时可恢复

但是,如果原创资产(老化资产)已经生成并存取,它可能已经在CDN缓存终端用户在反写资产后立即访问相同的URL时,仍然会存取CDN缓存版本而非新更新版本

新版资产通过设置可选交付无效参数切换真实性时重写已有资产这使上一个媒体资产在整个CDN失效注意通常需要几秒到几分钟才能完全通过CDN传播失效

并见:备份版管理