开发者接口

用同一套参数从工作台或接口运行工具。以下定义来自当前工具目录。

计算任务默认返回模拟结果，响应中的 result.simulated 为 true。站外调用若启用了密钥，需要附带 x-api-key 请求头。

工具参数

工具

ESMFold 不依赖多序列比对（MSA），直接由蛋白语言模型的表示推断三维坐标。适合大批量初筛，以及同源序列稀少的蛋白。

参数	说明	类型	默认值与范围
sequence必填	氨基酸序列	序列文本	—
num_recycles	循环次数	数字	4；最小 1；最大 12

请求示例

省略的可选参数会使用默认值。示例地址为本地服务，部署后替换为对应域名。

curl -X POST http://localhost:3000/api/v1/jobs \
  -H 'Content-Type: application/json' \
  -d '{
  "tool": "esmfold",
  "name": "ESMFold 示例任务",
  "params": {
    "num_recycles": 4,
    "sequence": ">ubiquitin\nMQIFVKTLTGKTITLEVEPSDTIENVKAKIQDKEGIPPDQQRLIFAGKQLEDGRTLSDYNIQKESTLHLVLRLRGG"
  },
  "batch": false
}'

只校验参数，不创建任务。

读取状态与下载结果

提交成功后，从 jobs 数组读取任务编号。状态依次为 queued、running，最终进入 succeeded、failed 或 cancelled；到达终态后停止轮询。批量提交返回多条任务及共同的 batchId。

curl http://localhost:3000/api/v1/jobs/任务编号

# 文件名从 result.files 中读取
curl -o result.pdb "http://localhost:3000/api/v1/jobs/任务编号/files/result.pdb?download=1"

接口一览

方法	路径	用途
GET	/api/v1/tools	工具目录与参数定义
GET	/api/v1/tools/{id}	单个工具的参数定义
POST	/api/v1/jobs/validate	校验参数和估算算力点
POST	/api/v1/jobs	提交单次或批量任务
GET	/api/v1/jobs	查询任务，可按 tool、status、batch、limit 筛选
GET	/api/v1/jobs/{id}	任务状态与结果摘要
POST	/api/v1/jobs/{id}/cancel	取消运行中的任务
GET	/api/v1/jobs/{id}/files/{name}	读取文件；加 ?download=1 下载
POST	/api/v1/pipelines	提交串联工作流
GET	/api/v1/pipelines	查看并推进工作流

当前提供 HTTP 接口，尚未提供独立 Python 开发包或模型上下文协议（MCP）服务。