跳转到主要内容
PUT
上传文件

上传文件

这个接口不直接接收文件内容,而是先签发一个对象存储 PUT 地址。客户端拿到地址后再自行上传文件。
  • 适合图片、视频和其他媒体素材的预上传。
  • 使用 API Key 认证。
  • 默认过期时间为 900 秒,最短 60 秒,最长 3600 秒。

方法与路径

请求示例

上传图片

上传视频

上传文件到预签名地址

拿到 upload_url 后,对目标地址发起 PUT 请求上传文件本体。Content-Type 须与请求预签名地址时传入的值一致。

响应示例

认证

Body

headers
object
上传请求的自定义头部。
Content-Type
string
文件 MIME 类型,例如 image/pngimage/jpegvideo/mp4
params
object
上传 URL 的附加查询参数。如果不需要额外参数,可以传空对象 {}

Response

download_url
string
上传成功后可直接传给图像、视频和任务接口的公网 URL。
expire
integer
预签名 URL 的过期时间,单位秒。
method
string
上传方法,当前固定为 PUT
upload_url
string
带签名的对象存储上传地址。

使用场景

上传后再用于素材 URL 接口

  1. 调用 /v1/file/upload 取得 upload_urldownload_url
  2. upload_url 发起 PUT 上传文件。
  3. 在接受公网素材 URL 的接口中把 download_url 作为输入字段传入。

注意事项

这个接口只负责签发上传地址,不会替你上传文件本身。真正的文件上传需要客户端对 upload_url 再发一次 PUT 请求。

相关接口