Errors

• 调用 https://api-direct.dimilinks.com/v1/*（OpenAI 兼容）的接口，错误使用 OpenAI 风格 error 包装。
• 调用 https://api-direct.dimilinks.com/v1/messages（Anthropic 原生）的接口，错误使用 Anthropic 原生格式 {"type":"error","error":{...}}。

{
  "error": {
    "message": "prompt 不能为空",
    "type": "invalid_request_error",
    "code": "invalid_request_error"
  }
}

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "messages 不能为空"
  }
}

​

常见错误

​

处理建议

• 400 把 error.message 直接展示给用户，便于调整输入。
• 401 / 403 提示检查密钥或模型权限，不要静默重试。
• 429 建议指数退避，并降低并发；不要立即高频重试。
• 5xx / 502 / 503 可允许用户重试，但要记录日志便于排查上游。
• 任务接口返回 404 时立即停止轮询，避免浪费请求。
• 同一段业务代码如果同时调用两种协议，建议在 HTTP 客户端里统一抽象「读 error.message 或 error.error.message」，避免每个调用方各写一遍兼容逻辑。