Logo

第二步：上传文件

在同合云里，绝大多数处理接口都不会直接接收二进制文件，而是要求你先上传文件并拿到一个 file_id。后续创建任务时，只需要传这个 file_id 即可。

请求信息

项目值
请求方法POST
请求路径/base/file/upload
Content-Typemultipart/form-data
鉴权方式Authorization 请求头直接传 API Key

cURL 示例

curl -X POST https://api.ai-mcn.tv:10000/base/file/upload \
  -H "Authorization: YOUR_API_KEY" \
  -F "file=@/path/to/your/video.mp4"

成功响应示例

{
  "code": 200,
  "msg": "文件上传成功~",
  "data": {
    "file_id": "537489015178246",
    "original_name": "video.mp4",
    "size": 10485760,
    "blake3_id": "a1b2c3d4...",
    "base_ext": ".mp4",
    "download_url": "/download/a1/537489015178246.mp4",
    "created_at": "2026-04-05T08:00:00Z",
    "expire_at": "2026-06-04T00:00:00Z",
    "is_expired": false
  }
}

你需要记住的字段

  • file_id：创建任务时的唯一输入
  • download_url：原文件下载地址
  • expire_at：文件过期时间

常见问题

Q：上传同一个文件会重复存储吗？

不会。后端会根据文件内容指纹做去重，命中时直接返回已有文件记录，并自动处理续期。

Q：支持多大的文件？

当前后端限制单文件最大 20 GB。

下一步