帮助
常见错误与排查
按状态码、请求是否到达日志和具体能力逐层定位 InfiniteX 请求故障
目标
从一个可复现的最小失败出发，判断问题属于账号、Key、分组、模型/endpoint、渠道、额度、价格、限流、上游、网络还是异步任务，并准备 request ID。
前置条件
- 记录失败时间、客户端版本、实际 Base URL、endpoint 和 HTTP 状态码。
- 只用无隐私的最小请求复现。
- 不记录或提交完整 Key、Cookie、邮箱、prompt、响应、余额、订单或内部 ID。
准确入口
- 使用日志：https://infinitex.pro/usage-logs/common
- 任务日志：https://infinitex.pro/usage-logs/task
- 可用性检测：https://infinitex.pro/status
- 可用渠道：https://infinitex.pro/available-channels
- 模型广场：https://infinitex.pro/pricing
排查顺序
- 先确认域名和 endpoint：API 应访问
https://api.infinitex.pro/v1下的实际路径，不能使用文档域名或旧控制台路径。 - 判断请求是否到达服务：按时间查使用日志。没有记录时优先检查 DNS、代理、TLS、Base URL、客户端初始化和本机网络。
- 按状态码处理鉴权：
401检查 Key 和 Header；403检查 IP、模型、分组和账号权限。 - 重新发现模型：用同一个 Key 请求
/v1/models，再核对模型广场、可用渠道和状态页。 - 检查预算与限流：同时核对钱包、Key 有限额度、请求并发和
429重试行为。 - 区分同步与异步：有任务 ID或媒体任务状态时查任务日志；客户端超时不等于任务已停止。
- 收集最小证据：记录时间、客户端版本、Base URL、endpoint、状态码、模型、request ID或任务 ID。
常见错误与分类检查表
| 类别 | 典型现象 | 用户可执行检查 |
|---|---|---|
| 登录/权限 | 控制台反复回登录页、403 | 重新登录普通用户账号；确认未进入管理员入口；检查账号状态 |
| API 密钥 | 401 | Header 名、Bearer 格式或 x-api-key、到期、禁用、撤销状态 |
| 分组 | 模型不可见、无可用路线 | Key 分组是否与可用渠道和模型广场一致 |
| 模型/endpoint | 400、404、协议错误 | 重新请求 /v1/models；核对 Chat、Responses 或 Messages 路径 |
| 渠道 | 同一模型间歇失败 | 查看可用渠道与状态页，保留 request ID，不自行猜内部渠道 |
| 额度/订阅 | 余额或配额不足 | 核对钱包和 Key 有限额度；生产当前无订阅入口，不按旧订阅教程排查 |
| 价格 | 费用与估算不一致 | 核对实时价格、输入/输出/缓存 Token、endpoint 和日志详情 |
| 限流 | 429 | 降低并发，指数退避，避免无限自动重试 |
| 上游 | 5xx 或服务错误 | 查状态页与 request ID；短暂退避后仅重试最小请求 |
| 网络 | 无日志、连接/TLS/DNS 错误 | 检查本机代理、DNS、证书时间、API 域名和企业网络策略 |
| 异步任务 | 客户端超时、任务等待 | 查任务日志与任务 ID，不因超时重复提交 |
成功结果
你能把问题归入一个具体层级，并获得 request ID或任务 ID；最小复现材料不含凭据和用户数据。
仍无法解决时提供什么
- 发生时间与时区；
- 客户端名称和版本；
- Base URL 与 endpoint（不带 Key、query secret）；
- HTTP 状态码和简短错误类型；
- 模型名、request ID或任务 ID；
- 是否能在状态页、可用渠道和
/v1/models看到对应能力。
安全与计费影响
每次最小复现仍可能计费。不要为“看看会不会好”无限重试；不要发送完整请求/响应、Key、Cookie、真实余额或用户身份信息。
下一步
查看状态、支持与问题反馈，凭 request ID向当前生产公告公布的支持入口反馈。
最后更新于