医疗智能体 EIHEALTH-创建分子生成作业:请求参数

时间:2024-07-13 09:27:44

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

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

最小长度:1

最大长度:32768

表3 请求Body参数

参数

是否必选

参数类型

描述

basic_info

CreateDrugJobBasicInfo object

作业基本信息。

smiles_list

Array of strings

分子表达式列表。

最小长度:1

最大长度:512

数组长度:10 - 10000

molecule_file

DrugFile object

分子文件,分子表达式列表和分子文件二选一,分子文件优先级最高。

binding_sites

Array of BindSiteDto objects

靶点列表。

数组长度:0 - 2

weak_constraints

Array of WeakConstraintDto objects

弱约束集合。

数组长度:0 - 10

strong_constraints

Array of StrongConstraintDto objects

强约束集合。

数组长度:0 - 5

base_model_id

String

基模型id。

缺省值:pangu-drug-model

最小长度:0

最大长度:128

model_ids

Array of strings

模型id列表。

最小长度:1

最大长度:128

数组长度:0 - 10

num_trials

Integer

生成分子数量。

最小值:0

最大值:5000

缺省值:5000

表4 CreateDrugJobBasicInfo

参数

是否必选

参数类型

描述

name

String

作业的名称,取值范围:[5,64],允许大小写字母、数字、空格、下划线(_)和中划线(-),只能以数字或字母开头。

最小长度:5

最大长度:64

labels

Array of strings

标签,取值范围[0,5],单个标签最大长度32字符,支持中文、字母、数字、空格、下划线和中划线,且不能以空格开头或者结尾。

最小长度:1

最大长度:32

数组长度:0 - 5

表5 DrugFile

参数

是否必选

参数类型

描述

source

String

受体的数据源:外部网络数据(如R CS B在线数据库)、用户私有数据中心、承载租户公共数据(含样例/公共库)。

枚举值:

  • EXTRANET
  • PRIVATE
  • PUBLIC
  • RAW

url

String

文件URL,当数据源为外部网络数据时为https地址;用户私有数据中心为项目路径、公共数据场景为obs地址。

最小长度:1

最大长度:2000

format

String

文件格式,支持PDB、SDF、MOL2、SMI,仅数据源为RAW时提供。

最小长度:1

最大长度:6

data

String

文件原始数据,仅数据源为RAW时提供。

最小长度:0

最大长度:10000000

表6 BindSiteDto

参数

是否必选

参数类型

描述

name

String

靶点名称,只能设置为target1或者target2。

最小长度:1

最大长度:128

receptor

ReceptorDrugFile object

受体文件。

bounding_box

BoundingBoxDto object

结合口袋,包含口袋中心位置和尺寸大小。

remove_ion

Boolean

去除受体中的离子。

缺省值:true

remove_water

Boolean

去除受体中的水分子。

缺省值:true

remove_ligand

Boolean

去除受体中的配体分子。

缺省值:true

add_hydrogen

Boolean

增加氢原子。

缺省值:false

表7 ReceptorDrugFile

参数

是否必选

参数类型

描述

source

String

受体的数据源:外部网络数据(如RCSB在线数据库)、用户私有数据中心、承载租户公共数据(含样例/公共库)。

枚举值:

  • EXTRANET
  • PRIVATE
  • PUBLIC
  • RAW

url

String

文件URL,当数据源为外部网络数据时为https地址;用户私有数据中心为项目路径、公共数据场景为obs地址。

最小长度:1

最大长度:2000

format

String

文件格式,仅支持PDB,仅数据源为RAW时提供。

最小长度:1

最大长度:6

data

String

文件原始数据,仅数据源为RAW时提供。

最小长度:0

最大长度:10000000

表8 BoundingBoxDto

参数

是否必选

参数类型

描述

center

Array of doubles

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

最小值:-9999999

最大值:99999999

数组长度:3 - 3

size

Array of floats

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

最小值:2

最大值:500

数组长度:3 - 3

padding

Float

填充。

最小值:0

最大值:20

表9 WeakConstraintDto

参数

是否必选

参数类型

描述

id

String

自定义模型id,仅弱约束为模型时填写。

最小长度:1

最大长度:128

name

String

属性名称。

最小长度:1

最大长度:128

type

String

属性约束类型。

枚举值:

  • bool
  • range
  • struct
  • minimize
  • maximize
  • interaction

bool

Boolean

属性约束类型bool的参数。

range

Array of floats

属性约束类型range的参数。

最小值:-9999

最大值:9999

数组长度:2 - 2

struct

StructureConstraintParamsDto object

结构约束参数。

quantiles

Array of floats

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

最小值:0.0

最大值:1.0

数组长度:2 - 2

interaction

InteractionConstraintDto object

相互作用力约束参数。

表10 StrongConstraintDto

参数

是否必选

参数类型

描述

id

String

自定义模型id,仅强约束为模型时填写。

最小长度:1

最大长度:128

name

String

属性名称。

最小长度:1

最大长度:128

type

String

属性约束类型。

枚举值:

  • bool
  • range
  • struct
  • interaction

bool

Boolean

属性约束类型bool的参数。

range

Array of floats

属性约束类型range的参数。

最小值:-9999

最大值:9999

数组长度:2 - 2

struct

StructureConstraintParamsDto object

结构约束参数。

interaction

InteractionConstraintDto object

相互作用力约束参数。

表11 StructureConstraintParamsDto

参数

是否必选

参数类型

描述

structs

Array of strings

子结构SMILES。

最小长度:1

最大长度:120

数组长度:1 - 8

exclusive

Boolean

是否排除子结构。

operator

String

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

枚举值:

  • or
  • and
表12 InteractionConstraintDto

参数

是否必选

参数类型

描述

interactions

Array of Interaction objects

相互作用力列表。

数组长度:1 - 8

exclusive

Boolean

是否排除指定的约束作用力。

operator

String

多个作用力之间的逻辑关系。

枚举值:

  • or
  • and
表13 Interaction

参数

是否必选

参数类型

描述

binding_site

String

靶点,只支持target1或target2。

最小长度:1

最大长度:128

type

String

相互作用力类型:氢键、疏水作用、盐桥、π-π堆积、π-阳离子。

枚举值:

  • hydrogen_bond
  • hydrophobic_action
  • salt_bridge
  • pi_stacking
  • pi_cation

amino_acid

String

氨基酸。

最小长度:4

最大长度:16

support.huaweicloud.com/api-eihealth/CreateGenJob.html