遇到问题时,按照以下步骤自查,大多数常见报错都可以快速定位。
⚡ 快速自查清单
在联系客服之前,先过一遍这个清单,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,且未过期