生产环境建议 - BizyAir-Docs

并发配额与限流

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

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

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

限流应对模式：

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

数据保留与安全

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

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

内容审核

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

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

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

计费与余额

计费方式

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

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

查询余额

curl -X GET "https://api.bizyair.ai/v1/wallet" \
  -H "Authorization: Bearer $BIZYAIR_API_KEY"

响应：

{
  "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%
余额	`/v1/wallet` 定时拉取	< 3 天用量

演练与灾备

演练清单

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

就绪清单

上线前确认：

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

​并发配额与限流

​数据保留与安全

​内容审核

​计费与余额

​计费方式

​查询余额

​低余额预警

​监控与可观测性

​演练与灾备

​演练清单

​就绪清单

并发配额与限流

数据保留与安全

内容审核

计费与余额

计费方式

查询余额

低余额预警

监控与可观测性

演练与灾备

演练清单

就绪清单