ArkClaw 企业版
ArkClaw 企业版
ArkClaw 企业版
文档指南
请输入
ArkClaw 企业版
产品动态
ArkClaw性能说明
员工使用ArkClaw
管理Agent
ArkClaw快捷功能
Hermes Agent
ArkClaw高级功能
管理 ArkClaw 实例
查看 ArkClaw 详情
管理 ArkClaw 插件与连接器
管理企业服务智能体
员工观测ArkClaw
管理员管理ArkClaw
Claw 实例
管理席位下的 Claw 实例
用户管理
网络管理
公网出口
私网出口
安全管理
管理员观测ArkClaw
管理员批量运维ArkClaw
最佳实践
开发者指南
API 参考
ClawSpace
Template
ClawInstance
Image
UserManagement
UserSeatQuota
PrivateEgressService
ArkClaw
产品动态
控制台操作指南
管理 Agent
使用技巧
快捷功能
Hermes Agent
管理 ArkClaw
观测 ArkClaw
常见问题
- 文档首页
ArkClaw 企业版ArkClaw 企业版开发者指南API 参考ClawInstanceUpdateClawInstanceModel - 更新ArkClaw实例模型
复制全文
下载 pdfUpdateClawInstanceModel - 更新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****
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
这个页面对您有帮助吗？
有用
有用
无用
无用