公共文件临时上传

Base:https://<租户 API 域名>/api/v1

鉴权:Authorization: Bearer <API_KEY>

临时存储限制

本接口仅用于临时文件中转。成功响应中的 url 最长有效期为 24 小时,平台可因存储回收、容量治理或安全策略在此之前失效。不得将该 URL 用作持久文件地址、唯一业务凭据或长期媒体库;需要长期保存时,请在有效期内下载并转存到自己的存储服务。

POST /upload

使用 multipart/form-data 提交单个 file 字段。平台将文件暂存于当前租户 API 域名可访问的本地路径,由平台的临时存储服务拉取并返回最终 URL。平台本地暂存文件在成功、失败或异常时都会删除。

请求字段:

字段位置类型必填说明
fileform-datafile是单个待上传文件。支持平台既有的图片、视频和通用文件扩展名。

默认单文件最大 512 MB;平台可通过 storage.openapi_upload.max_bytes 调整限制。

curl -X POST "https://<租户API域名>/api/v1/upload" \
  -H "Authorization: Bearer <API_KEY>" \
  -F "file=@./example.mp4"

成功响应:

{
  "code": 1,
  "msg": "success",
  "data": {
    "url": "https://files.example.com/openapi/12/20260814/abc.mp4",
    "path": "openapi/12/20260814/abc.mp4",
    "name": "example.mp4",
    "size": 123456,
    "mime_type": "video/mp4",
    "type": "video"
  }
}

响应字段:

字段类型说明
urlstring临时文件访问地址,最长有效期 24 小时,可能提前失效。
pathstring临时存储服务中的相对路径,仅供排查或同服务内引用,不保证长期可用。
namestring原始文件名。
sizeinteger上传文件字节数。
mime_typestring平台识别到的 MIME 类型。
typestringimage、video 或 file。

失败时返回 { "code": 0, "msg": "...", "data": null }。不返回内部存储服务地址、临时本地路径或认证信息。

使用边界

  • 接口不收取模型调用费用,但受 API Key 身份、限流和平台文件大小限制约束。
  • 仅可上传调用方有权处理的文件;不得上传违法、侵权、恶意程序或规避平台安全策略的内容。
  • 平台不承诺临时地址的固定保存时长、可恢复性、跨区域可用性或长期下载带宽。
  • 若上传后需要给第三方服务消费,请在同一业务流程内使用 url;不要将其写入长期订单、素材库或用户资料。

同类文章