---
title: 获取余额
url: https://runapi.ai/zh-CN/docs/api/management/balance/retrieve.md
canonical: https://runapi.ai/zh-CN/docs/api/management/balance/retrieve
locale: zh-CN
---

# 获取余额

获取剩余的付费和奖励余额，以及当前用量汇总。

## 端点

GET /api/v1/me/balance

基础 URL: https://runapi.ai

API 版本: v1

身份验证: Authorization: Bearer YOUR_API_KEY


授权: 返回当前 Standard API 密钥绑定账户的余额。

## 成功响应

HTTP 200 - GET /api/v1/me/balance

```json
{
  "balance_cents": 1200,
  "bonus_balance_cents": 200,
  "paid_balance_cents": 1000,
  "spent_cents_today": 75,
  "spent_cents_total": 4300
}
```

## 错误响应 (401)

HTTP 401

```json
{
  "error": "Authentication required"
}
```

## 错误响应 (403)

HTTP 403

```json
{
  "error": "Standard API key required"
}
```

## cURL 示例



### curl

```curl
curl -X GET https://runapi.ai/api/v1/me/balance \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

## 相关参考

- [余额](/docs/api/management/balance)
- [余额对象](/docs/api/management/balance/object)