媒体管理助手

当媒体资源库开始失控

Cloudinary 能稳定地托管图片和视频、生成变换副本，但围绕它的运维成本很容易被低估：营销活动的目录散落在账户各处，上传行为的格式限制、目标目录、标签规则只存在于某个人的记忆或半废弃的脚本里，派生版本越积越多，配额往往是在上传被静默阻断之后才被发现。

媒体管理助手（Cloudinary Automation）把这部分工作搬进对话界面。你不必在控制台、CLI 和原始 API 之间来回切换，直接用自然语言下达指令，Agent 代为执行。

核心能力

目录组织：创建文件夹结构，并用类 Lucene 表达式按名称、路径、创建时间搜索目录；CLOUDINARY_SEARCH_FOLDERS 支持 max_results（1–500）、sort_by 与 next_cursor 翻页。

上传预设：一次性定义落地目录、允许格式、标签、incoming 与 eager 变换、是否允许未签名上传、覆盖规则、resource_type、AI 自动标签置信度、审核类型以及通知地址，把上传约束集中到一处。

资产查询：按 public_id + resource_type + type 取回详情，可选返回调色板信息、人脸坐标、IPTC/XMP 元数据、质量分、感知哈希、历史版本与关联资产。

变换与派生资源：列出已有变换；用 CLOUDINARY_EXPLICIT_RESOURCE 对既有资产预生成 eager 变换、替换标签、移动目录、写入 context 元数据并可触发 CDN 失效；用 CLOUDINARY_DELETE_DERIVED_RESOURCES 批量清理派生资源（单次最多 100 个）。

用量与配置：查看存储、带宽、请求量与剩余配额，获取环境配置和标签清单。

Webhook 触发器：为上传完成、变换完成等事件配置回调地址。

适用边界与注意点

• CLOUDINARY_CREATE_FOLDER 在路径已存在时可能报错或空操作，目录命名需要设计成幂等的。
• 上传预设中的 allowed_formats、folder、unsigned 必须与实际上传方式一致，否则上传会被拒绝。
• CLOUDINARY_GET_RESOURCE_BY_PUBLIC_ID 严格校验三个参数，任一不符即失败。
• 目录列举是精确匹配，路径拼写错误只会返回空列表而非报错。
• 配额是账户级的，触顶后上传会被静默阻断，需要主动检查用量。
• invalidate=true 触发的 CDN 失效最多需要 1 小时才能生效。
• 上传预设中 overwrite=true 不能与 unsigned=true 同时使用。