创建 API 密钥

curl -X POST 'https://app.memorylake.cn/openapi/admin/api/v1/api-keys' \
  -H 'Authorization: Bearer sk-admin-xxxxxx' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 5f3a2b1c-9d8e-4f00-a1b2-c3d4e5f60789' \
  -d '{"name": "ci-pipeline", "expires_at": 1786536000}'

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "id": "313",
    "name": "ci-pipeline",
    "key_prefix": "a1b2c3d4",
    "key_type": "data",
    "key": "sk-a1b2c3d4...redacted...e5f6"
  }
}

POST /openapi/admin/api/v1/api-keys

创建一把数据密钥，并且只返回一次完整值 —— 请立即保存，读取类接口不会再返回它。本接口无法创建管理密钥。管理密钥由已登录的 Owner 或 Admin 在控制台签发，因此泄露的管理密钥永远无法用来签发出另一把管理密钥。

所需权限： service_account:create

请求头

string

可选。用相同的值重试会重放第一次的结果，而不会创建出第二把密钥。

请求体

string

required

显示名称（1–100 个字符）

integer

过期时间，Unix 秒。省略或传 0 表示该密钥永不过期。

string

为某个虚拟成员签发密钥；该密钥随后会以这个成员的身份行事，使用它的角色，产出也归属到它。只能指向虚拟成员 —— 传入真人成员会返回 404。除 service_account:create 之外，还需要 member:manage_virtual 权限。

curl -X POST 'https://app.memorylake.cn/openapi/admin/api/v1/api-keys' \
  -H 'Authorization: Bearer sk-admin-xxxxxx' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 5f3a2b1c-9d8e-4f00-a1b2-c3d4e5f60789' \
  -d '{"name": "ci-pipeline", "expires_at": 1786536000}'

响应

object

Show 创建出的密钥对象 —— 唯一会携带密钥值的响应

string

稳定的密钥标识符

string

显示名称

string

用于展示的前缀

string

恒为 data

string

完整的 API 密钥，包含 sk- 前缀。请立即保存 —— 它不会再次显示。

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "id": "313",
    "name": "ci-pipeline",
    "key_prefix": "a1b2c3d4",
    "key_type": "data",
    "key": "sk-a1b2c3d4...redacted...e5f6"
  }
}

MemoryLake API

管理 API

请求头

请求体

响应

​请求头

​请求体

​响应

请求头

请求体

响应