更新时间:2023-06-16 GMT+08:00
分享

ADMET属性预测接口(默认+自定义属性)

功能介绍

计算小分子的物化性质,包括默认的吸收(adsorption)、分布(distribution)、代谢(metabolism)、清除(excretion)与毒性(toxicity),以及用户自定义的属性。

URI

POST /v2/{project_id}/admet

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

华为云项目ID,您可以从获取项目ID中获取。

最小长度:1

最大长度:128

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

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

表3 请求Body参数

参数

是否必选

参数类型

描述

smiles

String

分子SMILES表达式

custom_props

Array of CustomProp objects

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

表4 CustomProp

参数

是否必选

参数类型

描述

id

String

自定义属性的ID(API侧)

最小长度:1

最大长度:64

prop_definition

PropDefinition object

属性定义的元信息

表5 PropDefinition

参数

是否必选

参数类型

描述

id

String

属性业务侧ID

最小长度:1

最大长度:128

name

String

属性名称

最小长度:1

最大长度:32

type

String

属性类型

枚举值:

  • binary
  • numerical

description

String

属性具体描述信息

最小长度:0

最大长度:256

value_range

ValueRange object

属性有效值域区间

optimal_range

ValueRange object

属性最优值域区间

warning_range

ValueRange object

属性欠佳值域区间

style

String

模型参数呈现类型

枚举值:

  • number
  • probability

confidential_interval

Boolean

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

表6 ValueRange

参数

是否必选

参数类型

描述

lower

Number

值域下限

lower_inclusive

Boolean

是否包含值域下限

upper

Number

值域上限

upper_inclusive

Boolean

是否包含值域上限

响应参数

状态码: 200

表7 响应Body参数

参数

参数类型

描述

custom_props

Array of CustomProp objects

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

props

Object

分子ADMET属性字典(包含自定义属性)

表8 CustomProp

参数

参数类型

描述

id

String

自定义属性的ID(API侧)

最小长度:1

最大长度:64

prop_definition

PropDefinition object

属性定义的元信息

表9 PropDefinition

参数

参数类型

描述

id

String

属性业务侧ID

最小长度:1

最大长度:128

name

String

属性名称

最小长度:1

最大长度:32

type

String

属性类型

枚举值:

  • binary
  • numerical

description

String

属性具体描述信息

最小长度:0

最大长度:256

value_range

ValueRange object

属性有效值域区间

optimal_range

ValueRange object

属性最优值域区间

warning_range

ValueRange object

属性欠佳值域区间

style

String

模型参数呈现类型

枚举值:

  • number
  • probability

confidential_interval

Boolean

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

表10 ValueRange

参数

参数类型

描述

lower

Number

值域下限

lower_inclusive

Boolean

是否包含值域下限

upper

Number

值域上限

upper_inclusive

Boolean

是否包含值域上限

请求示例

预测一个分子的ADMET属性

{
  "smiles" : "c1ccccc1",
  "custom_props" : [ {
    "id" : "3b2dce64-c244-11ed-acf5-0255ac100017",
    "prop_definition" : {
      "id" : "c4c07032d1934671a0dfe3bd10416eea",
      "name" : "custom_prop_name",
      "type" : "numerical",
      "description" : "custom_prop_description"
    }
  } ]
}

响应示例

状态码: 200

ADMET成功响应

{
  "custom_props" : [ {
    "id" : "3b2dce64-c244-11ed-acf5-0255ac100017",
    "prop_definition" : {
      "id" : "c4c07032d1934671a0dfe3bd10416eea",
      "name" : "custom_prop_name",
      "type" : "numerical",
      "description" : "custom_prop_description"
    }
  } ],
  "props" : {
    "ab" : "base",
    "acute_toxicity_rule" : 0,
    "alarm_nmr_rule" : 0,
    "ames" : 4.555075065582059E-6,
    "3b2dce64-c244-11ed-acf5-0255ac100017" : 0.85
  }
}

状态码

状态码

描述

200

ADMET成功响应

400

分子SMILES输入不合法

错误码

请参见错误码

相关文档