文档中心

ArkClaw 企业版

请输入

ClawInstance

UpdateClawInstanceModel - 更新ArkClaw实例模型

更新ArkClaw实例使用的模型，仅支持更新状态为“运行中”的实例。

请求参数

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

Action string 必选示例值：UpdateClawInstanceModel

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

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

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

ModelAccessPointId string 可选示例值：csmap-yekybup88wb1t61t****

模型池ID。可在ArkClaw控制台“空间概览”页面，进入“模型配置”编辑详情，在“自定义模型配置”页签中获取。

说明

当ModelSource为Custom时必填。

InstanceId string 必选示例值：ci-yenklf05q8a9xf1s****

ArkClaw实例ID。查询实例ID的方式请参见ListClawInstances。

ModelApiKey string 可选示例值：0fe06ac8-****-94c249f78fdc

模型APIKey。

空间选择“自定义模型配置”且选择APIKey为“员工自行配置”时需要填写。

不填默认为空间模型配置时生成的APIKey。

ModelName string 必选示例值：doubao-seed-2.0-pro

模型的名称。

ModelSource string 必选示例值：CodingPlan

模型的来源。取值：

CodingPlan：来源于CodingPlan。

ModelSquare：来源于模型广场。

Custom：来源于用户自定义。

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

POST /?Action=UpdateClawInstanceModel&Version=2026-05-01 HTTP/1.1​
Host: https://arkclaw.cn-beijing.volcengineapi.com​
Content-Type: application/json; charset=UTF-8​
X-Date: 20260605T120225Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260605/cn-beijing/arkclaw/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
  "InstanceId": "ci-yenklf05q8a9xf1s****",​
  "ModelName": "doubao-seed-2.0-pro",​
  "ModelSource": "CodingPlan"​
}​

返回示例

{​
  "ResponseMetadata": {​
    "RequestId": "2026060516182719319****",​
    "Action": "UpdateClawInstanceModel",​
    "Version": "2026-05-01",​
    "Service": "arkclaw",​
    "Region": "cn-beijing"​
  },​
  "Result": {}​
}​

错误码

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

状态码	错误码	错误信息	说明
400	MissingParameter.InstanceId	The required parameter InstanceId is not supplied.	参数InstanceId不能为空。
400	MissingParameter.ModelName	The required parameter ModelName is not supplied.	参数ModelName不能为空。
400	MissingParameter.ModelSource	The required parameter ModelSource is not supplied.	参数ModelSource不能为空。
400	MissingParameter.ModelApiKey	The required parameter ModelApiKey is not supplied.	参数ModelApiKey不能为空。
400	InvalidModelSource.Malformed	The specified ModelSource is malformed.	指定的模型来源无效。
400	InvalidModelName.Malformed	The specified ModelName is malformed.	指定的模型名称不在支持的模型列表中。
404	InvalidInstance.NotFound	The specified Instance does not exist.	指定ArkClaw实例不存在。
412	OperationDenied.ResourceLocked	The specified operation is denied as your resource is locked for another operation.	指定的操作被拒绝，因为您的资源已被其他操作锁定。
412	OperationDenied.InstanceNotRunning	The operation is denied because the instance is not in running status.	指定的操作被拒绝，因为实例未处于运行中状态。
429	FlowLimitExceeded	The request was rejected due to flow control.	请求触发限流。
500	InternalError	An internal error has occurred.	内部错误，请重试。如果多次尝试失败，请提交工单。

最近更新时间：2026.07.01 15:28:02

这个页面对您有帮助吗？

有用

无用