# 推理任务提交
#### 功能介绍
提交新的异步推理任务，从 OBS 下载数据并执行推理。
#### URI
POST /v1/inference
获取URI方式请参见[请求URI](https://support.huaweicloud.com/api-pangulm/pangulm_05_0004.html)。
#### 请求参数
表1请求Header参数（Token认证） 
| 参数           | 是否必选       | 参数类型  | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|:---|
| X-Auth-Token | 是（云上部署模型填写） | String | **参数解释：** 用户Token。 用于获取操作API的权限。[图4](https://support.huaweicloud.com/api-pangulm/pangulm_05_0009.html#pangulm_05_0009__fig10797003103)响应消息头中X-Subject-Token的值即为Token。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
| Content-Type   | 是            | String   | **参数解释：** 发送的实体的MIME类型。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** application/json。                                                                                                                                                                 |
   
表2请求Header参数（API Key认证） 
| 参数            | 是否必选                        | 参数类型     | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| X-Apig-AppCode | 是（云上部署模型填写、边缘部署模型仅在监控网关访问模式下填写） | String | **参数解释：** API Key值。 用于获取操作API的权限。[API Key认证](https://support.huaweicloud.com/api-pangulm/pangulm_05_0009.html#pangulm_05_0009__section148602501261)响应消息头中X-Apig-AppCode的值即为API Key。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
| Content-Type  | 是                             | String   | **参数解释：** 发送的实体的MIME类型。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** application/json。                                                                                                                                                                                   |
   
表3请求Body参数 
| 参数      | 参数类型  | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|
| obs_path | String | **参数解释：** 推理数据的OBS路径。 **约束限制：** 用户需要为对应的OBS桶添加桶策略，使得推理服务可以访问OBS路径。 添加方式参考[桶策略添加方式]。 **取值范围：** 有效的OBS路径，路径下的文件格式要求和训练数据一致。  **默认取值：** 不涉及 |
   
![](https://support.huaweicloud.com/api-pangulm/public_sys-resources/note_3.0-zh-cn.png)
桶策略添加方式：
1. 进入"对象存储服务 OBS"服务，在左侧导航栏选择"桶列表"。
2. 在桶列表中，选择存放数据的桶，单击待操作的桶，进入"对象"页面。
3. 在左侧导航栏，单击"权限控制 \> 桶策略"，单击"创建"，在编辑桶策略页面，配置Get\*、ListBucket两项授权。
   注：承载租户账号ID可联系运维人员获取。
   图1OBS桶策略配置   
   ![](https://support.huaweicloud.com/api-pangulm/zh-cn_image_0000002756971279.png) 
 
#### 响应参数
**状态码： 200**
表4响应Body参数 
| 参数           | 参数类型     | 描述                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|
| infer_task_id | String | **参数解释：** 推理任务ID。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
   
**状态码： 400**
表5响应Body参数 
| 参数          | 参数类型  | 描述                                                                                                                                                                                                                                                                                         |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
| error_msg    | String  | **参数解释：** 错误信息。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及  |
   
#### 请求示例
```
{"obs_path": "obs://bucket_name/path/to/data"}
```
#### 响应示例
```
{
    "infer_task_id": "infer_20260701_150000"
}
```
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-pangulm/pangulm_05_0019.html)。
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-pangulm/pangulm_05_0020.html)。