文档首页/ 智能体开发平台 AgentArts/ API参考/ API/ 评估/ 模型管理/ 获取单个模型信息 - ShowOpsEvaluationModel
更新时间:2026-04-15 GMT+08:00
分享

获取单个模型信息 - ShowOpsEvaluationModel

功能介绍

该接口用于通过模型ID获取特定大模型的详细元数据,包含其技术规格、版本信息、支持的协议能力及服务终点。

URI

GET /v1/ops/evaluation-models/{model_id}

表1 路径参数

参数

是否必选

参数类型

描述

model_id

String

参数解释:

大模型的唯一标识符(ID)。该参数用于在路径中指定当前操作所针对的具体模型资源。获取方法请参考9.1-获取模型信息 - ListOpsEvaluationModels。

约束限制:

长度为 1到100个字符。

取值范围:

存在的模型ID。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

参数解释:

消息体编码格式。用于告知服务端请求体(Body)所采用的主体数据类型,以便服务端正确解析。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

application/json

Authorization

String

参数解释:

签名认证信息,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

X-Sdk-Date

String

参数解释:

请求发送的时间,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

model

Model object

参数解释:

单个模型的详细信息对象。

取值范围:

参考Model定义。

表4 Model

参数

参数类型

描述

max_tokens_top

Integer

参数解释:

模型生成文本的最大长度上限。

取值范围:

0 - 10000。

max_tokens_bottom

Integer

参数解释:

模型生成文本的最小长度下限。

取值范围:

0 - 10000。

model_id

String

参数解释:

模型的唯一标识符。

取值范围:

不涉及。

model_name

String

参数解释:

模型的显示名称。

取值范围:

不涉及。

temperature_top

String

参数解释:

模型生成随机性(Temperature)的上限值。

取值范围:

不涉及。

temperature_bottom

String

参数解释:

模型生成随机性的下限值。

约束限制:

0到10000字符。

取值范围:

不涉及。

默认取值:

不涉及。

top_p_top

String

参数解释:

TopP采样策略的上限值。

取值范围:

不涉及。

top_p_bottom

String

参数解释:

TopP采样策略的下限值。

取值范围:

不涉及。

supported_scenes

Array of strings

参数解释:

模型支持的应用场景列表。

取值范围:

数组长度为0到100。可选枚举值包括:

  • evaluators:评估器场景,用于质量评估。

  • datasets-synthesis:数据合成场景,用于生成评测集。

状态码:400

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

系统定义的标准化错误代码。

取值范围:

业务异常编码字符串。

error_msg

String

参数解释:

对错误的详细描述,包含异常原因或解决建议。

取值范围:

任意文本内容。

请求示例

通过模型ID"mod_gpt4_v1" 获取该模型的详细元数据。

GET https://*.com/agentarts/v1/ops/evaluation-models/mod_gpt4_v1

响应示例

状态码:200

获取模型信息成功

{
  "model" : {
    "model_id" : "mod_gpt4_v1",
    "model_name" : "GPT-4-Turbo",
    "max_tokens_top" : 90,
    "max_tokens_bottom" : 45,
    "temperature_top" : "15",
    "temperature_bottom" : "3",
    "top_p_top" : "55",
    "top_p_bottom" : "20",
    "supported_scenes" : [ "a", "b" ]
  }
}

状态码:400

错误吗

{
  "error_code" : "AgentArts.03400001",
  "error_msg" : "请求错误"
}

状态码

状态码

描述

200

获取模型信息成功

400

错误吗

错误码

请参见错误码

相关文档