用途:通过 Cloudinary API 管理图像与视频等媒体资源,适用于用户提到 Cloudinary、上传图片、变换图片或媒体资产的场景。
主要能力:支持无签名上传(需先在控制台创建 Unsigned 上传预设)与签名上传;支持从本地文件或 URL 上传图片和视频;可指定自定义 public_id 组织文件夹;上传响应中的 secure_url 可直接用于 Markdown 引用。URL 支持实时变换,如 w_300,h_200 缩放、f_auto,q_auto 自动格式与质量、c_fill 裁剪,并可组合使用。视频可通过 l_video: 叠加与 fl_splice 标志在 URL 中拼接,支持统一尺寸、淡入淡出过渡及图片作为片头。删除媒体使用 image/destroy 或 video/destroy 接口。
使用方式:签名上传需生成时间戳,并按参数字母顺序拼接后计算 SHA1 签名,再以 curl 提交 api_key、timestamp、signature 等字段。示例命令:curl -X POST "https://api.cloudinary.com/v1_1/<your-cloud-name>/image/upload" -F "file=@/path/to/image.png" -F "upload_preset=your_preset_name"。故障排查可运行 zero doctor check-connector --env-name CLOUDINARY_TOKEN。
限制:URL 长度约 2000 字符,限制可拼接视频数量;首次请求触发服务端处理较慢;10 个以上视频建议改用 ffmpeg 或专用视频 API。免费额度为每月 25 credits,约 25000 次变换或约 25GB 存储/带宽,适合个人项目。签名时参数必须按字母顺序排序。