SuperAPI AI 工具集

bundle-social-uploads

营销与增长

查看项目

更新于 10-15 16:51

技能介绍

用途:该技能面向 Bundle.social 的媒体文件上传与管理,供为社交媒体帖子准备图片、视频等素材时使用。

主要能力:

  • 直传:POST /api/v1/upload/,使用 multipart/form-data 提交文件,适合约 100MB 以下的图片和短视频。
  • URL 导入:POST /api/v1/upload/from-url,由 Bundle.social 从指定 URL 服务端抓取文件。
  • 大文件分片上传(约 100MB 以上):先 POST /api/v1/upload/init(参数 fileName、fileSize、mimeType、teamId),再向返回的 uploadUrl 上传分片(遵循 S3 multipart 约定,可分片并行),最后 POST /api/v1/upload/finalize(携带 ETags 和 PartNumbers)。
  • 管理:GET /api/v1/upload/ 列出上传(可按 teamId、type、search 过滤),GET /api/v1/upload/{id} 查看单个,DELETE /api/v1/upload/{id} 删除单个,DELETE /api/v1/upload/ 批量删除。

使用方式:认证使用请求头 x-api-key: <your-api-key>,基础 URL 为 https://api.bundle.social。上传后获得 upload ID,创建帖子时作为 media 使用(可与 bundle-social-posts 技能配合)。上传类型枚举为 image、video、other。

限制与注意:上传端点使用 multipart/form-data,非 JSON;from-url 由服务端抓取文件;上传大文件前应检查组织的上传用量。技能约定生成 curl 示例时以 <your-api-key> 为占位符,不实际调用 API。平台枚举和标准错误见 references/README.md,端点细节见 references/05-upload.md。作者 Anton Gulin,来源仓库 antongulin/bundle-social-api-skill。