白云 API 教程:如何读懂状态监控
实时网关检查、模型历史成功率、没有样本与故障判断。 附完整检查步骤、实操验证和错误处理。
如何读懂状态监控
查看状态页
状态监控提供网关检测、响应耗时及模型请求历史。页面自动刷新,可手动刷新;数据暂时取不到时显示未知或过期,不会默认全部正常。
网关检查
后台每分钟检测本网关的公开健康接口并记录最近 60 次。检测成功说明网关能够响应,不等于所有模型或上游都能成功生成。这里的延迟是健康接口耗时,不是模型首字或完整生成耗时。
模型请求历史
模型卡片来自本站原生统计的真实请求;显示最近 24 小时成功率、平均响应耗时和每小时色条。有失败会显示部分异常或异常;灰色小时表示没有记录,不能计入成功率,也不表示停机。长时间没有新请求时显示「暂无近期样本」,不据此保证当前可用。
如何排查
网关正常但模型异常时,先换一条最小文本请求,核对密钥、余额、参数与上游情况。历史失败包含不同请求条件,不能直接当作独立探针可用率。网关检测异常时,保留时间和错误,并稍后再次查看。
状态页不是 SLA 承诺,也不会触发付费模型轮询或收集你的提示词。完整消费信息仅在本人控制台查看。
实操前的检查清单
- 准备自己的账户与调用密钥,不使用他人的共享凭据。
- 记录客户端版本、系统和准备使用的模型,便于排查时复现。
- 保存原配置或截图,隐藏密钥、验证码与私人内容。
- 确认测试可能消费少量 DK,先用一句话、一次请求开始。
- 查阅当前模型广场与状态页,再决定是否启用更多功能。
详细排查:灰色不是失败,绿色也不是保证
先读数据更新时间。网关最近一次成功只证明该检查接口可访问;模型统计来自已发生的真实请求。有样本的时间段才参与模型历史成功率,空白时间不能补成成功。历史失败也可能与参数、网络或上游有关,结合自己请求的错误码分析。
怎样确认本节已经学会
不要只检查「配置保存成功」提示。你应能说清当前 Base URL、密钥用途、选用模型和请求协议,能在相应控制台核对自己的操作结果。客户端教程以一次实际纯文本响应和对应日志为初步完成标准;账户教程以安全信息完善为标准;计费教程以本金、通道费与 DK 的对应关系核对为标准。
如果出现错误,记录发生时间、HTTP 状态、脱敏错误内容以及实际期待的结果。不要截图整页密钥,也不要把密码和验证码交给其他人。对 401 应先解决认证,对 400 应先解决参数,对 429 应停止密集重试,对 404 应核对请求路径与上游是否实现,不能用重新充值解决所有报错。
一个适合练习的小任务
在自己的测试环境完成本节的最小步骤,用文字记录「原来怎么设置、改了哪一项、看到了什么结果」。不把生产数据、真实付款或不可恢复的命令当练习。遇到超出本节的功能,先查看对应协议教程,再考虑添加功能;一次只变更一个配置,容易判断哪一步导致错误。
下一步与版本边界
返回完整学习地图 · API 站精简配置 · 本站实时状态。
教程于2026年10月9日整理。具体界面与能力可能随客户端和上游版本变化;配置指引不等于所有客户端版本已经实测通过。本站余额消费、QQ / 支付宝登录及已开放通路以实际页面为准;压缩接口此前的上游 404、生图尚无可用渠道等限制不要理解为配置文件能自动消除。