# 新建CPI任务接口
#### 功能介绍
输入蛋白序列、小分子库，创建分子-蛋白互作预测任务。
#### URI
POST /v1/{project_id}/task/cpi
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述      |
|:---|:---|:---|:---|
| project_id | 是    | String | 华为云项目id |
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述       |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户 token |
   
表3请求Body参数 
| 参数           | 是否必选 | 参数类型                                                                                               | 描述                                  |
|:---|:---|:---|:---|
| 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 | 用户已开启的自定义属性集合                       |
   
 表4CustomProp 
| 参数              | 是否必选 | 参数类型                                                                                             | 描述                                    |
|:---|:---|:---|:---|
| id              | 是    | String                                                                                           | 自定义属性的ID（API侧） 最小长度：**1** 最大长度：**64** |
| prop_definition | 否    | [PropDefinition] object | 属性定义的元信息                              |
   
 表5PropDefinition 
| 参数                    | 是否必选 | 参数类型                                                                                     | 描述                                           |
|:---|:---|:---|:---|
| 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                                                                                  | 模型推理是否呈现置信区间                                 |
   
 表6ValueRange 
| 参数              | 是否必选 | 参数类型    | 描述       |
|:---|:---|:---|:---|
| lower           | 否    | Number  | 值域下限     |
| lower_inclusive | 否    | Boolean | 是否包含值域下限 |
| upper           | 否    | Number  | 值域上限     |
| upper_inclusive | 否    | Boolean | 是否包含值域上限 |
   
#### 响应参数
无
#### 请求示例
创建一个CPI任务
```
POST https://{endpoint}/v1/{project_id}/task/cpi
{
  "header" : "T1030 BibA, 273 residues",
  "fasta" : "DQELGKQSRRSQDIIKSLGFLSSDQKDILVKSISSSKDSQLILKFVTQATQLNNAESTKAKQMAQNDVALIKNISPEVLEEYKEKIQRASTKSQVDEFVAEAKKVVNSNKET",
  "smiles_list" : [ "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**
CPI成功提交响应，返回CPI任务ID
```
"87ba6b54-2288-4a5d-90a2-3db01c22a9d2"
```
#### 状态码
| 状态码 | 描述                  |
|:---|:---|
| 201 | CPI成功提交响应，返回CPI任务ID |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-eihealth/ErrorCode.html)。