创建密钥

功能说明

通过 API 方式程序化创建 API 密钥，常用于 SaaS 应用场景，可以为每个客户实例自动创建独立的 API 密钥。

使用场景

SaaS 应用

自动为每个客户实例创建唯一的 API 密钥，实现客户级别的资源隔离和计费。

密钥管理

通过程序化方式管理密钥，支持创建、轮换、删除等操作，满足安全合规要求。

API 请求

请求示例

curl -X POST https://ai-tokenhub.com/v1/keys \
  -H "Authorization: Bearer <YOUR_MANAGEMENT_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-api-key",
    "limit": 10.00,
    "limit_reset": "daily"
  }'

请求参数

参数	类型	必填	说明
name	string	是	API 密钥名称，用于标识
limit	double	否	消费限额（美元），达到限额后密钥自动禁用
limit_reset	enum	否	限额重置周期：daily（每日）、weekly（每周）、monthly（每月）、null（不重置）

响应示例

{
  "id": "sk_or_xxx",
  "name": "my-api-key",
  "hash": "xxx",
  "key": "sk_or_xxx|xxx",
  "enabled": true,
  "limit": 10.00,
  "limit_reset": "daily",
  "created_at": "2024-01-01T00:00:00Z"
}

重要提示

• 返回的 key 字段仅在创建时显示一次，请妥善保管
• Management API Key 不能用于调用 OpenRouter 的 completion 端点，仅用于管理操作
• 建议为不同用途创建独立的密钥，便于管理和监控