Cleer
申请接入
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)
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"}'
响应 202
{
  "analysis_id": "run_4aa2949b082e4b74aee053cfe76b2e9a",
  "status": "queued",
  "algorithm": {
    "id": "msms-spectrum-analysis",
    "version": "0.1.0"
  },
  "replayed": false
}

状态码

HTTP说明
202已受理
403应用未开通该算法,或订阅已停用
409幂等键冲突(同键不同请求体)
422输入或参数不符合算法 Schema
429