币游国际平台

开发者登陆指南

最新更新:Jan-23-2024

云化币游国际平台解决方案通过易用RESTAPS向应用程序编程添加图像视频上传、变换、优化和交付能力币游国际平台Cloudinary提供各种SDK库包APIs,使你能够无缝地将可编程媒体功能与现有应用代码整合

本页高层次概述将云化程序整合到应用中所需步骤,并链接到更详细的文档

过程的每一步都包含基于你现有代码编程偏好应用需求做决策其中一些问题在下方每一步起首都突出显示

除此页面外,

SDK快速启动币游国际平台:逐步拷贝片段帮助你用你最喜爱语言在5分钟或更短时间设置、配置并运行可云程序媒体项目
试一试代码探索器和特征演示快速链接所有内线代码探索器、沙盒和交互特征演示器,设计这些演示器是为了帮助你用各种云性特征玩学
入机常见问题币游国际平台集合最常用问题开发者使用云化程序媒体评价或启动
服务介绍Cloudinary服务架构概述、资产存储、安全性、可用附加文件以及其他高层次服务运作细节

上页:

开工创建您的账号并搭建您的产品环境

问题解答

注册选项是什么
产品环境是什么
产品环境云名应是什么
开机前应设置哪个账户和产品环境设置

创建账号并搭建产品环境只需几分钟时间

通过Google、Github或email签名并搭建双因子认证

万一你还没有云型账号,你可以注册免费账号

使用邮箱地址、Google账号或GitHub账号注册注册邮箱时,不可忘记查找欢迎光云并点击内部验证链路设置您的账号为活动

账户激活后,考虑改善账号安全策略双因子验证(2FA)推荐给生产产品环境或贵组织安全策略包括免费账号以及通过GitHub注册者、Google注册者或email注册者

SSO可用于企业账号,并推荐百余用户或贵组织安全策略

内账号安全控制台设置页面检查或修改二因子认证(2FA)SAML/SSO登录设置您的账号

重要点

if you注册第三方登录(如GitHub),修改邮箱将导致访问云式账号失败由于缺乏正确证书,无法恢复访问更新邮件或前期邮件if you need改变第三方邮箱地址联系支持.

创建并探索您的账号

创建账户时初始产品环境并创建取决于平面图上位时,你也许能创建多个产品环境(前称子账户)。

小技巧

创建时算法云名随机生成初始 产品环境.云名稍后将用在媒体URL中从云中传送,所以这是一个好主意改变云名描述性文件为您的组织、网站或应用稍晚页上再介绍

举例说,你可能创建“控件程序”和“生产环境”,或为不同网站创建不同的产品环境或,或,如果你为第三方客户应用应用应用程序,你可以为每个客户创建单独的产品环境

每种产品环境都有一个单独的资产存储库此外,有些选项和偏好定在产品环境层次上,而另一些选项和偏向则全局性

活动产品环境显示产品导航菜单中显示产品环境显示名if one定义.否则它显示云名

开始页面

注册新账号时短口调查打开帮助理解你如何使用云并保证你有最佳经验

币游国际平台下一步,你将被带到可编程媒体开始启动页码币游国际平台本页包含信息引导大全帮助你启动云库包括如何访问证书如何搭建SDK并介绍云化可编程媒体名词

熟悉云控制台

多半云化工作直接开发入你最喜爱IDE但有些事只能做和/或有时更容易/更快地在云控制台UI中做

要启动控件台最重要的领域是证书段排成一行机牌板页,媒体探索者并设置设置.

详情控制台云台.

产品环境认证

上头产品环境认证上段机牌板页显示产品环境证书使用您的账号创建证书包含您的云名标识符和您的API密钥并密钥需要它sdk配置或直接运行API请求

可管理API密钥存取密钥控制台设置页面可添加、激活、禁用和命名存取密钥对生成额外存取密钥后,产品环境首个存取密钥API密钥显示产品环境认证段内

上头API环境变量合并三大证书值并可以复制快速配置SDK和其他服务器端整合

查查这个视频教程帮助查找证书

重要点

贵族云名并API密钥币游国际平台产品环境特有并用于赋能或配置各种可云性程序媒体特征如前所述,云名也是从云中传送的媒体资产URL的一部分将这两个值输入客户端代码没有问题
贵族API秘密用于认证并永远不得以客户端代码或组织外任何其他方式曝光
默认新账户只有一个产品环境.支付账号可多产品环境可用于生产和中转环境等,或产品环境不同可并行使用不同的产品、网站、组织、地理或应用

媒体库

上头媒体库Cloudinary控制台网页提供综合UI管理产品环境内所有数字资产,包括浏览文件夹、执行高级搜索、汇编资产并汇编成a-hoc集合、通过评论资产与其他Cloudinary用户协作资产、拖放新资产等等

币游国际平台创建新程序化媒体产品环境时,媒体库提供一组样本资产媒体库特征实验使用这些资产

更多细节见数字资产管理向导

可选性更新云名和其他设置

可开始使用默认设置云化系统,但有一些初始设置,从一开始或可考虑修改

访问设置时点击设置设置图标左下角

