错误处理

常见错误可以按“请求是否到达 XAI.KG”分两类。

没有到达 XAI.KG

使用日志里没有记录时，优先检查：

• Base URL 是否填成 https://api.xai.kg/v1。
• 客户端是否仍在请求 api.openai.com。
• 代理或网络是否拦截。
• 端点是否重复拼接 /v1。

已到达但失败

错误	常见原因	处理方式
401 Unauthorized	Token 未填、错误、过期或被禁用	重新复制 Token，确认 Bearer 格式
403 Forbidden	账户状态、权限或用户组限制	检查账户组和模型权限
model not found	模型名错误或当前账户不可用	到模型广场核对模型名，并用短流式请求验证
insufficient balance	余额或额度不足	检查钱包和充值状态
rate limit	请求过快或并发过高	降低并发，增加重试退避
上游错误	渠道异常或模型暂时不可用	稍后重试或切换模型

推荐排查请求

curl -N https://api.xai.kg/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      { "role": "user", "content": "Reply exactly: pong" }
    ],
    "stream": true
  }'