Bearer 认证
在每个请求中发送 Authorization: Bearer YOUR_API_KEY。API Key 只能保存在服务端环境变量或密钥管理服务中，不能放入浏览器、移动端应用或公开仓库。
cURL 认证请求头
curl https://api.mindon.fun/v1/models \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"错误响应
错误响应通常包含 error 对象，其中会提供消息、类型或代码。请保留响应正文和请求 ID，便于排查。
| 状态 | 含义 | 处理方式 |
|---|---|---|
| 400 | 请求、模型或参数不支持 | 检查端点、模型 ID 和请求正文。 |
| 401 | Key 缺失或无效 | 在控制台创建或替换 Key。 |
| 402 | 额度不足 | 联系 MindOn 或补充账户额度。 |
| 429 | 请求触发限流 | 使用指数退避并降低并发。 |
| 5xx | 网关或提供商失败 | 重试幂等查询；保留请求 ID 并联系支持。 |
排障顺序
- 用 cURL 复现问题，排除 SDK 或客户端封装影响。
- 请求
GET /v1/models，确认模型 ID 当前可用。 - 在控制台日志中检查状态码、错误正文和请求详情。
- 联系支持时提供发生时间、模型 ID 和请求 ID。