- 文档
- 支持
- 常见问题与错误码
常见问题与错误码
请求失败时，先按错误码查。这里没有你的问题的话，请发邮件到 support@airoutly.com，并附上错误消息里的请求 ID。
错误码
| 状态码 · code | 原因 | 处理方法 |
|---|---|---|
| 400 | 请求体格式有误，或模型不接受某个参数。 | 查看 message，去掉模型不支持的参数。 |
| 401 | Key 错误、已禁用、已过期或超出额度上限。 | 重新复制 Key（注意空格），到 API Key 页面检查状态。 |
403insufficient_user_quota | 余额不足以支付这次请求。 | 在控制台充值。 |
| 429 | 短时间内请求过多。 | 按指数退避重试。 |
503model_not_found | 这个模型 ID 在 Airoutly 上不可用。 | 从模型页复制准确的 ID，区分大小写。 |
| 500 · 502 · 504 | 上游模型出错或超时。 | 重试；长输出请使用流式。 |
账号与 Key
一个 Key 能在所有工具里用吗？
可以。同一个 Key 能调用所有模型、所有协议，用在所有工具里。只有想分别设置额度上限或分开查看用量时，才需要多建几个 Key。
收不到验证邮件
先检查垃圾邮件，再等两分钟后重新获取。邮件发件人是 no-reply@mail.airoutly.com。仍然没有的话，请写信到 support@airoutly.com。
Key 泄露了怎么办？
立即在 API Key 页面删除它，再新建一个。删除后旧 Key 马上失效。
计费
怎么计费？
按 token 计费，价格以模型页为准，从美元预充值余额中扣除。命中缓存的输入按更低的缓存读取价计费。每次请求的明细都在用量日志里。
赠金和余额按什么顺序扣？
先扣兑换码赠金，多份赠金按到期时间从早到晚扣；赠金不够的部分再扣余额。
调用
该用哪个 Base URL？
OpenAI SDK 与工具：https://api.airoutly.com/v1；Anthropic SDK 与 Claude Code：https://api.airoutly.com；Gemini SDK：https://api.airoutly.com/v1beta。
长请求超时
非流式请求超过约两分钟可能在边缘节点超时。请开启流式，流式响应不受影响。