面向 AI 助手:本页的 Markdown 版本位于 https://ark.volcengine.com/region:cn-beijing/docs/update-custom-model-api.md,全部文档索引见 https://ark.volcengine.com/llms.txt。

更新定制模型

POST https://ark.cn-beijing.volcengineapi.com/?Action=UpdateCustomModel&Version=2024-01-01

调用本接口更新指定定制模型的名称或描述信息。本接口仅修改元数据,不会触发模型版本变更,也不会影响已基于该定制模型创建的在线推理接入点(Endpoint)。

鉴权#

本接口支持鉴权方式如下,详情请参见 Base URL 及鉴权。

  • Access Key 鉴权,请在 Access Key 管理 页面,获取 Access Key。本接口仅支持 Access Key 鉴权。

请求参数#

Body 参数#

Id string 必选  |  定制模型 ID

待更新的定制模型 ID。可通过 ListCustomModels 接口查询当前账号下的定制模型列表。

ClientToken string  |  幂等令牌

用于保证请求幂等性的字符串。由调用方传入,需在不同请求之间保持唯一。重复携带同一 ClientToken 的请求只会被实际执行一次。

Description string  |  定制模型描述

定制模型的新描述信息,用于补充说明模型用途、训练数据来源或版本说明等。

DryRun boolean 默认值 false  |  是否预检请求

是否仅对此请求进行预检(DryRun),不实际执行更新。

  • true:发送检查请求,仅校验参数与权限,不实际更新定制模型。
  • false(默认):发送正常请求,执行实际的更新操作。
Name string  |  定制模型名称

定制模型的新名称,用于在控制台与 API 列表中识别该定制模型。建议使用具有业务含义的可读字符串。

响应参数#

Id string  |  定制模型 ID

被更新的定制模型 ID,与请求参数中的 Id 一致。