# 账户计费面板模块

## 功能说明

接口前缀为：
1. 主站：https://ai.burncloud.com
2. 企业站：https://b.burncloud.com

OpenAI SDK 兼容的计费查询接口。使用 Token 认证，提供订阅信息和使用量查询。主要用于第三方应用和 SDK 集成，确保与 OpenAI API 的完全兼容性。

## 🔐 用户鉴权

### 获取订阅额度信息

- **接口名称**：获取订阅额度信息
- **HTTP 方法**：GET
- **路径**：`/dashboard/billing/subscription`
- **鉴权要求**：用户 Token
- **功能简介**：获取用户的订阅配额信息，包括总额度、硬限制和访问有效期，兼容 OpenAI API 格式

#### 💡 请求示例：

```javascript
const response = await fetch('/dashboard/billing/subscription', {  
  method: 'GET',  
  headers: {  
    'Content-Type': 'application/json',  
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'Bearer your_user_id'
  }  
});  
const data = await response.json();
```

#### ✅ 成功响应示例：

```json
{  
  "object": "billing_subscription",  
  "has_payment_method": true,  
  "soft_limit_usd": 100.0,  
  "hard_limit_usd": 100.0,  
  "system_hard_limit_usd": 100.0,  
  "access_until": 1640995200  
}
```

#### ❗ 失败响应示例：

```json
{  
  "error": {  
    "message": "获取配额失败",  
    "type": "upstream_error"  
  }  
}
```

#### 🧾 字段说明：

- **object** （字符串）: 固定值"billing_subscription"
- **has_payment_method** （布尔型）: 是否有支付方式，固定为 true
- **soft_limit_usd** （数字）: 软限制额度（美元）
- **hard_limit_usd** （数字）: 硬限制额度（美元）
- **system_hard_limit_usd** （数字）: 系统硬限制额度（美元）
- **access_until** （数字）: 访问有效期时间戳，Token 过期时间

### 兼容 OpenAI SDK 路径 - 获取订阅额度信息

- **接口名称**：兼容 OpenAI SDK 路径 - 获取订阅额度信息
- **HTTP 方法**：GET
- **路径**：`/v1/dashboard/billing/subscription`
- **鉴权要求**：用户 Token
- **功能简介**：与上述接口功能完全相同，提供 OpenAI SDK 兼容路径

#### 💡 请求示例：

```javascript
const response = await fetch('/v1/dashboard/billing/subscription', {  
  method: 'GET',  
  headers: {  
    'Content-Type': 'application/json',  
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'Bearer your_user_id'
  }  
});  
const data = await response.json();
```

#### ✅ 成功响应示例：

```json
{  
  "object": "billing_subscription",  
  "has_payment_method": true,  
  "soft_limit_usd": 100.0,  
  "hard_limit_usd": 100.0,  
  "system_hard_limit_usd": 100.0,  
  "access_until": 1640995200  
}
```

#### ❗ 失败响应示例：

```json
{  
  "error": {  
    "message": "获取配额失败",  
    "type": "upstream_error"  
  }  
}
```

#### 🧾 字段说明：

- **object** （字符串）: 固定值"billing_subscription"
- **has_payment_method** （布尔型）: 是否有支付方式，固定为 true
- **soft_limit_usd** （数字）: 软限制额度（美元）
- **hard_limit_usd** （数字）: 硬限制额度（美元）
- **system_hard_limit_usd** （数字）: 系统硬限制额度（美元）
- **access_until** （数字）: 访问有效期时间戳，Token 过期时间

### 获取使用量信息

- **接口名称**：获取使用量信息
- **HTTP 方法**：GET
- **路径**：`/dashboard/billing/usage`
- **鉴权要求**：用户 Token
- **功能简介**：获取用户的配额使用量信息，兼容 OpenAI API 格式

#### 💡 请求示例：

```javascript
const response = await fetch('/dashboard/billing/usage', {  
  method: 'GET',  
  headers: {  
    'Content-Type': 'application/json',  
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'Bearer your_user_id'
  }  
});  
const data = await response.json();
```

#### ✅ 成功响应示例：

```json
{  
  "object": "list",  
  "total_usage": 2500.0  
}
```

#### ❗ 失败响应示例：

```json
{  
  "error": {  
    "message": "获取使用量失败",  
    "type": "new_api_error"  
  }  
}
```

#### 🧾 字段说明：

- **object** （字符串）: 固定值"list"
- **total_usage** （数字）: 总使用量，单位为 0.01 美元

### 兼容 OpenAI SDK 路径 - 获取使用量信息

- **接口名称**：兼容 OpenAI SDK 路径 - 获取使用量信息
- **HTTP 方法**：GET
- **路径**：`/v1/dashboard/billing/usage`
- **鉴权要求**：用户 Token
- **功能简介**：与上述接口功能完全相同，提供 OpenAI SDK 兼容路径

#### 💡 请求示例：

```javascript
const response = await fetch('/v1/dashboard/billing/usage', {  
  method: 'GET',  
  headers: {  
    'Content-Type': 'application/json',  
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'Bearer your_user_id'
  }  
});  
const data = await response.json();
```

#### ✅ 成功响应示例：

```json
{  
  "object": "list",  
  "total_usage": 2500.0  
}
```

#### ❗ 失败响应示例：

```json
{  
  "error": {  
    "message": "获取使用量失败",  
    "type": "new_api_error"  
  }  
}
```

#### 🧾 字段说明：

- **object** （字符串）: 固定值"list"
- **total_usage** （数字）: 总使用量，单位为 0.01 美元