GET /v1/balance

此只读端点验证 API 密钥，但不需要正余额。

要求

curl https://api.model-gate.com/v1/balance \
  -H "Authorization: Bearer mg_live_..."

回复

{
  "object": "balance",
  "currency": "USD",
  "balance": "12.3400000000"
}

对于个人凭证，余额属于拥有密钥的用户。对于企业凭证，API 费用始终使用公司所有者的钱包。仅当凭证主体具有公司级别余额可见性（组织所有者、管理员或计费角色）时，才会返回共享公司余额。员工开发者/查看者凭证可以执行允许的 API 请求，但会从以下位置接收 HTTP 403： /v1/balance;这些用户在控制面板中只能看到他们允许的组使用和限制。 API密钥 usage 和 spend_limit 保持单独的值。

认证错误

{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "invalid API key"
  }
}

业务权限错误

{
  "error": {
    "type": "permission_error",
    "code": "balance_not_permitted",
    "message": "Company balance is not available for this credential principal."
  }
}