GET /api/user/self

/api/user/self 返回当前认证用户的各类可用额度。该接口只返回余额数据；如需用户名、邮箱、角色、权限和用户设置等完整资料，请调用 GET /api/user/self/all。

请求

项目	内容
请求方法	`GET`
请求路径	`/api/user/self`
生产环境	`https://www.anyfast.ai/api/user/self`
请求体	无
查询参数	无

身份认证

接口只允许查询当前认证用户自身的余额。你可以使用系统访问令牌或登录会话进行认证。

系统访问令牌不是用于模型调用的 sk-... API Key。New-Api-User 必须是数字用户 ID，并且必须与令牌或会话所属用户一致。

curl --location 'https://www.anyfast.ai/api/user/self' \
  --header 'Authorization: Bearer <SYSTEM_ACCESS_TOKEN>' \
  --header 'New-Api-User: <USER_ID>' \
  --header 'Accept: application/json'

curl --location 'https://www.anyfast.ai/api/user/self' \
  --header 'Cookie: anyfast_session=<SESSION_COOKIE>' \
  --header 'New-Api-User: <USER_ID>' \
  --header 'Accept: application/json'

普通用户和管理员均不能通过修改 New-Api-User 查询其他用户的数据。

成功响应

{
  "data": {
    "quota": 12747995,
    "details": {
      "wallet_quota": 500000,
      "credit_quota": 12247995,
      "test_voucher_quota": 0,
      "subscription_quota": 0,
      "subscription_unlimited": false
    }
  },
  "message": "",
  "success": true
}

响应字段

字段	类型	必须返回	含义
`success`	boolean	是	请求是否成功。业务成功时为 `true`。
`message`	string	是	提示信息。成功时通常为空字符串。
`data`	object	成功时是	当前用户余额汇总。失败时不返回部分余额数据。
`data.quota`	integer (int64)	是	钱包余额与有效授信剩余额度之和。
`data.details`	object	是	各资金来源的独立明细。
`data.details.wallet_quota`	integer (int64)	是	用户钱包中的当前实际余额。
`data.details.credit_quota`	integer (int64)	是	当前 `active` 授信的剩余可用额度，不是授信总额或已用额度。
`data.details.test_voucher_quota`	integer (int64)	是	当前已生效、未过期、未作废且未耗尽的测试券剩余额度汇总。
`data.details.subscription_quota`	integer (int64)	是	当前有效的有限额订阅剩余额度汇总。
`data.details.subscription_unlimited`	boolean	是	是否存在当前有效的无限额度订阅。

所有金额字段均使用平台原生 quota 整数单位。即使值为 0，字段也会保留。

计算规则

data.quota 只包含钱包余额和可用授信余额：

data.quota = wallet_quota + credit_quota

示例中的计算结果为 500000 + 12247995 = 12747995。以下字段不计入 data.quota：

test_voucher_quota
subscription_quota
subscription_unlimited

因此，data.quota 不是所有资金来源的总和。

额度口径

钱包余额

wallet_quota 是用户当前钱包余额。充值、管理员调额或钱包消费完成后，再次查询会返回最新值。

授信额度

credit_quota 只统计状态为 active 的授信剩余额度：

credit_quota = amount_total - amount_used

已停用或已回收的授信不计入 credit_quota。

测试券额度

test_voucher_quota 只汇总同时满足以下条件的测试券：

已到生效时间；
未超过过期时间；
状态可用；
剩余额度大于 0。

测试券的模型限制不影响余额展示，但会影响实际模型消费资格。

订阅额度

subscription_quota 表示有限额订阅的剩余额度。无限额度订阅通过 subscription_unlimited: true 单独表示，不使用特殊数字或字符串写入 data.quota。

金额换算

调用方应优先使用原始 quota 值进行计算，不应硬编码美元换算比例。当前生产环境的配置为：

500000 quota = $1

按当前生产环境换算，示例响应表示：

资金来源	quota	生产环境金额
钱包	500000	$1.000000
可用授信	12247995	$24.495990
钱包加授信	12747995	$25.495990

不同部署环境的换算配置可能不同。当前生产环境的比例不是固定的接口契约。

错误响应

认证失败时，响应不会包含用户余额或完整用户资料。例如，令牌无效时可能返回：

{
  "message": "无权进行此操作，access token 无效",
  "success": false
}

New-Api-User 与认证用户不匹配时可能返回：

{
  "success": false,
  "message": "无权进行此操作，New-Api-User 与登录用户不匹配"
}

会话不属于当前站点时通常返回 HTTP 403。服务端查询失败时会返回失败响应，并且不会返回由部分资金来源拼接出的 data。

部分认证失败场景可能返回 HTTP 200，但响应体中的 success 为 false。调用方必须同时检查 HTTP 状态码、success 和 message。

​请求

​身份认证

​成功响应

​响应字段

​计算规则

​额度口径

​钱包余额

​授信额度

​测试券额度

​订阅额度

​金额换算

​错误响应

请求

身份认证

成功响应

响应字段

计算规则

额度口径

钱包余额

授信额度

测试券额度

订阅额度

金额换算

错误响应