为指定推理接入点创建滚动升级任务，将流量逐步切换到目标基础模型版本。 ## 调试 [去调试](https://api.volcengine.com/api-explorer/?action=CreateEndpointRolling&groupName=%E7%AE%A1%E7%90%86%E6%8E%A8%E7%90%86%E6%8E%A5%E5%85%A5%E7%82%B9%EF%BC%88Endpoint%EF%BC%89&serviceCode=ark&version=2024-01-01) ## 请求参数下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见[公共参数](https://www.volcengine.com/docs/6369/67268)。 **Action** string 必选 `示例值：CreateEndpointRolling` 要执行的操作，取值：CreateEndpointRolling。 **Version** string 必选 `示例值：2024-01-01` API的版本，取值：2024\-01\-01。 **EndpointId** string 必选 `示例值：ep-20260709143000-abcde` 待滚动升级的推理接入点 ID。 **ModelReference** object 必选 `示例值：-` 目标模型引用。当前接口要求传入 `FoundationModel.Name` 和 `FoundationModel.ModelVersion`；目标模型版本不能与接入点当前模型版本相同。 **CustomModelId** string `可选` 定制模型的 ID **FoundationModel** object `可选` 基础模型 **Name** string 必选基础模型名称 **ModelVersion** string 必选基础模型版本 **Description** string `可选` `示例值：升级到新模型版本` 滚动升级任务描述，会记录到滚动升级详情中。 **DryRun** boolean `可选` `示例值：false` 是否只校验请求而不实际创建滚动升级任务。取值： * `true`：仅校验； * `false`（默认）：创建任务。 **TargetRouter** object `可选` `示例值：-` 智能路由接入点滚动升级后的目标路由配置。普通接入点无需传入；智能路由接入点必须传入。 **BaselineModel** object `可选` `示例值：-` 基准模型配置。 **CustomModelId** string `可选` 定制模型的 ID **FoundationModel** object `可选` 基础模型 **Name** string 必选基础模型名称 **ModelVersion** string 必选基础模型版本 **CandidateModels** object[] `可选` `示例值：-` 候选模型列表。Mode 为 `CandidateSet` 或 `Ordered` 时必填；Mode 为 `Automatic` 时可为空。 **CustomModelId** string `可选` 定制模型的 ID **FoundationModel** object `可选` 基础模型 **Name** string 必选基础模型名称 **ModelVersion** string 必选基础模型版本 **Mode** string 必选 `示例值：-` 路由模式。取值： * `Automatic`：自动模式 * `CandidateSet`：候选模型集合模式 * `Ordered`：按顺序路由模式 **Strategy** string 必选 `示例值：-` 路由策略。取值： * `EffectFirst`：效果优先 * `CostFirst`：成本优先 * `Balanced`：均衡 ## 返回参数下方仅列出本接口特有的返回参数。更多信息请参见[返回结构](https://www.volcengine.com/docs/6369/80336)。 **Id** string `示例值：er-20260709143000-abcde` 创建成功后的滚动升级任务 ID。 ## 请求示例 ```text { "EndpointId": "ep-20260709143000-abcde", "ModelReference": { "FoundationModel": { "Name": "doubao-seed-1-6", "ModelVersion": "250615" } }, "Description": "升级到 doubao-seed-1-6 250615 版本", "DryRun": false } ``` ## 返回示例 ```json { "ResponseMetadata": { "RequestId": "20260709143000ABCDEF1234567890" }, "Result": { "Id": "er-20260709143000-abcde" } } ``` ## 错误码下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见[公共错误码](https://www.volcengine.com/docs/82379/1299023)文档。 |状态码 |错误码 |错误信息 |说明 | |---|---|---|---| |400 |MissingParameter.{{Parameter}} |The required parameter {{Parameter}} is missing. |缺少必要的请求参数。请确认请求参数后重试。 | |400 |InvalidParameter.{{Parameter}} |The specified parameter {{Parameter}} is invalid. |请求参数值不合法。请检查参数值的正确性后重试。 | |400 |Throttling |The request is denied due to request throttling. |请求收到流控限制。 | |400 |DryRunOperation |The request is validated by a dryrun operation. |DryRun请求通过了全部检查，空运行成功。 | |409 |OperationDenied.{{Cause}} |The operation is denied due to {{Cause}}. |业务规则不允许该操作。 | |500 |InternalError |The request has failed due to an unknown error. |未知错误，请稍后重试。如果多次尝试仍失败，请提交工单。 |

火山方舟