← 返回首页

阿里云百炼 API 额度查询踩坑记录

2026-08-29

今天使用 API 工具时发现一条请求报错：查询额度接口返回 404。记录一下排查过程，避免以后再踩。

现象

客户端向 https://dashscope.aliyuncs.com/compatible-mode/v1/credits 发起 GET 请求，返回 404（空响应体）。

排查过程

1. 确认不是网络问题：请求能到达阿里云（返回 404 而非超时），说明服务器在线、域名解析正常。

2. 查阅阿里云官方文档：compatible-mode/v1 路径下没有 credits 查询接口——该路径只用于模型调用（OpenAI 兼容模式）。

3. 额度查询需要走专门的计费接口：

https://dashscope.aliyuncs.com/v1/credits

（不带 compatible-mode 前缀）

结论与经验

• 404 的原因是请求路径错误，不是 API Key 问题，也不是服务故障
• compatible-mode/v1 仅用于模型调用，额度查询要用 /v1/credits
• 这类报错不影响主要功能；查询余额建议直接去云控制台，最准确

小结

遇到 404 先别慌：确认路径是否正确、是否走错了接口版本，再排查 Key 和服务。很多时候只是"敲错了门"。