API 排错
Last updated on
从 Key、Base URL、模型名、额度这几个最常见位置开始排查。
先知道这一页要做什么
这一页只做一件事：当你的 API 调用不正常时，按最短顺序把最常见的问题先排掉。
默认就按这个顺序查
1. 先查 API Key 有没有问题
优先确认这几件事：
- 你是不是已经在
api.dingjiai.com创建了 Key - 你复制到工具或项目里的 Key 有没有少字、多空格、贴错位置
- 你是不是把旧 Key、无效 Key 或别的站点的 Key 混进来了
如果这里有问题，后面继续查 Base URL 和模型名通常也不会通。
2. 再查 Base URL / 接口地址
很多请求失败，不是模型坏了，而是地址配错了。
尤其是在第三方工具里，先确认：
- 这个工具是不是要求你填写 Base URL
- 你填的是不是当前 API 路线该使用的地址
- 地址有没有多
/v1、少/v1，或者路径抄错
3. 再查模型名和请求配置
如果 Key 和地址都正常，再看：
- 模型名是不是写错了
- 当前工具或 SDK 是否支持你填的模型写法
- 请求参数有没有和当前工具要求冲突
第一次接入时，最稳的做法不是一上来堆复杂参数，而是先用最小请求跑通。
4. 最后查额度、余额和限制
如果前面都没问题，再回到 api.dingjiai.com 看：
- 你是不是已经充值
- 当前额度是不是够用
- 有没有因为余额不足或限制导致请求失败
这类问题，本质上不是代码写法问题，而是额度状态问题。
第一次排错时，最容易犯的错
- 还没创建 Key，就先怀疑 SDK 有问题
- Base URL 抄错了，却一直改模型名
- 还没做最小请求测试，就先上复杂脚本
- 明明是额度问题，却一直反复改代码