新建分子生成任务接口
功能介绍
输入分子属性约束，创建分子生成任务。
URI
POST /v1/{project_id}/task/generation
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
华为云项目id |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户 token |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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 |
用户已开启的自定义属性集合 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
name |
否 |
String |
属性名称 |
|
type |
是 |
String |
属性约束类型 枚举值：
|
|
bool |
否 |
Boolean |
属性约束类型bool的参数 |
|
range |
否 |
Array of numbers |
属性约束类型range的参数 |
|
struct |
否 |
表5 object |
结构约束参数 |
|
quantiles |
否 |
Array of numbers |
属性约束类型minimize和maximize的参数 最小值：0.0 最大值：1.0 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
structs |
是 |
Array of strings |
子结构SMILES |
|
exclusive |
是 |
Boolean |
是否排除子结构 |
|
operator |
否 |
String |
多个子结构之间的逻辑关系 缺省值：or 枚举值：
|
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
protein |
否 |
String |
蛋白质3D结构，使用gzip压缩然后转base64格式 最小长度：1 最大长度：10000000 |
|
bounding_box |
否 |
表7 object |
结合口袋，包含口袋中心位置和尺寸大小 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
center |
否 |
Array of numbers |
口袋中心坐标。 x, y, z轴的坐标 |
|
size |
否 |
Array of numbers |
口袋尺寸大小。x, y, z轴的大小 最小值：1.7 最大值：500 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
id |
是 |
String |
自定义属性的ID（API侧） 最小长度：1 最大长度：64 |
|
prop_definition |
否 |
表9 object |
属性定义的元信息 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
id |
否 |
String |
属性业务侧ID 最小长度：1 最大长度：128 |
|
name |
否 |
String |
属性名称 最小长度：1 最大长度：32 |
|
type |
否 |
String |
属性类型 枚举值：
|
|
description |
否 |
String |
属性具体描述信息 最小长度：0 最大长度：256 |
|
value_range |
否 |
表10 object |
属性有效值域区间 |
|
optimal_range |
否 |
表10 object |
属性最优值域区间 |
|
warning_range |
否 |
表10 object |
属性欠佳值域区间 |
|
style |
否 |
String |
模型参数呈现类型 枚举值：
|
|
confidential_interval |
否 |
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 |
错误码
请参见错误码。
