错误处理

接入时请同时查看 HTTP 状态码、响应体错误信息、客户端日志和控制面板用量记录。

请求地址

排查前先确认实际请求地址属于 AIDMX：

https://ai.aidmx.xyz/v1

认证

所有需要认证的接口都应携带：

Authorization: Bearer $AIDMX_API_KEY
Content-Type: application/json

参数

常见错误与参数关系：

状态	常见原因	建议处理
400	JSON 不合法、缺少必填字段、参数不被接口接受	用最小请求复现，再逐项增加参数。
401	未提供 API Key、Key 无效、Bearer 格式错误	重新复制密钥，确认请求头格式。
403	账号、密钥、权限、余额或模型访问条件不满足	查看控制面板中的账号状态、余额和模型可用性。
404	路径错误、模型名称不可用	检查 Base URL、接口路径和模型名。
429	超出频率、并发、额度或资源限制	降低请求速率，按控制面板显示调整。
5xx	服务端或上游临时异常	记录请求时间和错误信息，稍后重试或联系支持。

示例

curl -i https://ai.aidmx.xyz/v1/chat/completions \
-H "Authorization: Bearer $AIDMX_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"<model-from-panel>","messages":[{"role":"user","content":"ping"}]}'

使用 -i 可以同时看到响应头和状态码，便于定位认证、路径和限速问题。

错误

如果响应中包含错误对象，请优先保留 message、type、code、请求时间、接口路径和模型名称。联系支持时不要发送完整 API Key。

计费说明

失败请求是否计量取决于请求是否进入模型处理流程。最终账单、价格、模型额度和限速规则以控制面板实时显示为准。