認證

取得目前 API Key 資訊

GET /v1/auth/me

回傳目前 API Key 的詳細資訊和擁有的權限。

請求範例

GET /v1/auth/me
Authorization: Bearer sk-your-api-key

回應範例

{
  "success": true,
  "code": 1000,
  "message": "Success",
  "data": {
    "user_id": "019373a00a1b7c2d3e4f5a6b7c8d9e0f",
    "project_ids": [
      "019373a01a2b7c3d4e5f6a7b8c9d0e1f"
    ],
    "permissions": [
      "gateway.chat",
      "gateway.embeddings",
      "gateway.rerank",
      "query.search",
      "source.read",
      "source.write",
      "project.read",
      "project.write",
      "usage.read",
      "memory.read",
      "memory.write",
      "audit.read",
      "audit.export"
    ]
  }
}

回應欄位

欄位	類型	說明
user_id	string	帳號 ID
project_ids	string[]	此 Key 綁定的知識庫 ID 列表（未綁定時為空陣列）
permissions	string[]	此 Key 的所有權限，依 Bit 0-12 順序排列

權限列表

權限	Bit	說明
gateway.chat	0	呼叫 Chat Completions API
gateway.embeddings	1	呼叫 Embeddings API
gateway.rerank	2	呼叫 Rerank API
query.search	3	知識庫檢索（僅查詢，不含文件管理）
source.read	4	讀取文件和知識庫
source.write	5	上傳和管理文件
project.read	6	讀取知識庫設定
project.write	7	修改知識庫設定
usage.read	8	查看使用量統計
memory.read	9	讀取和搜尋記憶
memory.write	10	新增、修改、刪除記憶
audit.read	11	讀取 Audit Log
audit.export	12	匯出 Audit Log（Pro+ 方案）