获取账单账户
GET /api/v1/billing/account
返回组织的账单账户快照(计费模式、余额、信用额度)。
鉴权:本接口属于控制台后端 API(Base URL
https://portal.aiin1.ai,注意不是api.portal.aiin1.ai),需携带控制台账号登录后获取的access_token(15 分钟有效),不能使用sk-nex-API 令牌。登录方式见 账单对账与用量自动同步。仅需余额监控时,推荐改用sk-nex-令牌直查GET https://api.portal.aiin1.ai/v1/dashboard/billing/credit_grants,零登录,见同一指南。
请求示例
curl https://portal.aiin1.ai/api/v1/billing/account \
-H "Authorization: Bearer $ACCESS_TOKEN"响应
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
id |
string(uuid) | 是 | 账单账户 ID |
org_id |
string(uuid) | 是 | 组织 ID |
billing_mode |
string | 是 | 计费模式:prepaid(预付费)/ postpaid(后付费)/ hybrid(混合) |
credit_balance_usd |
string(decimal) | 是 | 实时可用余额(USD,预付费模式的事实源;后付费 / 混合模式下无意义) |
credit_limit_usd |
string(decimal) | 是 | 信用额度(USD,后付费 / 混合模式使用) |
updated_at |
string(datetime) | 是 | 更新时间 |