API 参考 › 分析任务
POST/analyses
创建分析任务
异步创建。同一 Idempotency-Key 的重试不会重复计费、不会产生重复任务。
需要 Bearer 令牌
请求体
| 字段 | 必填 | 类型 | 约束 | 说明 |
|---|---|---|---|---|
algorithm_id | 必填 | string | ||
algorithm_version | 可选 | string | 不传则使用当前稳定版 | |
inputs | 必填 | object[] | ≥1 | 分析输入资产,引用完成上传后获得的 asset_ref |
parameters | 可选 | object | 算法参数,按 parameters_schema 校验 | |
prefilled_answers | 可选 | object | 预填答案(免对话模式),引擎跳过对应提问 | |
user_ref | 可选 | string | ≤160 | 合作方平台的最终用户标识(推荐填写):仅用于用量归属与统计, 经 GET /v1/usage 的 by_user 维度查询,支撑贵司用户级计费 |
curl -X post https://api.cleerscience.com/v1/analyses \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"algorithm_id": "msms-spectrum-analysis", "inputs": [{"asset_id": "ast_8c0aee60", "version": 1}], "parameters": {"top_n": 20}, "user_ref": "partner-user-101"}'{
"analysis_id": "run_4aa2949b082e4b74aee053cfe76b2e9a",
"status": "queued",
"algorithm": {
"id": "msms-spectrum-analysis",
"version": "0.1.0"
},
"replayed": false
}状态码
| HTTP | 说明 |
|---|---|
| 202 | 已受理 |
| 403 | 应用未开通该算法,或订阅已停用 |
| 409 | 幂等键冲突(同键不同请求体) |
| 422 | 输入或参数不符合算法 Schema |
| 429 |