POST/v1/apikeys

创建 API Key

后端校验 `keyName` 必填，`allowedModels` 必须来自当前商户可用模型列表。返回明文 Key，仅在创建时可见。

基础信息

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

请求参数

Body

字段

类型

必填

位置

说明

keyName

string

是

body

API Key 名称。

示例："生产环境主密钥"

allowedModels

array<string>

否

body

允许访问的模型列表；留空表示不限制。

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

[item]

string

否

body

单个模型 ID。

示例："gpt-4o"

expireTime

string

否

body

过期时间，留空表示不过期。

示例："2026-12-31 23:59:59"

请求示例

json

{
  "keyName": "生产环境主密钥",
  "allowedModels": [
    "gpt-4o",
    "sora-2"
  ],
  "expireTime": "2026-12-31 23:59:59"
}

响应示例

json

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "id": 1001,
    "keyName": "生产环境主密钥",
    "keyValue": "sk-live-1234567890",
    "expireTime": "2026-12-31 23:59:59"
  }
}

错误码

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 POST 'https://api.harnmodel.com/v1/apikeys' \
  --header 'Authorization: Bearer mgmt-token-xxx' \
  --header 'Content-Type: application/json' \
  --data '{}'

多语言示例

bash

curl --location --request POST 'https://api.harnmodel.com/v1/apikeys' \
  --header 'Authorization: Bearer mgmt-token-xxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "keyName": "生产环境主密钥",
    "allowedModels": [
      "gpt-4o",
      "sora-2"
    ],
    "expireTime": "2026-12-31 23:59:59"
  }'