文档导航
帮助与支持

状态页与请求成功验证

区分公开探测、使用日志、客户端完整响应和代码任务验收,记录可复核的请求结果与限制。

文档更新:

本页目录
  1. 四种证据分别说明什么
  2. 怎样验证一次编程工具接入
  3. 留下一份可复核的记录
  4. 结果不一致时怎么判断

状态页正常,不能单独证明你的一次 Claude Code 或 Codex 请求已经成功。公开探测、网关日志、客户端完整响应和实际任务结果,回答的是四个不同的问题。

内容复核:2026-11-04。本页说明核对方法,不公布未经验证的成功率、延迟或服务等级承诺。本文没有新增真实请求或压测;历史客户端实测版本见接入矩阵。

四种证据分别说明什么

证据 可以说明 不能单独说明
公开状态页的探测结果 所展示探测目标在对应时间窗口的观测结果 你的 Key、分组、模型、网络和长任务都会成功
/v1/models 返回目标模型 当前 Key 此刻可以发现该模型 ID 实际推理、流式结束或工具执行已经通过
ZCloudAPI 使用日志 网关记录的请求、用量、错误及结算信息 客户端一定收齐回复,或代码任务已经正确完成
客户端完整结果与任务验收 本次客户端是否正常结束,以及产物是否满足要求 未来所有请求的稳定性、其他系统版本或并发能力

看状态页时同时记录所选目标、时间范围和页面显示的统计口径。未展示采样频率、超时阈值或检测内容时,就将这些信息记为未知;不要把一个小型探测请求的延迟当成复杂编程任务耗时,也不要把探测成功率当成全部用户请求成功率。

怎样验证一次编程工具接入

  1. 记录客户端版本、操作系统、模型 ID、实际 Provider 和发生时间。不复制凭据。
  2. 按 Claude Code或 Codex CLI教程发起一次最小任务,保留命令的成功/失败状态与可公开的错误信息。
  3. 确认回复含有可用正文且正常结束。若只有部分文字、工具参数片段或连接突然关闭,将本次记为中断,不能因为 HTTP 200 就记成功。
  4. 在使用日志按请求标识核对;若没有标识,只能用时间、模型与分组缩小范围,并明确这种关联的局限。
  5. 最小调用通过后,再在自己的测试目录验证一个实际代码任务;代码输出还需要运行或审查。最小文本成功不代表工具调用与长任务已经验收。

流式结果需要按照所用协议确认完成状态。不同协议的结束方式不一样,不能用“收到了任意一条 SSE 数据”作为统一成功判据。具体接入与返回格式见 Responses API和 Claude Messages。

留下一份可复核的记录

下面是记录模板,不是真实样本:

观测时间及其时区:
工具与版本 / 操作系统:
请求模型 ID / 实际分组:
测试类型:最小文本 / 流式 / 工具调用 / 实际代码任务
客户端结果:完整成功 / 明确失败 / 中断 / 无法判定
正文与正常结束证据:
请求标识(如有):
网关日志匹配:精确匹配 / 仅时间近似 / 未找到
任务产物验收:通过 / 未通过 / 未执行
状态页对应目标、窗口和结果:
已知限制及未覆盖范围:

每次尝试单独记录。重试成功后保留之前失败的尝试,既报告最终任务结果,也报告经历过的错误;不要只留下成功样本。

分享记录前删除完整 API Key、请求头中的认证信息、Cookie、提示词、私有源码、请求正文和用户信息。支持排障通常先需要时间、模型、客户端版本、错误码及请求标识,详细材料按实际需要另行提供。

结果不一致时怎么判断

现象 下一步
状态页正常,但我的请求失败 按排障手册检查地址、认证、权限、余额、网络及具体错误
日志有用量,但客户端没有完整回复 保留中断事实,对照同一请求排查链路;有用量不等于完整交付,结算另按日志核对
最小请求成功,代码任务失败 单独验证工具调用、上下文、任务权限与客户端行为,不把失败归并成“模型不可用”
找不到对应日志 检查实际 Provider 和地址;先确认请求确实经过 ZCloudAPI
不同时间或不同模型结果差异很大 分开记录版本、模型、分组和测试窗口,避免合并成单一稳定性结论

费用问题请结合计费与分组及实际用量核对。公开模型目录、状态页与历史教程都不能替代你的当前账号权限和实际请求结果。