接口概览

接口	用途
GET /v1/account/usage	查询当前余额和累计用量
GET /v1/account/usage/records	分页查询用量与计费记录

查询账户用量

curl https://api.mixtoken.ai/v1/account/usage   -H "Authorization: Bearer $MIXTOKEN_API_KEY"

响应示例：

{
  "isValid": true,
  "planName": "NexusAI Credits",
  "remaining": 18.75,
  "used": 6.25,
  "total": 25,
  "unit": "USD"
}

查询用量记录

可选查询参数：page、pageSize、dateFrom、dateTo；日期使用 ISO 8601 格式。

curl "https://api.mixtoken.ai/v1/account/usage/records?page=1&pageSize=20"   -H "Authorization: Bearer $MIXTOKEN_API_KEY"

响应包含 unit、total、page、pageSize 和 records。每条记录可包含 taskId、capability、modelName、billingType、usageMetric、价格与扣费字段、Token 明细、状态、请求时间、延迟、方法和路径。

错误处理

• 401：API Key 缺失或无效。
• 403：API Key 未关联到用户账户。
• 429：触发限流，请等待后重试。