本文导读

展开导读

文档首页/ 盘古大模型 PanguLargeModels/ API参考/ API/ 模型推理接口/ 科学计算大模型/ 气象类模型/ 查询推理作业详情

查询推理作业详情

更新时间：2025-06-20 GMT+08:00

查看PDF

功能介绍

根据创建推理作业的作业ID获取科学计算大模型的结果数据。

URI

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

获取URI方式请参见请求URI。

表1 接口路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID，获取方法请参见获取项目ID。
deployment_id	是	String	模型的部署ID，获取方法请参见获取模型部署ID。
task_id	是	String	推理作业的ID。

请求参数

无

响应参数

状态码： 200

表2 响应Body参数
参数	参数类型	描述
id	String	推理作业ID。
name	String	创建作业时设置的作业名称。
created_at	String	作业创建时间，ISO 8601格式。
updated_at	String	更新时间，ISO 8601格式。
state	String	模型推理任务状态。 RUNNING：表示任务运行中。 PENDING：表示任务等待中。 SUCCEEDED：表示任务运行成功。 FAILED：表示任务运行失败。
input	TaskInputDto object	输入数据的信息。
output	TaskOutputDto object	输出数据的信息。
config	TaskConfigDto object	科学计算大模型配置信息。

表3 TaskInputDto
参数	是否必选	参数类型	描述
type	是	String	存储类型，取值为obs。
data	是	Array of ObsStorageDto objects	输入数据的OBS信息。

表4 TaskOutputDto
参数	是否必选	参数类型	描述
obs	是	ObsStorageDtoobject	输出数据的OBS信息。

表5 ObsStorageDto
参数	是否必选	参数类型	描述
bucket	是	String	输入数据的OBS桶名称。
path	是	String	初始场数据的存放路径。

表6 TaskConfigDto
参数	是否必选	参数类型	描述
data_dirs	是	String	根据不同模型指定输入数据的OBS路径。由json体转换的字符串，格式如下{"model_tag": "obs://path/to/data/"}，model_tag与模型的对应关系请见表7。
start_time_begin	是	String	起报时间区间起点（YYYYMMDDHH时间戳）。
start_time_end	是	String	起报时间区间终点（YYYYMMDDHH时间戳）。
start_time_interval_hours	否	Long	起报时间间隔小时数，默认6。取值范围：[1, 24]。
forecast_lead_hours	否	Long	预报未来小时数，默认168，取值范围：[1, 720]。
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)。

表7 模型资产与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

请求示例

无

响应示例

{
  "id": "baabcb565bb611eb8a0dfa163e3ddba1",
  "name": "demo-task",
  "created_at": "2024-07-31T10:30:49Z",
  "updated_at": "2024-07-31T10:30:49Z",
  "state": "PENDING",
  "input": {
    "type": "obs",
    "data": [
      {
        "bucket": "bucket-name",
        "path": "path/to/data/"
      }
    ]
  },
  "output": {
    "obs": {
      "bucket": "bucket-name",
      "path": "path/to/data/"
    }
  },
  "config": {
    "start_time_begin": "2017010100",
    "start_time_end": "2017010200",
    "start_time_interval_hours": 6,
    "forecast_lead_hours": 168,
    "draw_figures": "true",
    "num_ensembles": 0,
    "ensemble_noise_method": "perlin",
    "ensemble_noise_perlin_scale": 0.1,
    "ensemble_noise_perlin_octave": 3,
    "ensemble_noise_perlin_x": 0.5,
    "ensemble_noise_perlin_y": 0.5
  }
}

状态码

请参见状态码。

错误码

请参见错误码。

父主题： 气象类模型

上一篇：创建推理作业

下一篇：搜索规划模型

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问