PUT/v1/apikeys/{id}/models

更新 API Key 模型范围

使用 `modelIds` 提交模型列表；模型 ID 必须来自当前商户可用模型列表。

基础信息

鉴权	Authorization: Bearer 管理 token
请求类型	application/json
响应类型	application/json

请求参数

Path

字段

类型

必填

位置

说明

id

string

是

path

API Key ID。

示例："1001"

Body

字段

类型

必填

位置

说明

modelIds

array<string>

是

body

新的模型白名单。

示例：["gpt-4o","sora-2"]

[item]

string

否

body

单个模型 ID。

示例："sora-2"

请求示例

json

{
  "modelIds": [
    "gpt-4o",
    "sora-2"
  ]
}

响应示例

json

{
  "code": 200,
  "msg": "操作成功",
  "data": null
}

错误码

HTTP	code	说明
401	`unauthorized`	管理开放 API 鉴权失败。
400	`validation_error`	请求参数格式错误或取值不满足约束。
404	`not_found`	目标资源不存在或不属于当前商户。

在线调试

Playground · 浏览器直连网关

更新 API Key 模型范围

重设指定 API Key 的可用模型范围。

Base URL Token / API Key

JSON 请求体

json

尚未发起请求。

bash

curl --location --request PUT 'https://api.harnmodel.com/v1/apikeys/1001/models' \
  --header 'Authorization: Bearer mgmt-token-xxx' \
  --header 'Content-Type: application/json' \
  --data '{}'

多语言示例

bash

curl --location --request PUT 'https://api.harnmodel.com/v1/apikeys/1001/models' \
  --header 'Authorization: Bearer mgmt-token-xxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "modelIds": [
      "gpt-4o",
      "sora-2"
    ]
  }'