币游国际平台
菜单类

上传参数

最新更新日期:Dec-18-2023

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

小技巧
全表 全部可选参数 选项=++)可用上传方法见 上传a.

上页:

所需文件参数

指定文件上传需要所有上传云化支持从各种源上传文件,包括从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. 桶策略属性粘贴下下列策略文本
    保留版本化值显示于下,但改变公元前名你的桶
    如果策略已经存在, 则将文本附加到现有策略中 :

注解
亚马逊S3桶名中 .字符不支持此目的

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

上传数据流

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

注解
节点jsSDK使用专用 上传_流方法论

通过Base64数据URI上传

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

FTP URL上传

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

可选上传参数

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

小技巧
全表 全部可选参数 选项=++)可用上传方法见 上传a.

公共身份证

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

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

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

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

本节包含以下题目:

公共身份证命名偏好

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

注解
  • 公共ID值图像显示并视频播放资产类型应该是不对包括文件扩展内含a.字符公有身份证中,它仅仅是公有身份证值本身中的另一个字符媒体资产格式(扩展)交付后附加到公共标识举个例子,if you descriptmyname.mp4即公有视频myname.mp4.mp4.
  • 面向原生资产类型除外文件扩展应该是指定为公有i
  • 公共身份证可达255个字符,包括非英语字符和句号.)前斜线/)下划线_)连字符-)
  • 公共标识值无法开始或结束空间或前向斜线/)此外,它们不能包括下列字符:?#\% < >+

公有标识中包含路径

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

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

注解
  • 无法使用V级后加数字字符为路径元素名称
  • 无法使用/图像/或视频/公有身份证路径元素名字保留使用动态SEO后缀.
  • 推荐避免使用公共标识路径名,从1至3字符开始并加下划线,例如mypath.默认时云形假设URL组件沿此模式表示云形变换组件公共路由元素首选选择模式时,当从路径交付资产时,必须用路径元素和路径元素分离后端转换构件版本化组件.例举 :

    https://res.www.agrosoland.com/my_cloud/image/upload/t_transf1/t_transf2/v1/my_path/sample.jpg
  • 路径结构提供公共ID细节有版本或无版本见资产版本.
  • 效果对媒体探索者路径元素公有标识取决于您的产品环境是否使用固定文件夹模式或动态文件夹模式.
    • 产品环境使用固定文件夹模式2022年9月前创建的大多数帐户和产品环境使用此模式),那么公有标识中包括裁剪字法也将在MediaExplorer中创建相同结构中的文件夹资产移到介质探索器中不同文件夹后,会改变资产公有标识
    • if动态文件夹模式激活产品环境,公共标识分片不影响资产组织介质探索者外加,如果使用此模式,应使用新资产文件夹参数替代文件夹上文提及的参数设置媒体探索者文件夹是否定义资产文件夹以组织MediaExplorer资产公共标识包括斜线,确保使用该模式中可用选项之一设置公共标识路径
    • 产品环境使用动态文件夹模式动态文件夹上方表示主机媒体库首选项和响应获取资源细节方法将包含显示名并资产文件夹响应键
    • 动态文件夹模式更多细节见动态文件夹-新建上传API参数.

资产类型

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

本节包含以下题目:

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

  • 何时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.agrosoland.com/demo/image/private/sample.jpg

注解
私有原创资产可暂时存取,例如,使客户在购买后访问网站存取照片要做到这一点,你需要交付限时签名的URL可直接使用API或可使用API private_download_urlUtils方法生成时间有限并签名URL链接原创资产,然后向相关客户提供细节见 提供有限访问私有资产

验证资产

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

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

币游平台网页版官方如果资产上传为“认证”,则该资产及其衍生资源都无法不经认证访问URL返回错误

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

替换现有资产

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

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

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

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

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

小技巧
另一种确保最新版本资产交付的方法是在交付URL中包括版本值方法要求新版本资产上传时更新生产代码中的交付URLs,但修改立即生效细节见 资产版本.

注解
  • 视产品环境搭建而定,覆盖资产可清除标签、上下文和结构元值if you has主管理员角色,你可以改变行为 在产品环境媒体库首选项板块内保留这些字段值时新版资产覆盖老版值(除非您指定不同的值标签标签,上下文或元数据参数部分上传)
  • 使用无效功能时有数大考量举例说,如果URL里没有版本号, 内含公共标识分片, 默认时这些URL不失效 。失效媒体资产细节见失效CDN缓存媒体资产.

并见:备份版管理

反馈发送

评分本页 :