令牌管理
令牌管理
TLDR：管理你的 API Token，包括查询、创建和配置令牌。
认证说明
new-api-user：你的账户 ID，可在控制台的 个人信息 页面中查看。Authorization：在请求头中直接传入系统令牌的值，无需添加 Bearer 等前缀。请勿将系统令牌与通过本接口创建的 API Token 混淆。系统令牌用于管理操作，API Token 用于调用 Claude API。
获取令牌列表
请求
GET /api/token/请求头
| 参数 | 必需 | 类型 | 说明 |
|---|---|---|---|
new-api-user | 是 | string | 你的账户 ID |
Authorization | 是 | string | 你的系统令牌 |
查询参数
| 参数 | 必需 | 类型 | 说明 |
|---|---|---|---|
p | 是 | string | 页码，从 0 开始 |
size | 是 | string | 每页数量 |
示例
响应
{
"success": true,
"data": [
{
"id": "token-id",
"name": "my-token",
"created_at": 1234567890,
"last_used_at": 1234567890
}
]
}响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
success | boolean | 请求是否成功 |
data | array | 令牌列表 |
data[].id | string | 令牌唯一标识 |
data[].name | string | 令牌名称 |
data[].created_at | integer | 创建时间（Unix 时间戳，单位秒） |
data[].last_used_at | integer | 最后使用时间（Unix 时间戳，单位秒） |
新增令牌
请求
POST /api/token/请求头
| 参数 | 必需 | 类型 | 说明 |
|---|---|---|---|
new-api-user | 是 | string | 你的账户 ID |
Authorization | 是 | string | 你的系统令牌 |
Content-Type | 是 | string | 固定为 application/json |
请求体
{
"name": "token-name",
"models": ["claude-sonnet-4-6-20250514"],
"unlimited_quota": false,
"quota": 1000000
}示例
响应
{
"success": true,
"data": {
"id": "token-id",
"key": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"name": "my-app-token"
}
}响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
success | boolean | 请求是否成功 |
data | object | 新创建的令牌信息 |
data.id | string | 令牌唯一标识 |
data.key | string | API Key，仅在创建时返回一次 |
data.name | string | 令牌名称 |
⚠️ 重要：API Key 只在创建时显示一次，请立即保存。
Python 示例
Node.js 示例
错误处理
| HTTP 状态码 | 说明 | 常见原因 |
|---|---|---|
401 Unauthorized | 认证失败 | 系统令牌缺失、无效或已过期。请检查 Authorization 请求头是否正确传入了有效的系统令牌。 |
403 Forbidden | 权限不足 | 当前系统令牌没有执行该操作的权限，或 new-api-user 指定的账户 ID 与系统令牌不匹配。请确认账户 ID 正确且令牌具备相应权限。 |
注意事项
Authorization）与 API Token 不同，用于管理接口