Skip to main content
POST
上传图片

上传图片

这个接口不直接接收文件内容,而是先签发一个对象存储 PUT 地址。客户端拿到地址后再自行上传文件。
  • 适合图片、视频首帧和其他媒体素材的预上传。
  • 使用 API Key 认证,但返回结构是 /api/*success/message/data 包装。
  • 默认过期时间为 900 秒,最短 60 秒,最长 3600 秒。
  • 未显式传 prefix 时,会按当前用户自动生成 uploads/user/{id} 前缀。

方法与路径

请求示例

响应示例

认证

Body

file_name
string
原始文件名。服务端会根据扩展名生成对象键。未传时也可以正常工作,但通常建议显式传入。
content_type
string
文件 MIME 类型,例如 image/pngimage/jpegvideo/mp4
expires_in
integer
预签名 URL 有效期,单位秒。服务端会自动限制在 603600 之间。
prefix
string
对象键前缀。未传时默认使用 uploads/user/{id}

Response

success
boolean
是否成功。/api/* 接口优先用这个字段表示业务结果。
data.method
string
上传方法,当前固定为 PUT
data.upload_url
string
带签名的对象存储上传地址。
data.public_url
string
上传成功后可直接传给图像、视频和任务接口的公网 URL。

使用场景

上传后再用于素材 URL 接口

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

注意事项

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

相关接口