API / 申请接入

让 AI Agent接入真实实验室

将计算设计与实验验证连接起来:提交候选序列、跟踪实验进度,再把结构化结果送入下一轮模型迭代。

API 流程 / 交互演示

从创建实验到回收数据,逐步查看每个接口会处理什么。以下均为演示内容,非正式 API 契约。

01

创建实验

POST/experiments

选择实验类型,输入靶蛋白,调整序列及复孔数;右侧请求示例会同步变化。

实验类型

候选序列演示IgG样本
6 / 6
POSThttps://api.example.com/v1/experiments
{
  "experiment_spec": {
    "experiment_type": "binding",
    "target_name": "PD-1 / PDCD1",
    "sequences": {
      "IgG-Seq1-H": "EVQLLESGGGLVQPGGSLRLSCAASGFTFSSYAMSWVRQAPGKGLEWVSAISGSGGSTYYADSVKGRFTISRDNSKNTLYLQMNSLRAEDTAVYYCAKDRGSYRYDGYFDYWGQGTLVTVSS",
      "IgG-Seq1-L": "DIQMTQSPSSLSASVGDRVTITCRASQSVSSSYLAWYQQKPGKAPKLLIYDASNLETGVPSRFSGSGSGTDFTLTISSLQPEDFATYYCQQYNSYPLTFGGGTKVEIK",
      "IgG-Seq2-H": "QVQLVESGGGVVQPGRSLRLDCKASGITFSNDYGMHWVRQAPGKGLEWVAVIWYDGSKRYYADSVKGRFTISRDNSKNTLFLQMNSLRAEDTAVYYCARDRGYYGYDVFAYWGQGTLVTVSS",
      "IgG-Seq2-L": "EIVLTQSPATLSLSPGERATLSCRASKSVSTSGYSHLHWYQQKPGQAPRLLIYLASEYLESGVPARFSGSGSGTDFTLTISSLEPEDFAVYYCQHSRELPYTFGGGTKVEIK",
      "IgG-Seq3-H": "EVQLVESGGGLVQPGGSLRLSCAASGFTFDDYAISWVRQAPGKGLEWVSRIPSDSGSTKYAPSVKGRFTISRDNSKNTLFLQMNSLRAEDTAVYYCASSLGGYAEYFAYWGQGTLVTVSS",
      "IgG-Seq3-L": "DIVMTQSPSSLSASLGDRVTITCRASENIYSYLAWYQQKPGKAPKLLIYAASTLQSGVPSRFSGSGSGTDFTLTISSLQPEDFATYYCQKYNSAPLTFGGGTKVEIK"
    },
    "n_replicates": 1
  }
}
02

跟踪进度

GET/experiments/{id}/updates

通过 API 或 Webhook 跟踪实验生命周期。

200 OK
GEThttps://api.example.com/v1/experiments/exp_demo_042/updates
{
  "experiment_id": "exp_demo_042",
  "experiment_code": "ML-DEMO-042",
  "items": [
    {
      "index": 1,
      "title": "实验创建",
      "status": "已完成",
      "content": "已收到您48条靶向PD-1的候选序列。",
      "timestamp": "2026-09-17T07:19:25.195Z"
    },
    {
      "index": 2,
      "title": "报价发送",
      "status": "未完成"
    },
    {
      "index": 3,
      "title": "项目确认",
      "status": "未完成"
    },
    {
      "index": 4,
      "title": "材料到位",
      "status": "未完成"
    },
    {
      "index": 5,
      "title": "基因合成",
      "status": "未完成"
    },
    {
      "index": 6,
      "title": "表达和纯化",
      "status": "未完成"
    },
    {
      "index": 7,
      "title": "SPR检测",
      "status": "未完成"
    },
    {
      "index": 8,
      "title": "数据分析",
      "status": "未完成"
    },
    {
      "index": 9,
      "title": "结果发送",
      "status": "未完成"
    }
  ]
}
03

查看结果

GET/experiments/{id}/results

查看候选序列的结合数据。切换图表和表格,右侧响应返回全部结果。

强结合 · 8 条 · KD < 1 nM中等结合 · 24 条 · 1–100 nM弱结合 · 16 条 · 100–1000 nM
0.11101001000

KD (nM) — 数值越低,结合越强

