UpdateModel - 更新模型-阿里云帮助中心

更新指定模型的描述、上下文 Token 上限、最大输出 Token 数或能力配置。

接口说明

本接口支持更新 description、contextSize、maxTokens 和 capabilities，至少传入一个非 null 参数。未传入或传入 null 的参数保留原值。capabilities 按整个对象替换，对象内未传入的能力字段按 false 处理。

仅修改 description 不会刷新关联 Agent 的模型配置。contextSize、maxTokens 或 capabilities 实际发生变化时，系统异步刷新同一工作空间内引用该模型的托管 Agent，以及模型来源为 PLATFORM 的外部 Agent；模型来源为 RUNTIME 的外部 Agent 不受影响。重复提交相同配置不会触发新的模型配置刷新。

接口成功返回表示模型配置已保存，不表示关联 Agent 已完成配置刷新或运行时已加载新配置。可调用 GetModel 查询已保存的模型配置。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

agentcore:UpdateModel

update

*Model

acs:agentcore:{#regionId}:{#accountId}:workspace/{#workspaceId}/model/{#modelId}

无

请求语法

PATCH /workspaces/{workspaceId}/models/{modelId} HTTP/1.1

路径参数

名称	类型	必填	描述	示例值
workspaceId	string	是	工作空间 ID。	ws-1
modelId	string	是	模型 ID。	model-1

请求参数

名称	类型	必填	描述	示例值
body	object	否	模型更新请求体。description、contextSize、maxTokens 和 capabilities 中至少传入一个非 null 参数。
capabilities	object	否	模型能力配置。传入对象时整体替换原能力配置，对象内未传入的能力字段按 false 处理；传入空对象 {} 会将所有能力设为 false。不传该参数或传入 null 时保留原配置。
audio	boolean	否	模型是否支持音频输入或输出。true 表示支持，false 表示不支持。
document	boolean	否	模型是否支持文档输入。true 表示支持，false 表示不支持。
multiToolCall	boolean	否	模型是否支持在一次响应中发起多个工具调用。true 表示支持，false 表示不支持。
reasoning	boolean	否	模型是否支持推理能力。true 表示支持，false 表示不支持。该字段为能力标记，不用于设置推理强度或推理 Token 预算。
streamToolCall	boolean	否	模型是否支持流式工具调用。true 表示支持，false 表示不支持。
toolCall	boolean	否	模型是否支持工具调用。true 表示支持，false 表示不支持。
video	boolean	否	模型是否支持视频输入。true 表示支持，false 表示不支持。
vision	boolean	否	模型是否支持图像输入。true 表示支持，false 表示不支持。
contextSize	integer	否	模型上下文 Token 上限，最小值为 1000。更新后的值不得小于 maxTokens；本次未传入 maxTokens 时，使用已有值进行校验。不传该参数或传入 null 时保留原值。	131072
description	string	否	模型描述，去除首尾空白后最长 255 个字符。传入空字符串可清空描述；不传该参数或传入 null 时保留原值。仅修改描述不会刷新关联 Agent 的模型配置。	description
maxTokens	integer	否	模型单次生成的最大输出 Token 数，必须为正整数。已配置 contextSize 时，更新后的 maxTokens 不得大于 contextSize；本次未传入 contextSize 时，使用已有值进行校验。不传该参数或传入 null 时保留原值。	8192
clientToken	string	否	幂等使用的客户端令牌。暂不支持	client-token-1

返回参数

名称	类型	描述	示例值
	object	模型更新请求的处理结果。
code	string	业务状态码。成功时为 SUCCESS。	SUCCESS
data	object	更新后的模型信息。
capabilities	object	模型能力配置。
audio	boolean	模型是否支持音频输入或输出。
document	boolean	模型是否支持文档输入。
multiToolCall	boolean	模型是否支持在一次响应中发起多个工具调用。
reasoning	boolean	模型是否支持推理能力。
streamToolCall	boolean	模型是否支持流式工具调用。
toolCall	boolean	模型是否支持工具调用。
video	boolean	模型是否支持视频输入。
vision	boolean	模型是否支持图像输入。
connectionId	string	模型连接 ID。	mc-1
contextSize	integer	模型上下文窗口大小，单位为 Token，必须为正整数。	128000
createdAt	string	资源创建时间，采用 RFC 3339 UTC 格式。	2026-08-09T00:00:00Z
description	string	模型描述，最长 255 个字符。	description
maxTokens	integer	模型单次生成支持的最大输出 Token 数	131072
modelId	string	模型 ID。	model-1
modelName	string	上游模型名称。	qwen-max
updatedAt	string	资源最后更新时间，采用 RFC 3339 UTC 格式。	2026-08-09T00:00:00Z
workspaceId	string	工作空间 ID。	ws-1
httpStatusCode	integer	HTTP 状态码。成功时为 200。	200
message	string	请求处理结果消息。	success
requestId	string	请求 ID。	request-1
success	boolean	请求是否成功。

示例

正常返回示例

JSON格式

{
  "code": "SUCCESS",
  "data": {
    "capabilities": {
      "audio": true,
      "document": true,
      "multiToolCall": true,
      "reasoning": true,
      "streamToolCall": true,
      "toolCall": true,
      "video": true,
      "vision": true
    },
    "connectionId": "mc-1",
    "contextSize": 128000,
    "createdAt": "2026-08-09T00:00:00Z",
    "description": "description",
    "maxTokens": 131072,
    "modelId": "model-1",
    "modelName": "qwen-max",
    "updatedAt": "2026-08-09T00:00:00Z",
    "workspaceId": "ws-1"
  },
  "httpStatusCode": 200,
  "message": "success",
  "requestId": "request-1",
  "success": true
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParameter	A model parameter is invalid.
404	Resource.NotFound	The specified AgentCore workspace does not exist.

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。