更新时间:2024-02-07 GMT+08:00
分享

查询CPI任务

功能介绍

通过CPI任务ID查询CPI任务状态及结果。

URI

GET /v1/{project_id}/task/cpi/{task_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

华为云项目id

task_id

String

CPI任务ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户 token

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

status

String

异步任务的状态:等待中、运行中、已完成、失败

枚举值:

  • waiting

  • running

  • finished

  • failed

task_data

CpiTaskData object

CPI任务的请求体

result

CpiResult object

CPI任务的返回结果

表4 CpiTaskData

参数

参数类型

描述

header

String

蛋白质FASTA标题

最小长度:0

最大长度:128

fasta

String

蛋白质FASTA序列

最小长度:4

最大长度:2048

smiles_list

Array of strings

分子SMILES表达式列表

threshold

Float

打分阈值,分值必须大于该阈值才会返回

num_results

Integer

期望最大返回条目数(排序后取Top)

custom_props

Array of CustomProp objects

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

表5 CpiResult

参数

参数类型

描述

header

String

蛋白质FASTA标题

fasta

String

蛋白质FASTA序列

prop_names

Array of strings

分子ADMET属性名列表

result

Array of CpiResultItem objects

返回CPI的模型结果

custom_props

Array of CustomProp objects

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

表6 CpiResultItem

参数

参数类型

描述

smiles

String

分子SMILES表达式

props

Array of objects

分子ADMET属性值列表

score

Number

分子与蛋白质的打分

表7 CustomProp

参数

参数类型

描述

id

String

自定义属性的ID(API侧)

最小长度:1

最大长度:64

prop_definition

PropDefinition object

属性定义的元信息

表8 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

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

表9 ValueRange

参数

参数类型

描述

lower

Number

值域下限

lower_inclusive

Boolean

是否包含值域下限

upper

Number

值域上限

upper_inclusive

Boolean

是否包含值域上限

请求示例

查询一个CPI任务

GET https://{endpoint}/v1/{project_id}/task/cpi/{task_id}

响应示例

状态码: 200

CPI任务查询成功响应

{
  "status" : "finished",
  "result" : {
    "header" : "T1030 BibA, 273 residues",
    "fasta" : "DQELGKQSRRSQDIIKSLGFLSSDQKDILVKSISSSKDSQLILKFVTQATQLNNAESTKAKQMAQNDVALIKNISPEVLEEYKEKIQRASTKSQVDEFVAEAKKVVNSNKET",
    "custom_props" : [ {
      "id" : "3b2dce64-c244-11ed-acf5-0255ac100017",
      "prop_definition" : {
        "id" : "c4c07032d1934671a0dfe3bd10416eea",
        "name" : "custom_prop_name",
        "type" : "numerical",
        "description" : "custom_prop_description"
      }
    } ],
    "prop_names" : [ "formula", "ab", "acute_toxicity_rule", "bace", "3b2dce64-c244-11ed-acf5-0255ac100017", "3b2dce64-c244-11ed-acf5-0255ac100017_std" ],
    "result" : [ {
      "smiles" : "c1ccccc1",
      "score" : 0.388029,
      "props" : [ "C6H6", "base", 0, 0.128335, 0.43, 0.28 ]
    }, {
      "smiles" : "C1CCCCC1",
      "score" : 0.304194,
      "props" : [ "C6H12", "base", 0, 0.163034, 0.43, 0.28 ]
    } ]
  }
}

状态码

状态码

描述

200

CPI任务查询成功响应

404

CPI任务ID不存在

错误码

请参见错误码

相关文档