视图或更新云名

On账号控制台设置页面可见当前产品环境云名注册期间自动生成

云名是产品环境独有标识符多处使用包括云内资产交付URL这可能对SEO有价值, 所以它是一个好主意,你的云名好表示你的组织、网站或应用

只要你还没有上传超过1000新资产到产品环境内,你现在就可以修改云名也可以设置或修改产品环境显示名中选描述名显示为云控制台左下角产品环境选择器显示器显示产品环境云名

注解

创建新产品环境时提供样本资产不计数改变云名的1000资产限值,也不计数产品环境存储定值
云名不敏感字符串由2-128字母数字符和连字符组成,从字母开始并必须是所有云式账户独有性
需要修改云名产品环境已经超过1000资产,需要提交支持请求.
修改云名将使所有缓存URL和所有前导变换无效修改云名当前活动产品环境也可能使当前会话失效,要求你退出并重入控制台
如果您账户中存在多产品环境,可编辑云名和/或显示自产品环境段底账号页面设置

检查个人设置

内my剖析控制台设置页面用户可检查个人电子邮件通知和登录偏好并搭建二因子认证

检查上传设置

可能想检查或修改下文产品环境设置上传控制台设置页面

自动备份:时间开机上传文件同时复制到二级写保护位置,并多处修改文件表示必要时很容易恢复旧版默认备份为云存储位置,这意味着当覆盖现有资产时,云存储总用量会增加客户对支付计划或谷歌云存储
激活此选项后按保存底部页面上可返回此选项并选择执行初始备份if you want to already备份当前产品环境中的任何文件

检查用户设置

添加用户到您的账号管理用户名分配角色识别定义Cloudinary控制台区域权限所有账户至少有3个用户可升级计划增加用户数上发计划并想加用户超出计划限量时, 可单独购买用户订阅量, 以便全队开发者能合作从云端交付资产

多用户账号、角色权限等细节详解用户设置.

配置 webhook通知

内webhook通知控制台设置页或经触发器方法管理员API中,可指定URLs在完成某些API方法调用或控制台UI操作后接收通知如果指定多通知URL,可指定特定通知URL接收某些操作和方法调用响应,但不指定其他响应

不同类型webhook通知细节和样本响应见webhook通知.

检查媒体库偏好

访问权限媒体库偏好,确认你选择数字资产管理从产品选择器上左端控制台然后选择首选项从产品导航菜单位居控制台左侧

身为开发者,你不妨考虑媒体库优先选项如下:

上传新版本资产时保留现有元数据默认写入资产清除所有标签、上下文元值和结构元值偏向保留这些值(除非为该值指定了不同的值)标签标签,上下文或元数据参数部分上传)选择此选项选项同时影响媒体库程序上传
结构化元数据管理结构化元数据允许预定义数打字段,无论有无验证规则,视之为产品环境内每一项资产可选或必用字段举个例子,如果应用支持用户生成内容,你可以定义结构元数据字段,这些元数据字段将作为终端用户上传的一部分抓取和传递,以跟踪用户上传资产、产品类别、国家或其他重要数据等事物,并可以确保这些字段持续用于产品环境内所有资产
可定义结构元数据字段管理元数据UI通过选择结构化元数据从产品导航菜单位居控制台左侧
并有可能用程序化方法定义元数据字段元数据API方法.字段创建后,可用程序化设置字段值元数据参数解析上传或显式命令,元数据方法上传API或手动输入媒体探索者.

二叉配置您的SDK

问题解答

SDK用哪个
哪些配置选项我应该设置全局我的SDK
快速启动SDKs方式是什么

币游国际平台云化开发开源SDK大数组以方便实现服务端和客户端代码中的云化编程媒体功能SDK库包载云端APIs并额外提供各种实用助手方法,使应用中能应用综合图像视频上传、变换、优化和交付能力,使用代码与现有应用代码无缝整合

选择SDK使用

云端提供SDK后端、前端和移动开发

检查全表云型SDKs支持来决定想和哪位一起工作

小技巧

并有各种实用性社区开发框架集成需要使用或帮助

安装SDK并将其列入应用代码

可使用下文示例使用相关包管理器安装SDK更详细的指令和额外选项审查安装搭建段相关SDK指南.

设置全局配置选项

所有SDK系统,你至少需要配置云名.
sdks后端也需要配置api_key并i_secret.
面向所有遗留SDKs,你可能想设置安全性参数切换真实性保证变换URL总生成HTTPS
私密CDN或CName需要同时配置可选配置或想设置
sdks设置全局配置选项的一些基本例子

查找更多资料说明何地和如何为SDK定义云式配置选项配置段相关SDK指南.

SDK快速启动

启动云式最佳方式是运行遍历SDK快速启动语言选择

快速启动提供分步代码片段帮助你实现端对端项目上下运行,从实战SDK搭建到交付优化变换媒体5分钟或更少.

3级添加上传能力

问题解答

哪种上传方法最适合我的需要
哪种上传选项对app有用
向云形迁移现有资产哪种迁移最适合我

云化提供各种选项从应用程序向产品环境上传资产

