批量更新用户模型配置，支持配置模型的每日/每分钟Token限流、绑定/解绑用户的CodingPlan的席位。

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：UpdateUsersModelConfig

要执行的操作，取值：UpdateUsersModelConfig。

Version string 必选示例值：2026-05-01

API的版本，取值：2026-05-01。

UserIds string[] 必选示例值：["93b84820****", "37e87775****"]

目标用户ID。不能为空，最大长度为100。

ModelConfig object 必选示例值：{ "CodingPlanSeatType": "Lite", "TokenRateLimitPerDay": 40000000, "TokenRateLimitPerMinute": 500000 }

需要修改的用户席位配置信息，包括用户的Token分钟级限额、Token天级限额、CodingPlan坐席类型。

TokenRateLimitPerMinute integer 可选示例值：500000

Token分钟级限额。

不填此参数，则不更新当前配置。

若填入此参数，则值必须大于等于零，小于等于2147483647（int32最大值，约21.4亿）。

若为零则表示分钟级不限流。

TokenRateLimitPerDay integer 可选示例值：40000000

Token天级限额。

不填此参数，则不更新当前配置。

若填入此参数，则值必须大于等于零，小于等于2147483647（int32最大值，约21.4亿）。

若为零则表示天级不限流。

CodingPlanSeatType string 可选示例值：Lite

CodingPlan坐席类型。

如果您不传入该参数，系统不会修改用户当前的CodingPlan配置。

可选值：

Lite：更新为Lite类型。

Pro：更新为Pro类型。

输入空字符串：更新为用户不得使用CodingPlan模型。

SpaceId string 必选示例值：csi-yei8347ta8xmf5qd****

ArkClaw实例所属空间ID。可以在ArkClaw控制台“空间概览”页面的“基本信息”获取。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

OperationDetails object[] 示例值：{"OperationDetails":[{"UserId":"user-xxx1"},{"UserId":"user-xxx2","Error":{"Code":"InvalidUser.NotFound","Message":"The specified User does not exist."}}]}

逐用户、逐席位类型席位更新处理结果。

Error object 示例值：--

单个用户结果项处理失败时返回的错误描述，主要用于展示和排查问题；成功时为空或不返回。

Code string 示例值：--

错误码。

Message string 示例值：--

错误信息。

UserId string 示例值：93b84820****

用户ID。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	MissingParameter.ModelConfig	The required parameter ModelConfig is not supplied.	参数ModelConfig不能为空。
400	MissingParameter.SpaceId	The required parameter SpaceId is not supplied.	参数SpaceId不能为空。
400	MissingParameter.UserIds	The required parameter UserIds is not supplied.	参数UserIds不能为空。
400	InvalidUserIds.Malformed	The specified parameter UserIds is invalid.	UserIds 必须是非空字符串数组，且不能包含空字符串。
400	LimitExceeded.MaximumUserIds	The number of UserIds exceeds the maximum allowed limit.	UserIds 的数量超过了允许的最大限制。
400	LimitExceed.TokenRateLimitPerDay	The specified TokenRateLimitPerDay is invalid: must be greater than or equal to zero and less than or equal to the maximum value of int32.	TokenRateLimitPerDay参数无效。
400	LimitExceed.TokenRateLimitPerMinute	The specified TokenRateLimitPerMinute is invalid: must be greater than or equal to zero and less than or equal to the maximum value of int32.	TokenRateLimitPerMinute参数无效。
400	InvalidCodingPlanSeatType.Malformed	The specified CodingPlanSeatType is invalid: must be Lite, Pro or Empty.	CodingPlanSeatType参数无效。
400	QuotaExceeded.CodingPlanProSeatQuota	The specified CodingPlanSeatType is invalid: Pro seats exceeded purchased limit.	CodingPlanSeatType指定的分配的Pro席位数量超过购买数量。
400	QuotaExceeded.CodingPlanLiteSeatQuota	The specified CodingPlanSeatType is invalid: Lite seats exceeded purchased limit.	CodingPlanSeatType指定的分配的Lite席位数量超过购买数量。
404	InvalidSpace.NotFound	The specified space does not exist.	指定的ClawSpace不存在。
404	InvalidUser.NotFound	The specified User does not exist.	指定的用户不存在。

ArkClaw 企业版