创建 API Key

POST/v1/keys

创建新的 Token360 推理 API Key。

原始 API Key 只会在响应的 key 字段中返回一次。请安全保存；后续响应只会返回 key hash。

身份验证

Authorization Bearer <USER_JWT>

必须使用已登录用户 JWT。普通推理 API Key、MANAGEMENT Key 和 PROVISIONING Key 均不支持此接口。企业机器自动化请使用 Enterprise 控制面接口。

企业 API 指南 · 查询企业余额

请求体

namestringrequired

新 API Key 名称。

workspace_idstring

Workspace code，默认 DEFAULT。

expires_atstring | null

可选 UTC ISO-8601 过期时间，例如 2029-11-30T23:59:59Z。非 UTC offset 会被拒绝。

creator_user_idstring | null

兼容字段。Key 的所有者始终为当前已鉴权账户。

limitnumber | null

可选 USD 花费上限。会持久化，并在鉴权时强制（触顶返回 006）。

limit_resetstring | null

可选重置周期：daily / weekly / monthly，或 null 表示终身。UTC 零点重置；周为周一至周日。

响应

keystring

原始 API Key，仅展示一次。

dataobject

创建后的 API Key 信息。

data.hashstring

管理接口使用的 hash 标识。

data.namestring

API Key 名称。

data.labelstring

展示标签，与 name 一致。

data.disabledboolean

当 Key 状态不是 ACTIVE 或 expires_at 已过期时为 true。

data.workspace_idstring

Key 所属 workspace code。

data.creator_user_idstring | null

所有者用户 ID。

data.created_atstring

创建时间，UTC ISO-8601 格式。

data.updated_atstring | null

最后更新时间。

data.expires_atstring | null

UTC 过期时间，或 null。

data.usagenumber

该 Key 累计消费金额（USD），不是赠送 Credit 余额。

data.usage_dailynumber

当前 UTC 日内该 Key 的消费金额（USD）。

data.usage_weeklynumber

当前 UTC 周内该 Key 的消费金额（USD），周一开始。

data.usage_monthlynumber

当前 UTC 自然月内该 Key 的消费金额（USD）。

data.limitnumber | null

配置的 Key 消费上限（USD）；未设置时为 null。

data.limit_remainingnumber | null

适用限额周期内的剩余预算（USD）；未设置上限时为 null。

data.limit_resetstring | null

daily | weekly | monthly | null（终身）。

data.is_free_tierboolean

当前为 false。

data.is_management_keyboolean

此响应描述推理 Key，该字段为 false。

data.is_provisioning_keyboolean

当前为 false。

data.rate_limitobject

每分钟请求限制信息。

请求

Shell

1curl -X POST https://api.token360.ai/v1/keys \
2  -H "Authorization: Bearer $USER_JWT" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "name": "Analytics Service Key",
6    "workspace_id": "DEFAULT",
7    "expires_at": "2029-11-30T23:59:59Z",
8    "limit": 100,
9    "limit_reset": "weekly"
10  }'

响应

JSON

1{
2  "key": "sk-token360-inf-...",
3  "data": {
4    "hash": "f01d52606dc8f0a8303a7b5cc3fa07109c2e346cec7c0a16b40de462992ce943",
5    "name": "Analytics Service Key",
6    "label": "Analytics Service Key",
7    "disabled": false,
8    "workspace_id": "DEFAULT",
9    "creator_user_id": "00000000-0000-4000-8000-000000000001",
10    "created_at": "2026-06-04T00:00:00Z",
11    "updated_at": "2026-06-04T00:00:00Z",
12    "expires_at": "2029-11-30T23:59:59Z",
13    "usage": 0,
14    "usage_daily": 0,
15    "usage_weekly": 0,
16    "usage_monthly": 0,
17    "limit": 100,
18    "limit_remaining": 100,
19    "limit_reset": "weekly",
20    "is_free_tier": false,
21    "is_management_key": false,
22    "is_provisioning_key": false,
23    "rate_limit": {
24      "interval": "minute",
25      "note": "Token-360 per-minute request limit",
26      "requests": 1000
27    }
28  }
29}

此页面对您有帮助吗？