SuperAPI AI 工具集

cloudinary

设计与创作

查看项目

更新于 10-16 06:44

技能介绍

用途:该技能面向 Cloudinary 图片 CDN 的上传、优化 URL 生成与资产管理,适合博客图片及其他媒体资源场景。

主要能力:Cloudinary 可按浏览器请求提供 AVIF/WebP 等优化格式并支持实时转换。URL 基础模式为 https://res.cloudinary.com/<cloud_name>/image/upload/<transforms>/<public_id>。常用参数包括 f_auto(按 Accept 头自动选择格式)、q_auto及其变体(q_auto:low/eco/good/best)、w_N/h_N 尺寸、c_fill 裁剪、c_fit 适配、g_auto 焦点检测、dpr_2.0 等;博客正文常用 f_auto,q_auto,w_1200,社交卡片常用 f_auto,q_auto,w_1200,h_630,c_fill。

使用方式:需先在环境中设置 CLOUDINARY_URL(必填敏感),CLOUDINARY_CLOUD_NAME、CLOUDINARY_API_KEY、CLOUDINARY_API_SECRET 可选。Node.js SDK 安装 npm install -D cloudinary --save-exact,可用 cloudinary.uploader.upload 上传并打印 secure_url;CLI 安装 pipx install cloudinary-cli,可用 cld uploader upload 或 cld search 检索。若配置了 cloudinary-asset-mgmt MCP 服务器,可用 upload-asset、search-assets、get-asset-details、transform-asset、list-images、delete-asset、asset-rename、create-folder 等工具。文件夹约定为 blog/{slug}/、brand/、social/。

适用场景:博客与媒体图片上传、生成响应式与社交卡图片链接、批量上传脚本、在 Markdown 或 frontmatter 中引用图片等。

限制:必须妥善保管密钥,切勿回显或记录。Astro 场景下若希望使用 Cloudinary CDN 交付(f_auto、q_auto、边缘缓存),不要把 res.cloudinary.com 加入 image.domains,否则 Astro 会在构建时本地重编码。常见问题包括 401 未授权、图片过大可改 q_auto:low/eco、视网膜模糊可用 w_2400 或 dpr_2.0。费用、价格及更完整平台支持暂未提供。