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

创建推理作业

功能介绍

创建科学计算大模型中海洋类模型的推理作业。

URI

POST /tasks

科学计算大模型的API请求地址可以直接在ModelArts Studio大模型开发平台获取:

  1. 登录ModelArts Studio大模型开发平台,进入所需空间。
  2. 获取调用路径及部署ID。单击左侧“模型开发 > 模型部署”,选择所需调用的大模型,单击“调用路径”,在“调用路径”弹窗获取调用路径及部署ID。

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

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

Content-Type

String

发送的实体的MIME类型,参数值为“application/json”。

表2 请求Body参数

参数

是否必选

参数类型

描述

name

String

推理作业的名称。

input

TaskInputDto object

输入数据的信息。

output

TaskOutputDto object

输出数据的信息。

config

TaskConfigDto object

科学计算大模型配置信息。

表3 TaskInputDto

参数

是否必选

参数类型

描述

type

String

存储类型,取值为obs。

data

Array of ObsStorageDto objects

输入数据的OBS信息。

表4 ObsStorageDto

参数

是否必选

参数类型

描述

bucket

String

输入数据的OBS桶名称。

path

String

初始场数据的存放路径。

表5 TaskOutputDto

参数

是否必选

参数类型

描述

obs

ObsStorageDto object

输出数据的OBS信息。

表6 TaskConfigDto

参数

是否必选

参数类型

描述

start_time_begin

String

起报时间区间起点(YYYYMMDDHH时间戳)。

start_time_end

String

起报时间区间终点(YYYYMMDDHH时间戳)。

start_time_interval_hours

Long

起报时间间隔小时数,默认6。取值范围:[1, 24]。

forecast_lead_hours

Long

预报未来小时数,默认168。如需预报未来30天,可将此参数设置成720。

draw_figures

String

是否输出结果图片,取值true/false,默认true。

forecast_features

String

确定性预报的输出要素,例如“Surface:U;1000:T;800:?abc”。

响应参数

状态码: 201

表7 响应Body参数

参数

参数类型

描述

tasks

Array of tasks objects

创建的作业列表。

表8 tasks

参数

参数类型

描述

id

String

创建的作业ID。

请求示例

{ 
  "name" : "demo-task", 
  "input" : { 
    "type" : "obs", 
    "data" : [ { 
      "bucket" : "bucket", 
      "path" : "path/to/directory/" 
    } ] 
  }, 
  "output" : { 
    "obs" : { 
      "bucket" : "bucket", 
      "path" : "path/to/directory/" 
    } 
  }, 
  "config" : { 
    "start_time_begin" : 2017010100, 
    "start_time_end" : 2017010200, 
    "start_time_interval_hours" : 1, 
    "forecast_lead_hours" : 1, 
    "forecast_features" : "Surface:P;Surface:T;Surface:U;Surface:V;1000:T;800:T;1000:Z;800:Z", 
    "draw_figures" : "true" 
  } 
}

响应示例

状态码: 200

创建作业成功

{
  "tasks" : [ {
    "id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1"
  } ]
}

状态码

请参见状态码

错误码

请参见错误码

相关文档