文档中心

火山方舟

管理推理接入点（Endpoint）

更新推理接入点

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

更新一个已创建的推理接入点（Endpoint）的可变配置，包括名称、描述、限流配置、标签、模型推理默认参数、水印与内容安全护栏等。仅传入需要变更的字段，未传字段保持原值。

注意

接入点接入的模型（ModelReference）创建后不可修改；如需更换模型请新建接入点。本接口仅更新传入的字段，未在请求中出现的字段保持原值；如需先验证参数合法性而不实际修改，可设置 DryRun 为 true。

鉴权

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

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

请求参数

Body 参数

Id string 必选 | 接入点 ID

AgenticStrategy object | Agent 策略

AgenticSkill object 必选 | AgenticSkill

AgenticContext object | AgenticConte

AllowDataCollected boolean | 允许数据采集

ContentGeneration object | 生图/生视频配置

DataDelivery boolean | 数据回流

Description string | 接入点描述

DryRun boolean 默认值 false | 预检模式

Fallback object | 降级配置

InferenceDefaultParam object | 推理默认参数

InferenceFoundry object | 推理工厂配置

LimitCoefficient object | 限流系数

Moderation object | 内容安全护栏

Name string | 接入点名称

NeedWatermark boolean | 启用水印

RateLimit object | 限流配置

ServiceInfo object | MLP 服务信息

Tags object[] | 标签列表

WatermarkInfo object | 水印主体信息

响应参数

本接口无特有的返回参数，成功时 HTTP 状态码为 200，返回结构中 Result 为空对象 {}。

默认

Request

curl 'https://ark.cn-beijing.volcengineapi.com/?Action=UpdateEndpoint&Version=2024-01-01' \
  -H 'Content-Type: application/json' \
  -H 'X-Date: <X-Date>' \
  -H 'X-Content-Sha256: <X-Content-Sha256>' \
  -H 'Authorization: HMAC-SHA256 Credential=<AK>/<X-Date>/cn-beijing/ark/request, SignedHeaders=content-type;host;x-content-sha256;x-date, Signature=<Signature>' \
  -d '{
  "Id": "ep-id",
  "Name": "testname",
  "Description": "testdescription",
  "RateLimit": {
    "Rpm": 111,
    "Tpm": 237
  }
}
'

Response

{
  "ResponseMetadata": {
    "RequestId": "20240514213302095012180018DD91C7",
    "Action": "UpdateEndpoint",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {}
}

最近更新时间：2026.09.04 20:24:12

这个页面对您有帮助吗？

有用

无用