上传a实现自上传功能上传方法上传API这种方法可直接调用自定义代码或使用云端SDK包并大大简化实现您也可以选择币游平台网页版官方直接上传资源云形上载非签名- 看它如何完成码箱示例.

下简单示例显示单行代码从远程URL上传图像https://www.example.com/mysample.jpg并设置公有标识样本_woman使用后端SDKs或RESTAPI
上传部件帮助用户从设备或社交媒体或媒体存储账户上传图像、视频或其他文件部件只需要几行avaScript代码才能融入应用中,并可用非签名上传可选实现,使你能够提供它作为完全前端上传解决方案并消除内部交互媒体上传能力开发需求
自动上传以动态URL映射为基础,懒散地将现有资产迁移到云化产品环境首次访问URL后动态检索资产并存储到云化产品环境

小技巧

想要手动上传资产到产品环境以便交付时,您也可以从文件系统拖放相关文件夹媒体探索者或打开媒体探索器 上传部件从任何源头上传媒体文件

上传偏好

可指定范围广的参数定制文件上传方式包括:

资产名匹配上传文件名或包含随机字符
哪些资源数据应该提取/存储/绑定资产
分析或变换上传资产
接听或点播变换为上传
是否向通知URL发送状态更新

多远

检查全表可用上传参数.

可设置这些偏向,或直接指定为参数上传命令或指定预定义上传预置

上传预置允许集中定义一组上传偏好,而不是在每次上传调用时具体说明偏好可定义多上传预设并应用不同预设也可以分配预设值默认用于API或媒体库上传

可创建并管理预设并设置产品环境预设上传控制台设置页面程序化地创建和管理预置上传_预置odminAPI方法新建产品环境带默认媒体库上传预设

更多上传预设信息见上传预置.

迁移

币游平台网页版官方云化提供各种方法将现有资源迁移到云化

直接迁移:一次基于上传API方法币游平台网页版官方分步迁移所有现有资源
懒汉迁移币游平台网页版官方:按需从远程位置迁移资源使用自动上传中迁移仅在访问者请求资源时进行
批量迁移代码完全、自动和无遗图像从制作环境迁移到云形云迁移工具.

4级变换并交付资产

问题解答

哪种自动特效和调适可应用到交付媒体
哪些高级变换选项可能与我需要的特征相关
需要我对交付资产应用优化功能吗
云化如何帮助我自动响应图像传送
如何通过媒体资产改善SEO

上传原创图像或视频一次并使用云形生成不同版本从原创或飞或预发,使你能够交付优化响应媒体引导CDN完全适合您的图形设计遍及各种设备并解决

图像视频转换

通过添加变换参数图像或视频 URL(通常是通过SDK函数),您可以对交付媒体应用各种大式自动调整和效果

小技巧

也可以使用变换 URL 变换构建器.或选,你可以取我们变换变换图片库起始点并随后在变换构建器中进一步修改它以适应您的需要变换构建程序生成URL和SDK代码定义变换以便复制语言

学习应用图像变换

例举上传下列sample_woman图像后

直接使用图像URL中的实时变换参数,可自动应用下列修改交付图像:

生成200x200px平面缩图w_200,h_200,c_thumb,g_face)
圆角半径20像素r_20)
添加5像素宽黑边框bo_5px_solid_black)
添加cloudinary_icon_white图像叠加至主图像宽度的25%,从东北角放出10像素(垂直横向),半透明化l_cloudinary_icon_white,o_50,w_0.25,fl_relative,g_north_east,y_10,x_10)
以PNG交付实现圆角透明

URL和对应SDK传送码看起来像这些变换

最伟大的变换之一即一旦你选择变换组合满足你的需求, 你就可以可靠应用并交付图像相同变换.举个例子,这里是相同的自动生成脸缩图图片商人(原创上传照片:

学习应用视频变换

同样的概念应用视频变换今次我们将

缩放视频高度320像素h_320c_标度)
Pad视频与模糊版同段视频生成480*320风景视频c_pad,h_320,w_480,b_blurred:400:15)
从视频删除音频流水量:mute)
双视频速度e_accelerate:100)

完整变换参数列表见变换URLAPI引用.

注解

帐号计费计划部分取决于开单周期内完成的“变换式”总数细节见变换如何计数.

优化交付

云化利用数个CDN系统,包括Akamai主机CDN系统提供商,并使用数千个全局传送服务器加上云端高级缓存技巧和动态URL资产交付媒体资产高效传递

图像视频优化

提供最小文件大小的资产,同时维护视觉质量,保存带宽并改进网站性能云化自动执行确定图像优化默认值币游平台网页版官方云形提供许多其他特征优化你向用户提供的资源,例如

自动重力高山市g_aut)为图片制作或视频播放指令云形调整资产以填充所需尺寸并同时包括主题
自动格式选择高山市f_aut)为图片制作或视频播放指令云化公司以请求浏览器最优格式向用户提供资产
自动质量选择高山市q_aut)为图片制作或视频播放指令云化智能质量编码法应用最优质量压缩级和编码设置,以特定内容、格式和请求浏览器为基础,生成并交付高视觉质量资产同时最小化文件大小