Cleer
申请接入
API 参考 › 文件上传
POST/uploads/direct

小文件一步上传(≤ 20MB)

multipart 直传:文件字节经网关代理后落同一上传链路(网关内部完成

需要 Bearer 令牌
本端点为 multipart/form-data 表单上传(file 为文件内容)。
请求示例
_multipart: file=@raman-spectrum.csv; sha256=<文件SHA-256>; user_ref=partner-user-101(可选); target_algorithm_id=spectro-raman-analysis(推荐,跨模态必填)
响应 201
{
  "asset_ref": {
    "asset_id": "ast_8c0aee60",
    "version": 1
  },
  "status": "ready"
}

状态码

HTTP说明
201上传完成并校验通过
413超过 20MB 上限,请改用分片直传
422文件类型/大小/摘要校验不通过