首先，识别失败的步骤

检查服务状态，然后区分账户访问、API 身份验证、模型发现、推理和付款问题。模型出现在目录中并不代表实时可用性：GET /v1/models 列出了已连接的部署。

503 service_unavailable 表示所需服务无法接受请求。在重试之前，请检查服务状态和 API 参考；重复请求无法启用不可用的服务。对于专用 GPU，请等待确认的配置完成。对于付款，请遵循订单的说明和记录的验证状态；刷新订单不会增加余额。

根据响应而不是猜测来排查

记录 HTTP 状态码以及错误的 code 和 message。在更改应用逻辑之前，检查配置的 API 基础 URL、确切的模型 ID 和客户端版本。

401： 检查 Bearer 头以及密钥是否已被吊销。不要将完整密钥写入日志。
403： 选择密钥允许列表所允许的模型。
400 或 413： 检查 JSON、必填字段、输出限制以及输入/输出合并的上下文预算。
402： 检查账户是否有一笔至少 USD 100 的符合条件的已确认充值，然后检查可用信用和所选密钥的预算；符合条件的账户无需维持 USD 100 余额。
429： 如果提供了 Retry-After 头，请遵循它，使用有界重试，并检查适用的服务限制；没有每日免费试用额度。
502 或 503： 在进行有界重试之前，检查可用性和错误消息。

错误指南和限制说明了恢复路径。新请求可能会产生新工作；不要假设客户端重试会被去重。

关闭浏览器标签页、超时或流中断并不证明生成已停止。保存任何响应标识符和最终使用帧（如果收到）。最终使用帧可能会在选择的 finish_reason 之后到达；网络块不一定是完整的事件。

409 pending_reconciliation 或分发后的上游错误可能会使余额保持预留状态，直到获得权威的使用数据。避免发送重复请求以清除保留。将 UTC 时间、模型和密钥名称与控制台使用情况进行比较，并保留请求详细信息以供对账。清除时间不作保证。

对于付款问题，请记录订单参考、资产、网络、金额和可见状态。切勿仅仅因为第一笔付款处于待处理状态就再次付款。钱包提款目前不可用。在激活之前取消付费 GPU 订单会将其付款退回到 WeightsAPI 账户余额；它不会将资金转移到钱包。

一份有用的报告包括操作、UTC 时间戳、端点路径、模型 ID、SDK 或集成及其版本、流式传输设置、输出 token 限制、状态/错误、预期结果和实际结果。仅在可用时包含响应或交易参考号；网关目前并非在每个错误上都公开支持 ID。

添加能够复现该问题的最小合成示例。用虚构文本替换真实对话、客户记录和私人文档。包括相关的重试次数，以及该问题是否会在不同请求之间重复出现。截图应显示错误和上下文，但需移除你不打算共享的凭据、余额或标识符。

对于专用 GPU 订单，请提供订单编号、配置以及可见的付款或部署状态。待处理订单并非已激活的机器。

切勿包含 API 密钥、Authorization 头、会话 cookie、私有钱包密钥、恢复短语或完整的环境文件。密钥名称或有意缩短的前缀足以区分应用程序。公开的交易参考号仍可能将活动与钱包关联起来；只分享调查所需的内容。

如果密钥已泄露，请创建一个替换密钥，更新应用程序并吊销旧密钥。吊销会阻止新的准入；之前已准入的请求会正常结算。有关密钥处理，请参阅身份验证。

复制并审查您的报告，然后将其与相关的请求或订单参考一起保存。复制并不提交工单。官方支持联系方式和服务时间尚未发布；仅使用确认的渠道分享报告。

响应目标、升级联系人和服务积分尚未确定。请勿在报告中包含凭据和敏感的客户内容。