上传临时文件

用来把临时文件(不超过500M)上传到VectCut，注意这里并没有上传到素材库，只是一个临时链接，1小时后失效。（内测）

请求方式

{
  "file_name": "demo.jpeg"
}

说明：

file_name 不必完整的路径，但是后缀名要正确

最终上传文件名、object_key、目录都以服务端回包为准

第一步：获取直传参数和下载链接

示例：

输出结果示例：

{
  "bucket_name": "jianying-upload-tmp",
  "file_name": "vectcut_koubo_tmp_file_3fe75ec500db4cbc92e3d3143cd9dfc1.jpeg",
  "folder": "agent_tmp/6921810bab8bfad6516eccd1",
  "key_prefix": "agent_tmp/6921810bab8bfad6516eccd1",
  "max_file_size_bytes": 524288000,
  "object_key": "agent_tmp/6921810bab8bfad6516eccd1/vectcut_koubo_tmp_file_3fe75ec500db4cbc92e3d3143cd9dfc1.jpeg",
  "success": true,
  "upload": {
    "expire_at": "2026-07-21T07:29:00.000Z",
    "form_data": {
      "OSSAccessKeyId": "LTAI5t8QxFyxBtk3ApZgrQfZ",
      "Signature": "6nNnBk0uzxZLBH2qssrlG5for+w=",
      "key": "agent_tmp/6921810bab8bfad6516eccd1/vectcut_koubo_tmp_file_3fe75ec500db4cbc92e3d3143cd9dfc1.jpeg",
      "policy": "eyJleHBpcmF0aW9uIjoiMjAyNi0wNy0yMVQwNzoyOTowMC4wMDBaIiwiY29uZGl0aW9ucyI6W1siZXEiLCIka2V5IiwiYWdlbnRfdG1wLzY5MjE4MTBiYWI4YmZhZDY1MTZlY2NkMS92ZWN0Y3V0X2tvdWJvX3RtcF9maWxlXzNmZTc1ZWM1MDBkYjRjYmM5MmUzZDMxNDNjZDlkZmMxLmpwZWciXSxbImNvbnRlbnQtbGVuZ3RoLXJhbmdlIiwwLDUyNDI4ODAwMF0seyJzdWNjZXNzX2FjdGlvbl9zdGF0dXMiOiIyMDAifV19",
      "success_action_status": "200"
    },
    "host": "https://jianying-upload-tmp.oss-cn-hangzhou.aliyuncs.com",
    "method": "POST",
    "upload_url": "https://jianying-upload-tmp.oss-cn-hangzhou.aliyuncs.com"
  },
  "download": {
    "signed_url": "https://jianying-upload-tmp.oss-cn-hangzhou.aliyuncs.com/agent_tmp/6921810bab8bfad6516eccd1/vectcut_koubo_tmp_file_3fe75ec500db4cbc92e3d3143cd9dfc1.jpeg?OSSAccessKeyId=xxx&Expires=xxx&Signature=xxx",
    "expires_seconds": 3600,
    "expire_at": "2026-07-21T08:14:00.000Z"
  }
}

说明：

upload 用于上传文件

download.signed_url 是预签好的下载链接，有效期固定 1 小时

第二步：上传文件到 OSS

拿到上一步回包后，直接把 upload.form_data 中的字段原样作为表单字段提交到 upload.upload_url。

示例：

说明：

key 必须使用接口返回值，不能手改

policy、OSSAccessKeyId、Signature 必须原样透传

file 改成你本地真实文件路径

如果回包里还有 x-oss-security-token，上传时也要作为 -F 字段一起传

第三步：使用下载链接

上传成功后，直接使用 download.signed_url 即可访问文件。

示例：

https://jianying-upload-tmp.oss-cn-hangzhou.aliyuncs.com/agent_tmp/6921810bab8bfad6516eccd1/vectcut_koubo_tmp_file_3fe75ec500db4cbc92e3d3143cd9dfc1.jpeg?OSSAccessKeyId=xxx&Expires=xxx&Signature=xxx

说明：

该链接有效期固定 1 小时

失败判定标准

初始化接口失败：

