跳转到主要内容

​
并发配额与限流

平台为每个帐号按套餐档位分配以下限额：
限额项含义超限行为
排队任务数同时处于 Queuing + Preparing 的任务总数新提交请求返回 429
运行任务数同时处于Running的任务总数新提交请求返回 429
RPM每分钟 API 请求次数（包含创建/查询）返回 429
WebHook 回调并发同时向你的 URL 发起的回调连接数平台内部排队，无外部报错
具体限额以你的套餐为准。若业务需要更高并发，可通过个人中心 → 套餐 提交升级申请或联系商务。
限流应对模式：
  1. 客户端本地队列 + 令牌桶（token bucket）控制发送速率
  2. 遇 429 时指数退避重试
  3. 长任务使用 WebHook 避免占用 HTTP 连接

​
数据保留与安全

数据类型保留时长说明
任务元数据（status / requestId / 耗时）长期可随时通过 /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/y/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%
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 / 任务失败率监控与告警
  • 包含重试与降级逻辑