使用API调用科学计算大模型

预置模型或训练后的模型部署成功后，可以使用API调用科学计算大模型。

获取调用路径

登录ModelArts Studio大模型开发平台，在“我的空间”模块，单击进入所需空间。
图1 我的空间
获取调用路径。
在左侧导航栏中选择“模型开发 > 模型部署”。
- 获取已部署模型的调用路径。在“我的服务”页签，单击状态为“运行中”的模型名称，在“详情”页签，可获取模型调用路径，如图2。
  图2 获取已部署模型的调用路径
- 获取预置服务的调用路径。在“预置服务”页签中，选择所需调用的科学计算大模型，单击“调用路径”，在“调用路径”弹窗可获取模型调用路径，如图3。
  图3 获取预置服务的调用路径

使用Postman调用API

在Postman中新建POST请求，并填入模型调用路径，详见获取调用路径。

调用API有两种认证方式，包括Token认证和API Key认证。其中，API Key认证的使用场景为当用户部署的API服务期望开放给其他用户调用时，原有Token认证无法支持，可通过API Key认证调用请求。

参考表1填写请求Header参数。

表1 请求Header参数填写说明
认证方式	参数名	参数值
Token认证	Content-Type	application/json
Token认证	X-Auth-Token	Token值，参考《API参考》文档“如何调用REST API > 认证鉴权 > Token认证”章节获取Token。
API Key认证	Content-Type	application/json
API Key认证	X-Apig-AppCode	API Key值，获取API Key步骤如下：登录ModelArts Studio平台，进入所需空间。在左侧导航栏中选择“系统管理与统计 > 应用接入”，单击界面右上角“创建应用接入”。在“应用配置”中，选择已部署好的大模型，单击“确定”。在“应用接入”列表的“API Key”操作列中可获取API Key值。

如图4，为Token认证方式的请求Header参数填写示例。

图4 配置请求参数

在Postman中选择“Body > raw”选项，参考以下代码填写请求Body。API参数说明详见《API参考》文档。

{
    "data_dirs": {
        "global-weather": "obs://path/to/data/"
    },
    "output_dir": "obs://path/to/data/",
    "start_times": ["2024010100", "2024010112","2024010118"],
    "forecast_lead_time": "7d",
    "draw_figures": true
}

单击Postman界面“Send”，发送请求。科学计算大模型API调用成功后，会返回任务id参数task_id，可获取任务ID参数值。
在Postman中新建一个GET请求，填入域名（将获取调用路径中获取的URL去除末尾的“/tasks”即为该域名），设置请求Header参数和任务ID参数。单击Postman界面的“Send”发送请求，以获取科学计算大模型的调用结果。
```
查询科学计算大模型调用详情API
GET /tasks/{task_id}
```