跳转到主要内容
管理你的 API Token 用于认证 API 请求。所有 Token 管理端点需要 Supabase session 认证(基于浏览器)。

创建 Token

POST /api/tokens
创建新的 API Token。每个用户最多可拥有 5 个活跃 Token。

请求体

name
string
必填
Token 的描述性名称(如 “My App”、“CI/CD Pipeline”)。

响应

{
  "id": "token-uuid",
  "token": "meigen_sk_aBcDeFgHiJkLmNoPqRsTuVwXyZ012345",
  "name": "My App",
  "created_at": "2025-03-01T12:00:00Z"
}
完整的 Token 值仅在创建时返回一次。请复制并安全保存 — 之后将无法再次查看。

列出 Token

GET /api/tokens
返回已认证用户的所有 Token。

响应

[
  {
    "id": "token-uuid",
    "name": "My App",
    "token_value": "meigen_sk_aBcD...****",
    "is_active": true,
    "last_used_at": "2025-03-01T15:30:00Z",
    "created_at": "2025-03-01T12:00:00Z"
  }
]

撤销 Token

DELETE /api/tokens/:id
撤销(软删除)一个 Token。该 Token 将立即停止用于 API 认证。

路径参数

id
string
必填
要撤销的 Token ID。

响应

{
  "success": true
}

Token 使用记录

GET /api/tokens/:id/usage
返回特定 Token 的使用历史。

路径参数

id
string
必填
要查询使用记录的 Token ID。

响应

{
  "generations": [
    {
      "id": "generation-uuid",
      "model": "nanobanana-2",
      "credits_used": 5,
      "status": "completed",
      "created_at": "2025-03-01T15:30:00Z"
    }
  ]
}