API 参考 › 文件上传
POST/uploads
申请文件上传(分片直传会话)
申报文件元信息后创建上传会话。文件字节按分片直传对象存储、不经 API 服务器:
需要 Bearer 令牌
请求体
| 字段 | 必填 | 类型 | 约束 | 说明 |
|---|---|---|---|---|
filename | 必填 | string | ≤255 | |
content_type | 必填 | string | MIME 类型,须在算法/模态白名单内 | |
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 -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"}'{
"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 |