更新时间:2025-07-29 GMT+08:00
分享

创建推理作业

功能介绍

支持调用科学计算大模型创建气象/降水模型的推理作业。

URI

POST /v1/{project_id}/alg-infer-job/ai4s/service/{deployment_id}/tasks

获取URI方式请参见请求URI

表1 推理接口路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID,获取方法请参见获取项目ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

deployment_id

String

参数解释:

模型的部署ID,获取方法请参见获取模型部署ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

请求参数

使用Token认证方式的请求Header参数见表2

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

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

Content-Type

String

参数解释:

发送的实体的MIME类型。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

application/json

使用API Key认证方式的请求Header参数见表3

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

参数

是否必选

参数类型

描述

X-Apig-AppCode

String

参数解释:

API Key值。

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

Content-Type

String

参数解释:

发送的实体的MIME类型。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

application/json

表4 请求Body参数

参数

是否必选

参数类型

描述

name

String

参数解释:

推理作业的名称。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

input

TaskInputDto object

参数解释:

输入数据的信息。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

output

TaskOutputDto object

参数解释:

输出数据的信息。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

config

TaskConfigDto object

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表5 TaskInputDto

参数

是否必选

参数类型

描述

type

String

参数解释:

存储类型,取值为obs。

约束限制:

不涉及

取值范围:

obs

默认取值:

obs

data

Array of ObsStorageDto objects

参数解释:

输入数据的OBS信息。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表6 ObsStorageDto

参数

是否必选

参数类型

描述

bucket

String

参数解释:

输入数据的OBS桶名称。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

path

String

参数解释:

初始场数据的存放路径。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表7 TaskOutputDto

参数

是否必选

参数类型

描述

obs

ObsStorageDto object

参数解释:

输出数据的OBS信息。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表8 TaskConfigDto

参数

是否必选

参数类型

描述

data_dirs

String

参数解释:

根据不同模型指定输入数据的OBS路径。由json体转换的字符串,格式如下{"model_tag": "obs://path/to/data/"},model_tag与模型的对应关系请见表9 模型资产与model tag对应关系

约束限制:

数据路径需要为json字符串。

取值范围:

不涉及

默认取值:

不涉及

start_time_begin

String

参数解释:

起报时间区间起点。

约束限制:

YYYYMMDDHH时间戳

取值范围:

不涉及

默认取值:

不涉及

start_time_end

String

参数解释:

起报时间区间终点。

约束限制:

YYYYMMDDHH时间戳

取值范围:

不涉及

默认取值:

不涉及

start_time_interval_hours

Long

参数解释:

起报时间间隔小时数。

约束限制:

不涉及

取值范围:

[1, 24]

默认取值:

6

forecast_lead_hours

Long

参数解释:

预报未来小时数。

约束限制:

不涉及

取值范围:

[1, 720]

默认取值:

168

draw_figures

String

参数解释:

是否输出结果图片。

约束限制:

不涉及

取值范围:

true/false

默认取值:

true

num_ensembles

Long

参数解释:

集合数量。在气象预报中,集合预报是指对初始场加入一定程序的扰动,使其生成一组由不同初始场预报的天气预报结果,从而提供对未来天气状态的概率信息。这种方法可以更好地表达预报的不确定性,从而提高预报的准确性和可靠性。

约束限制:

不涉及

取值范围:

[2, 10]。

默认取值:

不涉及

ensemble_noise_method

String

参数解释:

集合预报的加噪方式。可选:{"perlin"}。

  • perlin噪音通过对输入数据(比如空间坐标)进行随机扰动,让模拟出的天气接近真实世界中的变化。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

ensemble_noise_perlin_scale

Double

参数解释:

集合预报的Perlin加噪scale。

约束限制:

不涉及

取值范围:

(0, 0.5)

默认取值:

不涉及

ensemble_noise_perlin_octave

Long

参数解释:

用于选择集合预报的Perlin加噪octave。Perlin噪音的octave指的是噪音的频率,在生成Perlin噪音时,可以将多个不同频率的噪音叠加在一起,以增加噪音的复杂度和细节。每个频率的噪音称为一个octave,而叠加的octave数越多,噪音的复杂度也就越高。

约束限制:

不涉及

取值范围:

[1, 10)

默认取值:

不涉及

ensemble_noise_perlin_x

Double

参数解释:

用于选择集合预报的Perlin加噪x经度方向的尺度。

约束限制:

不涉及

取值范围:

[0, 1)

默认取值:

不涉及

ensemble_noise_perlin_y

Double

参数解释:

用于选择集合预报的Perlin加噪y纬度方向的尺度。

约束限制:

不涉及

取值范围:

[0, 1)

默认取值:

不涉及

表9 模型资产与model tag对应关系

模型资产名称

model tag

Pangu-AI4S-Global-Weather

global-weather

Pangu-AI4S-Global-Precip

global-precip

Pangu-AI4S-Global-Ocean

global-ocean

Pangu-AI4S-Regional-Ocean

regional-ocean

Pangu-AI4S-Global-Ecology

global-ecology

Pangu-AI4S-Global-Swell

global-swell

Pangu-AI4S-Regional-Pollution

regional-pollution

Pangu-AI4S-Regional-Pollution-Tianrong

regional-pollution

表10 全球中期天气要素预测模型、降水模型信息表

模型

预报层次

预报高空变量

预报表面变量

降水

时间分辨率

水平分辨率

区域范围

全球中期天气要素预测模型

13层(1000hpa,925hpa,850hpa,700hpa,600hpa,500hpa,400hpa,300hpa,250hpa,200hpa,150hpa,100hpa,50hpa)

T:温度

Q:比湿

Z:重力位势

U:U风

V:V风

MLSP:海平面气压。

U10:10米U风,经度方向。

V10:10米V风,纬度方向。

T2M:2米温度。

-

1、3、6、24小时。

0.25°*0.25°

全球

降水基模型

13层(1000hpa,925hpa,850hpa,700hpa,600hpa,500hpa,400hpa,300hpa,250hpa,200hpa,150hpa,100hpa,50hpa)

T:温度

Q:比湿

Z:重力位势

U:U风

V:V风

MLSP:海平面气压。

U10:10米U风,经度方向。

V10:10米V风,纬度方向。

T2M:2米温度。

PRECIP6:过去6h累计降水。

PRECIP24:过去24h累计降水。

1、3、6、24小时。

0.25°*0.25°

全球

响应参数

状态码: 201

表11 响应Body参数

参数

参数类型

描述

tasks

Array of tasks objects

参数解释:

创建的作业列表。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表12 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" : {
    "data_dirs": "{\"global-weather\":\"obs://path/to/directory/\"}",
    "start_time_begin" : "2017010100",
    "start_time_end" : "2017010200",
    "start_time_interval_hours" : 1,
    "forecast_lead_hours" : 1,
    "num_ensembles" : 2,
    "ensemble_noise_method" : "perlin",
    "ensemble_noise_perlin_scale" : 0.1,
    "ensemble_noise_perlin_octave" : 1,
    "ensemble_noise_perlin_x" : 0.2,
    "ensemble_noise_perlin_y" : 0.2,
    "draw_figures" : "false"
  }
}

响应示例

状态码: 200

创建作业成功

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

状态码

请参见状态码

错误码

请参见错误码

相关文档