额度余额

查询当前钱包余额，以及发起请求的 API Key 实际可用的额度。该接口为只读接口，不接受查询参数。

请求

curl

curl -sS https://api.aisa.one/v1/credits/balance \
  -H "Authorization: Bearer $AISA_API_KEY"

接口要求在 Authorization 请求头中提供标准 AIsa API Key，不接受 MPP 支付授权。

响应

{
  "currency": "USD",
  "account_balance_micros_usd": 3250000,
  "available_balance_micros_usd": 1750000,
  "go_to_market_balance_micros_usd": 750000,
  "gtm": {
    "active": true,
    "balance_micros_usd": 750000,
    "trial_balance_micros_usd": 250000,
    "trial_expires_at": "2026-09-30T12:00:00Z",
    "subscription_balance_micros_usd": 500000,
    "expires_at": "2026-10-31T12:00:00Z"
  },
  "api_key": {
    "unlimited": false,
    "remaining_micros_usd": 1000000,
    "used_micros_usd": 300000
  },
  "as_of": "2026-08-03T12:00:00Z"
}

所有金额均使用整数微美元。一美元等于 1,000,000 微美元，以避免自动化客户端出现浮点舍入误差。

顶层字段

字段	类型	说明
`currency`	string	余额币种，目前固定为 `USD`。
`account_balance_micros_usd`	integer	PAYG 有效余额与 GTM 余额之和。
`available_balance_micros_usd`	integer	当前认证 API Key 可用的 PAYG 余额与 GTM 余额之和。
`go_to_market_balance_micros_usd`	integer	GTM 总余额，与 `gtm.balance_micros_usd` 相同。
`gtm`	object	GTM 余额明细，包括试用余额和订阅余额。
`api_key`	object	当前 API Key 的剩余额度和已使用额度。
`as_of`	string	该余额快照对应的 UTC 时间。

GTM 字段

字段	类型	说明
`active`	boolean	是否有可用 GTM 资金或存在 GTM 订阅周期。
`balance_micros_usd`	integer	GTM 总余额。
`trial_balance_micros_usd`	integer	未过期的 GTM 试用余额。
`trial_expires_at`	string	GTM 试用余额的 UTC 到期时间；没有适用的试用到期时间时省略。
`subscription_balance_micros_usd`	integer	GTM 订阅余额。
`expires_at`	string	当前 GTM 订阅周期的 UTC 到期时间；没有适用订阅周期时省略。

余额计算

PAYG 余额是有效 cash、Trial、promo 和 credit 余额之和。已经过期的 Trial 余额不会计入。 go_to_market_balance_micros_usd 是 GTM 余额。该金额也会作为 gtm.balance_micros_usd 返回，gtm 对象还包含试用余额和订阅余额明细。 account_balance_micros_usd 是 PAYG 余额与 go_to_market_balance_micros_usd 之和。对于有限额度 API Key，available_balance_micros_usd 等于 PAYG 余额与 api_key.remaining_micros_usd 中的较小值，再加上 GTM 余额。对于无限额度 API Key，它等于 PAYG 余额加 GTM 余额。当 PAYG 余额或 Key 余额为负数时，Key 可用的 PAYG 部分最低为零。已过期的 Trial 金额不会计入有效余额。

错误

401 Unauthorized — API Key 缺失、无效、已撤销或已过期。
403 Forbidden — 用户已被禁用，或当前请求 IP 不在 Key 的允许列表内。
500 Internal Server Error — 无法读取余额快照。

该接口的错误响应使用字符串类型的 error 字段：

{
  "error": "invalid api key"
}

有关状态码和重试的一般说明，请参阅错误代码；有关请求限制，请参阅速率限制。

概览

聊天 API

Embeddings 与重排序

搜索 API

Perplexity API

金融 API

Twitter API

Reddit API

Instagram API

Pinterest API

学术搜索 API

WaveInflu API

预测市场 API

CoinGecko

DataForSEO

AgentMail

Apollo

基础功能

TikHub API

请求

响应

顶层字段

GTM 字段

余额计算

错误

​请求

​响应

​顶层字段

​GTM 字段

​余额计算

​错误

请求

响应

顶层字段

GTM 字段

余额计算

错误