OpenAPI 参考

Modelink API · 管理接口

Modelink 管理接口，用于批量创建 API Key 和导出请求日志。管理接口包含敏感操作与数据，请仅在可信服务端使用。

版本 1.0.0

批量创建 API Key

POST

/v1/apikeys

一次创建 1～100 个 API Key。count 必须与 names 的元素数量一致，每个名称长度为 1～50 个字符。接口使用 AK/SK 请求签名鉴权；部分 Key 创建失败时，响应只包含成功创建的 Key。

认证方式

QiniuAuthAPI 密钥

AK/SK 请求签名，格式为 Qiniu {AccessKey}:{EncodedSign}。签名串包含请求方法、路径、查询参数、Host、Content-Type、X-Qiniu- 请求头以及符合条件的请求体。

header 参数：Authorization

请求体

请求体属性

countinteger, 必填
本次希望创建的 API Key 数量，必须等于 names 的元素数量。
minimum: 1; maximum: 100
namesstring[], 必填
API Key 名称列表。

请求

POST/v1/apikeys

curl https://api.qnaigc.com/v1/apikeys \
  --request POST \
  --header 'Authorization: YOUR_QINIU_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "count": 2,
  "names": [
    "production-service",
    "staging-service"
  ]
}'

响应

object | object

创建完成，或请求被业务校验拒绝。请同时检查响应体中的 status。

响应体属性

- statustrue, 必填
  必填。
  const: true
- - keystring, 必填
    新创建的 API Key。请安全保存，避免写入日志或公开仓库。
    namestring, 必填
    API Key 名称。
    createdAtstring, 必填
    创建时间。
    enabledboolean, 必填
    API Key 是否已启用。
- statusfalse, 必填
  必填。
  const: false
- errorstring, 必填
  错误标识或错误描述。

响应

{
  "status": true,
  "data": {
    "keys": [
      {
        "key": "sk-example-1",
        "name": "production-service",
        "createdAt": "2026-07-18 10:00:00",
        "enabled": true
      },
      {
        "key": "sk-example-2",
        "name": "staging-service",
        "createdAt": "2026-07-18 10:00:00",
        "enabled": true
      }
    ]
  }
}