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

申请文件上传(分片直传会话)

申报文件元信息后创建上传会话。文件字节按分片直传对象存储、不经 API 服务器:

需要 Bearer 令牌

请求体

字段必填类型约束说明
filename必填string≤255
content_type必填stringMIME 类型,须在算法/模态白名单内
size必填integer≥1
sha256必填string格式 ^[a-f0-9]{64}$内容 SHA-256,小写十六进制
user_ref可选string≤160合作方平台的最终用户标识(推荐填写):仅用于用量归属与统计, 经 GET /v1/usage 的 by_user 维度查询,支撑贵司用户级计费
target_algorithm_id可选string≤160目标算法 ID(推荐填写):上传资产将登记到该算法所属项目的 命名空间,供其分析直接引用;跨模态上传(Raman/NMR/MS 等) 时必填,否则资产落在默认项目,对应算法将无法引用
请求示例(curl)
curl -X post https://api.cleerscience.com/v1/uploads \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"filename": "sample-msms.csv", "content_type": "text/csv", "size": 89, "sha256": "395bcc5a7589832743d577e7834e528358a8f98a911de5726df94611e7c31b58", "user_ref": "partner-user-101", "target_algorithm_id": "spectro-raman-analysis"}'
响应 201
{
  "upload_id": "upl_7d2kx9q4",
  "asset_ref": {
    "asset_id": "ast_c4m8x2",
    "version": 1
  },
  "part_size_bytes": 8388608,
  "total_parts": 1,
  "expires_at": "2026-09-17T09:00:00Z"
}

状态码

HTTP说明
201上传会话已创建
422文件大小超限或摘要格式错误
429