文档首页/AI科学计算服务/API参考/API/小分子药物设计/药物通用接口/创建配体相似性图计算任务 - CreateDrugLigandSimilarityGraphTask
更新时间：2025-12-23 GMT+08:00
查看PDF
分享

创建配体相似性图计算任务 - CreateDrugLigandSimilarityGraphTask

功能介绍

创建配体相似性图计算任务。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

POST /v1/{project_id}/eihealth-projects/{eihealth_project_id}/drug-common/ligand/similarity-graph

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

项目ID，您可以从获取项目ID中获取。

约束限制：

不涉及

取值范围：

仅支持字母、数字、中划线和下划线，长度为[1-128]个字符。

默认取值：

不涉及

eihealth_project_id

是

String

参数解释：

空间ID，您可以从获取空间ID中获取。

约束限制：

不涉及

取值范围：

仅支持字母、数字、中划线和下划线，长度为[1-128]个字符。

默认取值：

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

用户Token。

Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，获取Token接口响应消息头中X-Subject-Token的值即为Token。

约束限制：

不涉及

取值范围：

长度为[1-32768]个字符。

默认取值：

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

mode

是

String

参数解释：

创建配体相似度图的模式。

约束限制：

不涉及

取值范围：

  • CENTER：中心模式

  • FREE：自由模式

默认取值：

不涉及

ligands

是

Array of CreateLigandSimilarityGraphLigandDto objects

参数解释：

配体列表。

约束限制：

配体数量范围为[2-101]。

取值范围：

不涉及

默认取值：

不涉及

表4 CreateLigandSimilarityGraphLigandDto

参数

是否必选

参数类型

描述

name

是

String

参数解释：

配体分子唯一名字，受体中的建议使用“{氨基酸}:{链}:{编号}”。

约束限制：

不涉及

取值范围：

长度为[1-32]个字符。

默认取值：

不涉及

smiles

是

String

参数解释：

分子SMILES表达式。

约束限制：

不涉及

取值范围：

长度为[1-512]个字符。

默认取值：

不涉及

main

否

Boolean

参数解释：

配体是否为主要配体，在中心模式下，必须指定1个主要配体。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

false

响应参数

状态码：201

表5 响应Body参数

参数

参数类型

描述

id

String

参数解释：

任务ID。

约束限制：

不涉及

取值范围：

长度为[1-128]个字符。

默认取值：

不涉及

请求示例

创建配体相似性图计算任务，创建模式为CENTER，配体列表为MolA、MolB。

https://{endpoint}/v1/{project_id}/eihealth-projects/{eihealth_project_id}/drug-common/ligand/similarity-graph

{
  "mode" : "CENTER",
  "ligands" : [ {
    "name" : "MolA",
    "smiles" : "c1ccccc1",
    "main" : true
  }, {
    "name" : "MolB",
    "smiles" : "c1ccccc1",
    "main" : false
  } ]
}

响应示例

状态码：201

配体相似度图任务创建成功响应。

{
  "id" : "c05ebc2029c24699af2354f67391604c"
}

状态码

状态码

描述

201

配体相似度图任务创建成功响应。

错误码

请参见错误码。

父主题：药物通用接口

相关文档