当前选中样本IgG-Seq03KD 0.14 nM · 强结合
见单独 csv 附件
200 OK
GEThttps://api.example.com/v1/experiments/exp_demo_042/results
{
  "experiment_id": "exp_demo_042",
  "experiment_code": "ML-DEMO-042",
  "target_id": "target_pdcd1",
  "target_name": "PD-1 / PDCD1",
  "n_replicates": 3,
  "items": [
    {
      "id": "result-01",
      "sequence_id": "igg-seq01",
      "sequence_name": "IgG-Seq01",
      "kd": 1e-8,
      "kd_units": "M",
      "kon": 112000,
      "koff": 0.0012,
      "binding_strength": "moderate"
    },
    {
      "id": "result-02",
      "sequence_id": "igg-seq02",
      "sequence_name": "IgG-Seq02",
      "kd": 1.2e-8,
      "kd_units": "M",
      "kon": 115000,
      "koff": 0.0014,
      "binding_strength": "moderate"
    },
    {
      "id": "result-03",
      "sequence_id": "igg-seq03",
      "sequence_name": "IgG-Seq03",
      "kd": 1.4e-10,
      "kd_units": "M",
      "kon": 185000,
      "koff": 0.000026,
      "binding_strength": "strong"
    },
    {
      "id": "result-04",
      "sequence_id": "igg-seq04",
      "sequence_name": "IgG-Seq04",
      "kd": 1.4e-8,
      "kd_units": "M",
      "kon": 119000,
      "koff": 0.0016,
      "binding_strength": "moderate"
    },
    {
      "id": "result-05",
      "sequence_id": "igg-seq05",
      "sequence_name": "IgG-Seq05",
      "kd": 1.6e-8,
      "kd_units": "M",
      "kon": 122000,
      "koff": 0.0019,
      "binding_strength": "moderate"
    },
    {
      "id": "result-06",
      "sequence_id": "igg-seq06",
      "sequence_name": "IgG-Seq06",
      "kd": 1.8e-8,
      "kd_units": "M",
      "kon": 125000,
      "koff": 0.0022,
      "binding_strength": "moderate"
    },
    {
      "id": "result-07",
      "sequence_id": "igg-seq07",
      "sequence_name": "IgG-Seq07",
      "kd": 2e-8,
      "kd_units": "M",
      "kon": 129000,
      "koff": 0.0026,
      "binding_strength": "moderate"
    },
    {
      "id": "result-08",
      "sequence_id": "igg-seq08",
      "sequence_name": "IgG-Seq08",
      "kd": 2.3e-10,
      "kd_units": "M",
      "kon": 202000,
      "koff": 0.000046,
      "binding_strength": "strong"
    },
    {
      "id": "result-09",
      "sequence_id": "igg-seq09",
      "sequence_name": "IgG-Seq09",
      "kd": 2.3e-8,
      "kd_units": "M",
      "kon": 132000,
      "koff": 0.003,
      "binding_strength": "moderate"
    },
    {
      "id": "result-10",
      "sequence_id": "igg-seq10",
      "sequence_name": "IgG-Seq10",
      "kd": 2.5e-8,
      "kd_units": "M",
      "kon": 135000,
      "koff": 0.0034,
      "binding_strength": "moderate"
    },
    {
      "id": "result-11",
      "sequence_id": "igg-seq11",
      "sequence_name": "IgG-Seq11",
      "kd": 1.1e-7,
      "kd_units": "M",
      "kon": 68000,
      "koff": 0.0073,
      "binding_strength": "weak"
    },
    {
      "id": "result-12",
      "sequence_id": "igg-seq12",
      "sequence_name": "IgG-Seq12",
      "kd": 2.8e-8,
      "kd_units": "M",
      "kon": 138000,
      "koff": 0.0039,
      "binding_strength": "moderate"
    },
    {
      "id": "result-13",
      "sequence_id": "igg-seq13",
      "sequence_name": "IgG-Seq13",
      "kd": 1.3e-7,
      "kd_units": "M",
      "kon": 70000,
      "koff": 0.009,
      "binding_strength": "weak"
    },
    {
      "id": "result-14",
      "sequence_id": "igg-seq14",
      "sequence_name": "IgG-Seq14",
      "kd": 3.1e-10,
      "kd_units": "M",
      "kon": 219000,
      "koff": 0.000068,
      "binding_strength": "strong"
    },
    {
      "id": "result-15",
      "sequence_id": "igg-seq15",
      "sequence_name": "IgG-Seq15",
      "kd": 3.1e-8,
      "kd_units": "M",
      "kon": 142000,
      "koff": 0.0044,
      "binding_strength": "moderate"
    },
    {
      "id": "result-16",
      "sequence_id": "igg-seq16",
      "sequence_name": "IgG-Seq16",
      "kd": 1.5e-7,
      "kd_units": "M",
      "kon": 73000,
      "koff": 0.011,
      "binding_strength": "weak"
    },
    {
      "id": "result-17",
      "sequence_id": "igg-seq17",
      "sequence_name": "IgG-Seq17",
      "kd": 3.5e-8,
      "kd_units": "M",
      "kon": 145000,
      "koff": 0.005,
      "binding_strength": "moderate"
    },
    {
      "id": "result-18",
      "sequence_id": "igg-seq18",
      "sequence_name": "IgG-Seq18",
      "kd": 1.8e-7,
      "kd_units": "M",
      "kon": 75000,
      "koff": 0.013,
      "binding_strength": "weak"
    },
    {
      "id": "result-19",
      "sequence_id": "igg-seq19",
      "sequence_name": "IgG-Seq19",
      "kd": 3.8e-8,
      "kd_units": "M",
      "kon": 148000,
      "koff": 0.0057,
      "binding_strength": "moderate"
    },
    {
      "id": "result-20",
      "sequence_id": "igg-seq20",
      "sequence_name": "IgG-Seq20",
      "kd": 2.1e-7,
      "kd_units": "M",
      "kon": 78000,
      "koff": 0.016,
      "binding_strength": "weak"
    },
    {
      "id": "result-21",
      "sequence_id": "igg-seq21",
      "sequence_name": "IgG-Seq21",
      "kd": 4.2e-10,
      "kd_units": "M",
      "kon": 236000,
      "koff": 0.000099,
      "binding_strength": "strong"
    },
    {
      "id": "result-22",
      "sequence_id": "igg-seq22",
      "sequence_name": "IgG-Seq22",
      "kd": 4.2e-8,
      "kd_units": "M",
      "kon": 152000,
      "koff": 0.0064,
      "binding_strength": "moderate"
    },
    {
      "id": "result-23",
      "sequence_id": "igg-seq23",
      "sequence_name": "IgG-Seq23",
      "kd": 2.4e-7,
      "kd_units": "M",
      "kon": 80000,
      "koff": 0.019,
      "binding_strength": "weak"
    },
    {
      "id": "result-24",
      "sequence_id": "igg-seq24",
      "sequence_name": "IgG-Seq24",
      "kd": 4.6e-8,
      "kd_units": "M",
      "kon": 155000,
      "koff": 0.0071,
      "binding_strength": "moderate"
    },
    {
      "id": "result-25",
      "sequence_id": "igg-seq25",
      "sequence_name": "IgG-Seq25",
      "kd": 2.8e-7,
      "kd_units": "M",
      "kon": 83000,
      "koff": 0.023,
      "binding_strength": "weak"
    },
    {
      "id": "result-26",
      "sequence_id": "igg-seq26",
      "sequence_name": "IgG-Seq26",
      "kd": 5e-8,
      "kd_units": "M",
      "kon": 158000,
      "koff": 0.0079,
      "binding_strength": "moderate"
    },
    {
      "id": "result-27",
      "sequence_id": "igg-seq27",
      "sequence_name": "IgG-Seq27",
      "kd": 3.2e-7,
      "kd_units": "M",
      "kon": 85000,
      "koff": 0.027,
      "binding_strength": "weak"
    },
    {
      "id": "result-28",
      "sequence_id": "igg-seq28",
      "sequence_name": "IgG-Seq28",
      "kd": 3.7e-7,
      "kd_units": "M",
      "kon": 88000,
      "koff": 0.032,
      "binding_strength": "weak"
    },
    {
      "id": "result-29",
      "sequence_id": "igg-seq29",
      "sequence_name": "IgG-Seq29",
      "kd": 5.5e-10,
      "kd_units": "M",
      "kon": 254000,
      "koff": 0.00014,
      "binding_strength": "strong"
    },
    {
      "id": "result-30",
      "sequence_id": "igg-seq30",
      "sequence_name": "IgG-Seq30",
      "kd": 5.5e-8,
      "kd_units": "M",
      "kon": 162000,
      "koff": 0.0089,
      "binding_strength": "moderate"
    },
    {
      "id": "result-31",
      "sequence_id": "igg-seq31",
      "sequence_name": "IgG-Seq31",
      "kd": 4.3e-7,
      "kd_units": "M",
      "kon": 90000,
      "koff": 0.038,
      "binding_strength": "weak"
    },
    {
      "id": "result-32",
      "sequence_id": "igg-seq32",
      "sequence_name": "IgG-Seq32",
      "kd": 4.9e-7,
      "kd_units": "M",
      "kon": 93000,
      "koff": 0.045,
      "binding_strength": "weak"
    },
    {
      "id": "result-33",
      "sequence_id": "igg-seq33",
      "sequence_name": "IgG-Seq33",
      "kd": 6e-8,
      "kd_units": "M",
      "kon": 165000,
      "koff": 0.0099,
      "binding_strength": "moderate"
    },
    {
      "id": "result-34",
      "sequence_id": "igg-seq34",
      "sequence_name": "IgG-Seq34",
      "kd": 5.6e-7,
      "kd_units": "M",
      "kon": 95000,
      "koff": 0.053,
      "binding_strength": "weak"
    },
    {
      "id": "result-35",
      "sequence_id": "igg-seq35",
      "sequence_name": "IgG-Seq35",
      "kd": 6.3e-10,
      "kd_units": "M",
      "kon": 271000,
      "koff": 0.00017,
      "binding_strength": "strong"
    },
    {
      "id": "result-36",
      "sequence_id": "igg-seq36",
      "sequence_name": "IgG-Seq36",
      "kd": 6.6e-8,
      "kd_units": "M",
      "kon": 168000,
      "koff": 0.011,
      "binding_strength": "moderate"
    },
    {
      "id": "result-37",
      "sequence_id": "igg-seq37",
      "sequence_name": "IgG-Seq37",
      "kd": 6.5e-7,
      "kd_units": "M",
      "kon": 98000,
      "koff": 0.063,
      "binding_strength": "weak"
    },
    {
      "id": "result-38",
      "sequence_id": "igg-seq38",
      "sequence_name": "IgG-Seq38",
      "kd": 7.1e-8,
      "kd_units": "M",
      "kon": 171000,
      "koff": 0.012,
      "binding_strength": "moderate"
    },
    {
      "id": "result-39",
      "sequence_id": "igg-seq39",
      "sequence_name": "IgG-Seq39",
      "kd": 7.4e-7,
      "kd_units": "M",
      "kon": 100000,
      "koff": 0.074,
      "binding_strength": "weak"
    },
    {
      "id": "result-40",
      "sequence_id": "igg-seq40",
      "sequence_name": "IgG-Seq40",
      "kd": 7.8e-8,
      "kd_units": "M",
      "kon": 175000,
      "koff": 0.014,
      "binding_strength": "moderate"
    },
    {
      "id": "result-41",
      "sequence_id": "igg-seq41",
      "sequence_name": "IgG-Seq41",
      "kd": 7.8e-10,
      "kd_units": "M",
      "kon": 288000,
      "koff": 0.00022,
      "binding_strength": "strong"
    },
    {
      "id": "result-42",
      "sequence_id": "igg-seq42",
      "sequence_name": "IgG-Seq42",
      "kd": 8.5e-7,
      "kd_units": "M",
      "kon": 103000,
      "koff": 0.088,
      "binding_strength": "weak"
    },
    {
      "id": "result-43",
      "sequence_id": "igg-seq43",
      "sequence_name": "IgG-Seq43",
      "kd": 8.3e-8,
      "kd_units": "M",
      "kon": 178000,
      "koff": 0.015,
      "binding_strength": "moderate"
    },
    {
      "id": "result-44",
      "sequence_id": "igg-seq44",
      "sequence_name": "IgG-Seq44",
      "kd": 9.1e-7,
      "kd_units": "M",
      "kon": 105000,
      "koff": 0.096,
      "binding_strength": "weak"
    },
    {
      "id": "result-45",
      "sequence_id": "igg-seq45",
      "sequence_name": "IgG-Seq45",
      "kd": 9e-8,
      "kd_units": "M",
      "kon": 181000,
      "koff": 0.016,
      "binding_strength": "moderate"
    },
    {
      "id": "result-46",
      "sequence_id": "igg-seq46",
      "sequence_name": "IgG-Seq46",
      "kd": 9.4e-8,
      "kd_units": "M",
      "kon": 185000,
      "koff": 0.017,
      "binding_strength": "moderate"
    },
    {
      "id": "result-47",
      "sequence_id": "igg-seq47",
      "sequence_name": "IgG-Seq47",
      "kd": 9.4e-10,
      "kd_units": "M",
      "kon": 305000,
      "koff": 0.00029,
      "binding_strength": "strong"
    },
    {
      "id": "result-48",
      "sequence_id": "igg-seq48",
      "sequence_name": "IgG-Seq48",
      "kd": 9.8e-8,
      "kd_units": "M",
      "kon": 188000,
      "koff": 0.018,
      "binding_strength": "moderate"
    }
  ],
  "total": 48,
  "data_package_url": "/demo/megalaxy-lab-demo-results.csv"
}
接入闭环

一起规划第一次接入

告诉我们您的设计流程需要什么,我们可以共同评估实验范围和接入方式。

咨询 API 接入