请输入
菜单

常见问题自查方法

遇到问题时,按照以下步骤自查,大多数常见报错都可以快速定位。

⚡ 快速自查清单

在联系客服之前,先过一遍这个清单,90% 的问题都能在这里找到原因:

最常见的原因:
- Key 与 Base URL 必须配套使用:不能用平台令牌调用官方地址,也不能用官方 key 调用我们的地址(ailink.nativex.com)
- Key 请完整复制:注意头尾是否带有多余空格,缺少字符会导致 401
- 模型名称请逐字核对:拼写错误或使用了平台不支持的模型名会返回 404 / 无可用渠道
- 令牌和账户额度相互独立:账户余额充足时,若令牌设置了用量上限且已用完,同样会报额度不足;请分别检查「账户余额」和「令牌剩余额度」
- 令牌状态:在控制台「令牌」页面确认令牌未被禁用、未过期

额度计算公式:
消耗额度 = 分组倍率 × 模型倍率 × (提示 token 数 + 补全 token 数 × 补全倍率)
GPT-3.5 补全倍率固定为 1.33,GPT-4 固定为 2。

🔍 自查步骤

按顺序排查,越靠前的越常见:

1. 查看报错码,对应处理

根据下方「状态码速查表」找到对应的错误码,按照建议处理。

2. 尝试示例代码,验证基础连通性

用最简单的 curl 示例代码测试,排除业务代码本身的问题:

curl https://ailink.nativex.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的令牌Key" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "hi"}]
  }'

如果示例代码能跑通,问题在你的业务代码里;如果也报错,继续往下查。

3. 更换模型,确认是否模型特定问题

用其他模型(如 gpt-4o-mini)替换当前模型重试。如果换模型就好了,说明原模型可能暂时不可用或你的令牌没有该模型权限。

4. 新建令牌 Key,排除令牌本身问题

在控制台新建一个临时令牌,用新 Key 重试。如果新 Key 能跑通,原令牌可能已过期、被禁用或额度耗尽。

5. 检查余额和令牌额度

•进入控制台「钱包」页面,确认账户余额充足
•进入「令牌」页面,确认令牌剩余额度大于 0,且未过期
最近修改: 2026-10-27