SuperAPI AI 工具集

sirv-api

编程与开发

查看项目

更新于 10-15 22:17

技能介绍

用途:该技能用于集成 Sirv REST API(基础地址 https://api.sirv.com),在代码中完成 Sirv CDN 的图片与文件管理,包括上传、下载、删除、复制、重命名、目录列举、元数据维护、文件搜索及异步任务。

主要能力:文件操作(/v2/files/upload、download、delete、copy、rename、mkdir、readdir);元数据操作(meta、meta/title、meta/description、meta/tags、meta/product);异步任务(spin2video、video2spin、zip、batch/delete、3d/model2GLB,返回 job ID 后轮询进度);账户与限额查询(/v2/account、/v2/account/limits)。搜索每页最多 100 条,超过 1000 条结果需用 scrolling search,其为约 20 分钟缓存的时点快照。

使用方式:先向 /v2/token 发送 clientId 与 clientSecret 获取 token,token 有效期 20 分钟,长任务需刷新。后续请求在 Authorization 头携带 Bearer token。查询字符串中的文件与文件夹路径需 URL 编码(/ 编码为 %2F),搜索语法中的特殊字符 { } / \ ! 空格需转义。可用 /v2/files/fetch 从稳定源 URL 导入远程原图。

适用场景:批量迁移、图片目录维护、按扩展名或修改时间搜索、上传后写入标题/描述/标签/产品字段、生成 ZIP 或视频转换等。

限制与注意:修改端点字段、路径转义、元数据字段名或分页行为前应先查阅官方文档(https://apidocs.sirv.com/ 等)。批量操作前检查账户限额。应保留上游状态码与 Sirv 错误详情,区分认证失败与请求体/查询失败,并为失败端点补充回归测试。具体收费、价格与平台支持情况暂未提供。