SuperAPI AI 工具集

blink-storage

智能体与模型

查看项目

更新于 10-15 17:27

技能介绍

用途:为项目提供文件存储,支持上传、下载、删除与获取公开访问地址,可用于头像、文档、图片等场景。

主要能力:SDK 提供 upload、download、remove;上传可传 onProgress 回调跟踪百分比,返回 publicUrl;download 返回 downloadUrl 与 filename,可自定义文件名;remove 支持一次删除多个文件。SDK 会根据内容自动识别文件类型并修正扩展名。上传为仅新增,重复路径返回 409,需用时间戳或随机 ID 保证唯一。上传后的文件返回直接 HTTPS 地址,格式为 https://storage.googleapis.com/{project}/uploads/{filename}.{ext},公开可访问且带扩展名,适合作为 AI 视觉输入的图片 URL。

MCP 工具:blink_storage_list 按可选路径前缀列出文件;blink_storage_url 获取已存文件的公开 CDN URL;blink_storage_delete 删除文件。

CLI 用法:blink storage upload ./photo.jpg --path uploads/photo.jpg 上传;blink storage list 列出文件;blink storage list uploads/ 列出指定路径下的文件。

鉴权要求:upload() 无需鉴权,为公开仅新增(不可覆盖);download() 需要鉴权,使用签名 URL;remove() 需要鉴权,要求 JWT。

常见错误与处理:409 conflict 表示路径已存在,需加时间戳或随机 ID;Invalid path 由特殊字符导致,可用 path.replace(/[^a-zA-Z0-9_-/.]/g, '_') 清理;File too large 表示超出限制,需压缩或拆分文件。

限制:资料未提供具体文件大小上限、存储配额、价格与平台支持范围,暂未提供。