获取账单账户

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) 更新时间