更新时间:2026-09-15 GMT+08:00
分享

推理任务提交

功能介绍

提交新的异步推理任务,从 OBS 下载数据并执行推理。

URI

POST /v1/inference

获取URI方式请参见请求URI

请求参数

表1 请求Header参数(Token认证)

参数

是否必选

参数类型

描述

X-Auth-Token

是(云上部署模型填写)

String

参数解释:

用户Token。

用于获取操作API的权限。图4响应消息头中X-Subject-Token的值即为Token。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

Content-Type

String

参数解释:

发送的实体的MIME类型。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

application/json。

表2 请求Header参数(API Key认证)

参数

是否必选

参数类型

描述

X-Apig-AppCode

是(云上部署模型填写、边缘部署模型仅在监控网关访问模式下填写)

String

参数解释:

API Key值。

用于获取操作API的权限。API Key认证响应消息头中X-Apig-AppCode的值即为API Key。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

Content-Type

String

参数解释:

发送的实体的MIME类型。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

application/json。

表3 请求Body参数

参数

参数类型

描述

obs_path

String

参数解释:

推理数据的OBS路径。

约束限制:

用户需要为对应的OBS桶添加桶策略,使得推理服务可以访问OBS路径。

添加方式参考桶策略添加方式

取值范围:

有效的OBS路径,路径下的文件格式要求和训练数据一致。

默认取值:

不涉及

桶策略添加方式:

  1. 进入“对象存储服务 OBS”服务,在左侧导航栏选择“桶列表”。
  2. 在桶列表中,选择存放数据的桶,单击待操作的桶,进入“对象”页面。
  3. 在左侧导航栏,单击“权限控制 > 桶策略”,单击“创建”,在编辑桶策略页面,配置Get*、ListBucket两项授权。
    注:承载租户账号ID可联系运维人员获取。
    图1 OBS桶策略配置

响应参数

状态码: 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"
}

状态码

请参见状态码

错误码

请参见错误码

相关文档