返回 401：用户未登录或 Token 无法识别

返回 403：当前用户不在白名单中

返回 500：服务端生成上传策略失败

OSS 上传失败：

返回 403：签名不匹配、表单字段被改动、策略已过期，或文件大小超出 500MB

返回非 200：上传失败，需要查看 OSS 返回内容

下载链接失效：

链接超过 1 小时后访问失败，需重新调用初始化接口获取新的 download.signed_url

调用注意事项

上传必须在 upload.expire_at 之前完成，过期后需要重新请求初始化接口

该接口限制的是单文件最大 500MB

download.signed_url 从初始化接口返回时开始计时，有效期固定为 1 小时

如果初始化后长时间未上传，可能出现上传成功时下载链接已经接近过期，或者已经过期

curl --location 'https://open.vectcut.com/sts/upload/agent_tmp/init' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "file_name": "demo.jpeg" }'

{ "bucket_name": "jianying-upload-tmp", "download": { "expire_at": "2026-07-21T08:47:38.000Z", "expires_seconds": 3600, "signed_url": "http://jianying-upload-tmp.oss-cn-hangzhou.aliyuncs.com/agent_tmp/6921810bab8bfad6516eccd1/vectcut_koubo_tmp_file_demo_93491db1dbcd455681ec1662e532c6a8.jpeg?OSSAccessKeyId=LTAI5t8QxFyxBtk3ApZgrQfZ&Expires=1784623658&Signature=4BbnEKIWzdYIEKBm6JQRhwClb9E%3D" }, "file_name": "vectcut_koubo_tmp_file_demo_93491db1dbcd455681ec1662e532c6a8.jpeg", "folder": "agent_tmp/6921810bab8bfad6516eccd1", "key_prefix": "agent_tmp/6921810bab8bfad6516eccd1", "max_file_size_bytes": 524288000, "object_key": "agent_tmp/6921810bab8bfad6516eccd1/vectcut_koubo_tmp_file_demo_93491db1dbcd455681ec1662e532c6a8.jpeg", "success": true, "upload": { "expire_at": "2026-07-21T08:02:38.000Z", "form_data": { "OSSAccessKeyId": "LTAI5t8QxFyxBtk3ApZgrQfZ", "Signature": "zwcU6V8p6gkxo6OdDwrfIZ+oyzU=", "key": "agent_tmp/6921810bab8bfad6516eccd1/vectcut_koubo_tmp_file_demo_93491db1dbcd455681ec1662e532c6a8.jpeg", "policy": "eyJleHBpcmF0aW9uIjoiMjAyNi0wNy0yMVQwODowMjozOC4wMDBaIiwiY29uZGl0aW9ucyI6W1siZXEiLCIka2V5IiwiYWdlbnRfdG1wLzY5MjE4MTBiYWI4YmZhZDY1MTZlY2NkMS92ZWN0Y3V0X2tvdWJvX3RtcF9maWxlX2RlbW9fOTM0OTFkYjFkYmNkNDU1NjgxZWMxNjYyZTUzMmM2YTguanBlZyJdLFsiY29udGVudC1sZW5ndGgtcmFuZ2UiLDAsNTI0Mjg4MDAwXSx7InN1Y2Nlc3NfYWN0aW9uX3N0YXR1cyI6IjIwMCJ9XX0=", "success_action_status": "200" }, "host": "https://jianying-upload-tmp.oss-cn-hangzhou.aliyuncs.com", "method": "POST", "upload_url": "https://jianying-upload-tmp.oss-cn-hangzhou.aliyuncs.com" } }

请求方式

第一步：获取直传参数和下载链接

第二步：上传文件到 OSS

第三步：使用下载链接

失败判定标准

调用注意事项

请求参数

返回响应

上传临时文件

请求方式#

第一步：获取直传参数和下载链接#

第二步：上传文件到 OSS#

第三步：使用下载链接#

失败判定标准#

调用注意事项#

请求参数

返回响应

请求方式

第一步：获取直传参数和下载链接

第二步：上传文件到 OSS

第三步：使用下载链接

失败判定标准

调用注意事项