> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bizyair.vip/llms.txt
> Use this file to discover all available pages before exploring further.

# 生产环境

> 并发配额、数据保留、计费与钱包、监控与回收

## 并发配额与限流

平台为每个帐号按套餐档位分配以下限额：

| 限额项          | 含义                                  | 超限行为         |
| ------------ | ----------------------------------- | ------------ |
| 排队任务数        | 同时处于  `Queuing` + `Preparing` 的任务总数 | 新提交请求返回 429  |
| 运行任务数        | 同时处于`Running`的任务总数                  | 新提交请求返回 429  |
| RPM          | 每分钟 API 请求次数（包含创建/查询）               | 返回 429       |
| WebHook 回调并发 | 同时向你的 URL 发起的回调连接数                  | 平台内部排队，无外部报错 |

<Tip>
  具体限额以你的套餐为准。若业务需要更高并发，可通过个人中心 → 套餐 提交升级申请或联系商务。
</Tip>

**限流应对模式**：

1. 客户端本地队列 + 令牌桶（token bucket）控制发送速率
2. 遇 429 时指数退避重试
3. 长任务使用 WebHook 避免占用 HTTP 连接

## 数据保留与安全

| 数据类型                           | 保留时长     | 说明                 |
| ------------------------------ | -------- | ------------------ |
| 任务元数据（status / requestId / 耗时） | **长期**   | 可随时通过 `/detail` 查询 |
| 输入文件（OSS `inputs/`）            | **30 天** | 过期后自动清理            |
| 输出文件（OSS `outputs/`）           | **15 天** | 过期后无法恢复            |
| API Key                        | 直到手动删除   | 建议定期轮换             |

<Warning>
  重要结果请在 15 天内下载到自有存储。到期后不提供恢复服务。
</Warning>

### 内容审核

平台对输入提示词、上传图片与生成结果均会进行自动内容审核：

* `audit_status: 1` 未审核（不应出现在终态任务）
* `audit_status: 2` 审核通过
* `audit_status: 3` 审核不通过，结果不可访问
* `audit_status: 4` 审核异常（例如输入不可访问）

审核不通过的任务**仍会扣除推理耗时费用**，请在业务层提前过滤敏感提示词。

## 计费与余额

### 计费方式

费用 = `inference_cost_time` × 该应用的单价。包含：

* ✅ 推理耗时（`Running` 阶段）
* ❌ 不包含排队、准备、上传、下载时间
* ❌ 不包含 `Canceled` 任务
* ✅ 包含中断前已消耗的推理时间

### 查询余额

```bash theme={null}
curl -X GET "https://api.bizyair.ai/y/v1/wallet" \
  -H "Authorization: Bearer $BIZYAIR_API_KEY"
```

响应：

```json theme={null}
{
  "code": 20000, "status": true,
  "data": {
    "balance": 1250.5,
    "currency": "BZC",
    "updated_at": "2025-09-11 10:30:00"
  }
}
```

### 低余额预警

建议在应用层定时（例如每小时）拉取余额，低于阀值时发送告警，避免因余额不足中断生产。

## 监控与可观测性

建议监控以下指标：

| 指标            | 采集方式                              | 告警阈值参考       |
| ------------- | --------------------------------- | ------------ |
| 任务成功率         | 统计 `Success / (Success + Failed)` | \< 95%       |
| 平均推理耗时        | `inference_cost_time` P50 / P95   | 环比 +50%      |
| 排队时长          | `Queuing` 累计时间                    | > 5 分钟       |
| 429 频率        | HTTP 响应分布                         | 持续 5 分钟 > 1% |
| WebHook 回调失败率 | 自建回调服务日志                          | > 0.1%       |
| Credits 余额    | `/y/v1/wallet` 定时拉取               | \< 3 天用量     |

## 演练与灾备

### 演练清单

* 定期演练 API Key 泄露后的快速旋转（创建新 Key → 部署 → 删除旧 Key）
* 演练 429 属属降级（降低并发中、反压上游）
* 演练 WebHook 回调回逐失败（转轮询兑底）

### 就绪清单

上线前确认：

* API Key 存于密钥管理服务，**未**硬编码
* 同步阻塞调用的客户端读取超时 ≥ 60s
* WebHook 接受端验证 `X-BizyAir-Task-Authorization` Header
* WebHook 接受端实现幂等（防重复回调）
* 重要产出实时转存到自有 OSS/S3
* 存在 Credits 低余额告警
* 存在 429 / 任务失败率监控与告警
* 包含重试与降级逻辑