创建推理作业

project_id

是

String

参数解释：

项目ID，获取方法请参见获取项目ID。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

deployment_id

是

String

参数解释：

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

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

X-Auth-Token

是

String

参数解释：

用户Token。

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

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

Content-Type

是

String

参数解释：

发送的实体的MIME类型。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

application/json

X-Apig-AppCode

是

String

参数解释：

API Key值。

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

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

Content-Type

是

String

参数解释：

发送的实体的MIME类型。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

application/json

models

否

Array

参数解释：

选择用来推理的模型子集列表。可通过配置model_tag的方式，指定参与推理的模型子集。例如：["global-weather"], 如不传则默认使用全部模型进行推理。model_tag与模型的对应关系请见表9 模型资产与model tag对应关系。

约束限制：

字符串列表，指定的model tag需要在已部署的模型范围内。

取值范围：

不涉及

默认取值：

不涉及

data_dirs

是

Map<string, string>

参数解释：

根据不同模型指定输入数据的路径。格式为{model_tag: schema://dataset_path}，例如{"global-weather": "obs://path/to/data/"}，model_tag与模型的对应关系请见表9 模型资产与model tag对应关系。

约束限制：

schema参数在线服务仅支持obs，边缘服务支持file（本地路径）。

取值范围：

不涉及

默认取值：

不涉及

output_dir

是

String

参数解释：

推理结果输出路径。格式为schema://dataset_path，例如file:///path/to/data/。

约束限制：

schema参数在线服务仅支持obs，边缘服务支持file（本地路径）。

取值范围：

不涉及

默认取值：

不涉及

start_times

是

Array

参数解释：

起报时间点列表，若不传入start_time_interval，则列表中的每个时间均作为起报时，若传入start_time_interval，则start_times必须只包含两个时间，分别作为起报时间的起点和终点，根据start_time_interval最终插值出所有起报时间点（总起报时间点数量不能超过列表长度上限）。

约束限制：

起报时间点字符串格式为YYYYMMDDHH时间戳。

取值范围：

不涉及

默认取值：

不涉及

start_time_interval

否

String

参数解释：

起报时间间隔时长。仅数字代表小时数，支持数字+单位表示，例如1d，3h。

约束限制：

不涉及

取值范围：

(0h, 24h]

默认取值：

6h

forecast_lead_time

否

String

参数解释：

预报时效。仅数字代表小时数，支持数字+单位表示，例如6d

约束限制：

不涉及

取值范围：

[1h, 720h]

默认取值：

168h

draw_figures

否

Bool

参数解释：

是否输出结果图片。

约束限制：

不涉及

取值范围：

true/false

默认取值：

true

clipping_geo_ranges

否

ClippingGeoRanges object

参数解释：

指定对结果文件剪裁的地理范围，在结果文件中仅会输出指定范围内的区域。如不指定，则默认输出原结果范围。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

ensemble

否

EnsembleDto object

参数解释：

集合预报配置。传入时启用集合预报。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

latitude

否

Array

参数解释：

指定对结果文件进行剪裁的纬度范围，长度为2的定长数组，左端小于右端，例如：[45, 70]。如指定longitude，不指定latitude，默认补全为全球范围[-90, 90]。

约束限制：

长度为2的定长小数数组，左端小于右端。

取值范围：

[-90, 90]

默认取值：

[-90, 90]

longitude

否

Array

参数解释：

指定对结果文件进行剪裁的经度范围，例如：[110, 130]。如指定latitude，不指定longitude，默认补全为全球范围[0, 360]。

约束限制：

长度为2的定长小数数组，左端小于右端。

取值范围：

[0, 360]

默认取值：

[0, 360]

num_ensembles

是

Long

参数解释：

集合成员数。集合预报通过注入随机噪声生成一组不同成员的天气预报，提供对未来天气状态的概率信息，表达预报不确定性。当值为1时配合noise_seed可执行固定种子的确定性单次预报，只有当值大于等于2时才会执行集合预报。

约束限制：

不涉及

取值范围：

[1, 100]

默认取值：

不涉及

noise_seed

否

Long

参数解释：

集合噪声随机种子，固定种子可保证集合结果可复现。

约束限制：

不涉及

取值范围：

[0, 4294967295]

默认取值：

不涉及

Pangu-AI4S-Global-Weather

global-weather

Pangu-AI4S-Global-Precip

global-precip

Pangu-AI4S-Global-Wind

global-wind

Pangu-AI4S-Regional-Photovoltaics

regional-photovoltaics

Pangu-AI4S-Regional-Wind

regional-wind

Pangu-AI4S-Regional-Weather

regional-weather

Pangu-AI4S-Regional-Precip

regional-precip

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

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°

全球

task_id

String

参数解释：

创建的作业ID。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及