文档首页/ 医疗智能体 EIHealth/ API参考/ API（AI辅助药物设计）/ 分子生成（MG）/ 新建分子生成任务接口
更新时间：2023-06-16 GMT+08:00
查看PDF
分享

新建分子生成任务接口

功能介绍

输入分子属性约束，创建分子生成任务。

URI

POST /v1/{project_id}/task/generation

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

华为云项目id

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户 token
表3 请求Body参数

参数

是否必选

参数类型

描述

num_trials

否

Integer

生成分子数量

strong_constraints

否

Array of 表4 objects

强约束集合

weak_constraints

否

Array of 表4 objects

弱约束集合

num_expected

否

Integer

期望最大返回条目数（排序后取Top）

initial_dataset

否

Array of strings

初始化分子集合

binding_site

否

表6 object

结合位点

custom_props

否

Array of 表8 objects

用户已开启的自定义属性集合
表4 MoleculeConstraint

参数

是否必选

参数类型

描述

name

否

String

属性名称

type

是

String

属性约束类型

枚举值：

  • bool
  • range
  • struct
  • minimize
  • maximize

bool

否

Boolean

属性约束类型bool的参数

range

否

Array of numbers

属性约束类型range的参数

struct

否

表5 object

结构约束参数

quantiles

否

Array of numbers

属性约束类型minimize和maximize的参数

最小值：0.0

最大值：1.0
表5 StructureConstraintParams

参数

是否必选

参数类型

描述

structs

是

Array of strings

子结构SMILES

exclusive

是

Boolean

是否排除子结构

operator

否

String

多个子结构之间的逻辑关系

缺省值：or

枚举值：

  • or
  • and
表6 BindingSite

参数

是否必选

参数类型

描述

protein

否

String

蛋白质3D结构，使用gzip压缩然后转base64格式

最小长度：1

最大长度：10000000

bounding_box

否

表7 object

结合口袋，包含口袋中心位置和尺寸大小
表7 BoundingBox

参数

是否必选

参数类型

描述

center

否

Array of numbers

口袋中心坐标。 x, y, z轴的坐标

size

否

Array of numbers

口袋尺寸大小。x, y, z轴的大小

最小值：1.7

最大值：500
表8 CustomProp

参数

是否必选

参数类型

描述

id

是

String

自定义属性的ID（API侧）

最小长度：1

最大长度：64

prop_definition

否

表9 object

属性定义的元信息
表9 PropDefinition

参数

是否必选

参数类型

描述

id

否

String

属性业务侧ID

最小长度：1

最大长度：128

name

否

String

属性名称

最小长度：1

最大长度：32

type

否

String

属性类型

枚举值：

  • binary
  • numerical

description

否

String

属性具体描述信息

最小长度：0

最大长度：256

value_range

否

表10 object

属性有效值域区间

optimal_range

否

表10 object

属性最优值域区间

warning_range

否

表10 object

属性欠佳值域区间

style

否

String

模型参数呈现类型

枚举值：

  • number
  • probability

confidential_interval

否

Boolean

模型推理是否呈现置信区间
表10 ValueRange

参数

是否必选

参数类型

描述

lower

否

Number

值域下限

lower_inclusive

否

Boolean

是否包含值域下限

upper

否

Number

值域上限

upper_inclusive

否

Boolean

是否包含值域上限

响应参数

无

请求示例

创建一个分子生成任务

{ 
  "num_trials" : 10000, 
  "weak_constraints" : [ { 
    "name" : "mw", 
    "type" : "range", 
    "range" : [ 100, 600 ] 
  }, { 
    "name" : "nhet", 
    "type" : "range", 
    "range" : [ 0, 15 ] 
  }, { 
    "name" : "fsp3", 
    "type" : "range", 
    "range" : [ 0.07317, null ] 
  }, { 
    "name" : "qedmean", 
    "type" : "maximize" 
  }, { 
    "name" : "sascore", 
    "type" : "minimize", 
    "quantiles" : [ 0.1, 0.9 ] 
  }, { 
    "name" : "3b2dce64-c244-11ed-acf5-0255ac100017", 
    "type" : "range", 
    "range" : [ 0.2, 0.5 ] 
  } ], 
  "initial_dataset" : [ "c1ccccc1", "C1CCCCC1" ], 
  "custom_props" : [ { 
    "id" : "3b2dce64-c244-11ed-acf5-0255ac100017", 
    "prop_definition" : { 
      "id" : "c4c07032d1934671a0dfe3bd10416eea", 
      "name" : "custom_prop_name", 
      "type" : "numerical", 
      "description" : "custom_prop_description" 
    } 
  } ] 
}

响应示例

状态码： 201

分子生成任务成功提交响应，返回分子生成任务ID

"87ba6b54-2288-4a5d-90a2-3db01c22a9d2"

状态码

状态码

描述

201

分子生成任务成功提交响应，返回分子生成任务ID

错误码

请参见错误码。

父主题： 分子生成（MG）

相关文档