HakanAI 文档 | 账户相关接口

本节介绍 Hakan AI 提供的账户管理类 API，常用于在自己的应用 / 仪表板中查看余额、用量、订阅信息等。

所有接口都需要在请求头携带令牌：Authorization: Bearer sk-xxxxxxxx

查询账户余额（OpenAI 兼容）

为兼容 OpenAI 原有应用，Hakan AI 支持以下熟悉的两个接口：

`GET /v1/dashboard/billing/subscription`

获取账户订阅信息（包含总额度）。

curl https://hakanaiktn.com/v1/dashboard/billing/subscription \
  -H "Authorization: Bearer sk-xxxxxxxx"

响应示例：

{
  "object": "billing_subscription",
  "has_payment_method": true,
  "soft_limit_usd": 9999.0,
  "hard_limit_usd": 9999.0,
  "system_hard_limit_usd": 9999.0,
  "access_until": 0
}

`GET /v1/dashboard/billing/usage`

获取一段时间内的用量。

curl "https://hakanaiktn.com/v1/dashboard/billing/usage?start_date=2026-06-01&end_date=2026-06-30" \
  -H "Authorization: Bearer sk-xxxxxxxx"

响应示例：

{
  "object": "list",
  "total_usage": 123.45,
  "daily_costs": [...]
}

这两个接口返回值的单位是美元，可直接用于 OneAPI / 代理类应用展示余额。

当前用户信息

`GET /api/user/self`

需要使用 Cookie / 系统访问令牌，常用于网页前端展示个人信息。

curl https://hakanaiktn.com/api/user/self \
  -H "Authorization: Bearer <系统访问令牌>"

响应示例：

{
  "success": true,
  "data": {
    "id": 1,
    "username": "xl",
    "display_name": "xl",
    "quota": 500000,
    "used_quota": 0,
    "request_count": 0,
    "group": "default",
    "...": "..."
  }
}

quota 与 used_quota 字段单位为「原始 quota」，与美元的换算关系为 1 USD = 500000 quota。

列出可用模型

`GET /v1/models`（OpenAI 兼容）

curl https://hakanaiktn.com/v1/models \
  -H "Authorization: Bearer sk-xxxxxxxx"

返回当前令牌可访问的模型列表。

`GET /v1beta/models`（Gemini 协议）

curl https://hakanaiktn.com/v1beta/models \
  -H "x-goog-api-key: sk-xxxxxxxx"

返回 Gemini 协议下的模型列表。

`GET /v1/models/{model}`

查询单个模型的详细信息：

curl https://hakanaiktn.com/v1/models/gpt-4o \
  -H "Authorization: Bearer sk-xxxxxxxx"

模型价格表

`GET /api/pricing`

获取所有模型的实时价格表（无需登录）：

curl https://hakanaiktn.com/api/pricing

响应：返回一个 JSON 数组，每个元素包含模型名、输入价、输出价、缓存价等。

充值订单查询

`GET /api/user/topup/self`

返回当前用户近 30 天的充值记录（分页）：

curl "https://hakanaiktn.com/api/user/topup/self?p=1&size=20" \
  -H "Authorization: Bearer <系统访问令牌>"

响应示例：

{
  "success": true,
  "data": {
    "items": [
      {
        "id": 22,
        "user_id": 7,
        "amount": 1,
        "money": 1.0,
        "trade_no": "ali_ref_xxxxxx",
        "payment_method": "alipay",
        "status": "success",
        "create_time": 1780500000
      }
    ],
    "total": 1
  }
}

注意事项

这些 OpenAI 兼容的余额接口（/v1/dashboard/...）是 平台对外暴露的兼容层，原 OpenAI 已不再提供它们；返回值仅供参考，准确余额请以网页控制台为准。
系统访问令牌（用于 /api/user/self 等管理接口）和模型调用令牌是两套不同的密钥，请勿混淆。
接口的请求频率受服务等级与限速限制。

账户相关接口

On this page