mcpField
C
cos-upload

cos-upload

github.com/acedatacloud云与 DevOps17203 次安装今天更新
代码仓库

关于 cos-upload

cos-upload 是将本地文件上传到 AceData CDN 并获取公开 URL 的技能，适用于需要在 API 间传递素材或保存处理中间文件的流程。它提供同步单文件上传，并提醒注意令牌、文件大小及公开访问风险。

主要功能

  1. 01上传单个本地文件
  2. 02返回公开 CDN URL
  3. 03保留安全文件扩展名
  4. 04提供 MIME 类型元数据

适用场景

  1. 01将生成的图像传给视频 API
  2. 02发布最终视频或封面
  3. 03保存中间文件供后续流程下载

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/acedatacloud/skills --skill cos-upload

安装后在 Claude Code 中输入/cos-upload确认已加载。

详细介绍

上传文件 → AceData CDN URL

将本地文件转换为公开的 https://cdn.acedata.cloud/... URL。

上传（multipart，同步）

curl -s -X POST https://platform.acedata.cloud/api/v1/files/ \
  -H "Authorization: Bearer $ACEDATACLOUD_PLATFORM_TOKEN" \
  -F "file=@/path/to/video.mp4"

HTTP 200 时，请使用返回的 file_url，不要自行构造 URL。平台会生成唯一的 uploads/<uuid> 路径，并保留上传文件的安全扩展名。返回的 mime 是写入对象存储元数据的 MIME 类型。每个请求只能上传一个文件（多个文件请循环处理）；默认每个文件的大小限制为 100 MB。

使用扩展名与实际内容匹配的文件名。上传部分的 MIME 类型会按提供的值存储；如果未提供或为 application/octet-stream，平台会根据文件名使用标准 MIME 映射推断类型。扩展名处理和 MIME 类型推断都不会转换文件字节。

适用场景

  • 通过 URL 将生成的资源传递给其他 API — 例如，上传一张 gpt-image-2 静帧，然后将其 URL 传给 seedance / kling 进行图生视频。
  • 发布／返回已完成的产物（最终视频、封面图片）。
  • 保存中间产物，以便后续运行时重新下载并继续处理。

注意事项

  • 身份验证使用平台令牌（ACEDATACLOUD_PLATFORM_TOKEN），而不是各服务的 API 令牌——文件端点位于 platform.acedata.cloud，而非 api.acedata.cloud。
  • 如果你的运行环境自带上传工具（例如由工作器管理存储凭据），请优先使用它，以避免直接处理平台令牌。
  • 返回的 URL 无需身份验证即可公开访问；请勿上传敏感数据。文件保留期限遵循平台当前的存储策略，不保证永久归档；如需长期归档，请使用你自己的对象存储。

评论

支持 Markdown