API 调用失败怎么排查？从鉴权、额度到请求参数
保留错误响应，确认请求地址与协议，再依次检查凭证、模型权限、额度和参数，避免无效的反复重试。
sunny ·
调用失败时，先保留 HTTP 状态码、错误响应和请求时间。如果响应中提供请求标识，也应一起记录。诊断需要结合错误内容，单独一个状态码通常不足以确定原因。
先确认请求发送到哪里
检查服务域名、最终路径、请求方法和客户端使用的协议。某些客户端会自动拼接路径，应核对完整请求地址。
用最小请求复现问题：减少历史消息和可选参数，保留相同模型与必要输入。注意删除日志里的密钥和敏感业务数据。
检查凭证与权限
收到鉴权或访问相关错误时，核对密钥是否完整、是否过期、是否被禁用，以及鉴权头是否符合接口要求。同时检查模型限制、分组权限与 IP 限制。
网页登录成功不能证明另一台设备或后端程序中的 API Key 配置正确。
检查额度与频率限制
如果错误涉及额度或频率，应查看账号资金、密钥额度和相关限制。密钥有剩余额度，也可能受到账号资金或其他业务预算约束。
限流需要结合响应信息判断。可以在客户端控制并发和重试次数；若支持重试提示，应按提示处理。鉴权失败、参数无效等问题应修正配置后再尝试。
检查模型与参数
确认模型标识、可访问范围和端点支持情况。对于图片、音频或视频任务，还需要核对输入类型、文件格式、大小以及模型要求的参数。
如果简短请求成功而完整请求失败，逐项恢复输入和参数，有助于缩小问题范围。
整理可复现的信息
求助时提供测试时间、使用端点、脱敏模型信息、状态码、错误正文和最小复现步骤。不要发送完整密钥或未处理的用户数据。