GET
https://api.yuannengai.com
/
v1
/
account
/
balance
curl --request GET \
  --url https://api.yuannengai.com/v1/account/balance \
  --header 'Authorization: Bearer <token>'

{
  "code": 200,
  "data": {
    "balance": 100.50,
    "currency": "CNY",
    "total_charged": 500.00,
    "total_used": 399.50,
    "credit_balance": 0.00
  }
}
  • 查询 API Key 关联账户的现金余额
  • 返回账户的充值余额和消费信息
curl --request GET \
  --url https://api.yuannengai.com/v1/account/balance \
  --header 'Authorization: Bearer <token>'

{
  "code": 200,
  "data": {
    "balance": 100.50,
    "currency": "CNY",
    "total_charged": 500.00,
    "total_used": 399.50,
    "credit_balance": 0.00
  }
}

​
认证方式

​
Authorization
string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key：访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加：
Authorization: Bearer YOUR_API_KEY

​
响应参数

​
code
integer
响应状态码
​
data
object
余额数据

​
余额不足提醒

当余额不足时，API 调用将返回 402 错误： 
{
  "error": {
    "code": 402,
    "message": "账户余额不足，请充值后再试",
    "type": "payment_required"
  }
}
建议在代码中实现余额检查和预警机制： 
def check_balance():
    response = requests.get(
        "https://api.yuannengai.com/v1/account/balance",
        headers={"Authorization": "Bearer <token>"}
    )
    
    data = response.json()["data"]
    balance = data["balance"]
    
    if balance < 10:
        print(f"⚠️ 余额不足，当前余额：{balance} CNY，请及时充值")
    
    return balance