错误码

{
  "messages": [
    {
      "role": "user",
      "content": "帮我写一个快速排序的单元测试"
    }
  ]
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "missing_required_parameter",
    "param": "model",
    "message": "Missing 'model'"
  },
  "request_id": "req-…"
}

{
  "model": "your-model",
  "messages": [
    {
      "role": "user",
      "content": "帮我写一个快速排序的单元测试"
    }
  ],
  "max_tokens": "8"
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_type",
    "param": "max_tokens",
    "message": "'max_tokens' must be an integer"
  },
  "request_id": "req-…"
}

{
  "model": "your-model",
  "messages": [
    {
      "role": "user",
      "content": "帮我写一个快速排序的单元测试"
    }
  ],
  "thinking": {
    "type": "deep-research",
    "budget_tokens": 8000
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_value",
    "param": "thinking.budget_tokens",
    "message": "thinking.budget_tokens requires thinking.type 'enabled'"
  },
  "request_id": "req-…"
}

{
  "model": "your-model",
  "messages": [
    {
      "role": "bot",
      "content": "帮我写一个快速排序的单元测试"
    }
  ]
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "enum_value",
    "param": "messages[0].role",
    "message": "'role' must be one of: system, developer, user, assistant, tool"
  },
  "request_id": "req-…"
}

{
  "model": "your-model",
  "messages": [
    {
      "role": "user",
      "content": "帮我写一个快速排序的单元测试"
    }
  ],
  "max_tool_calls": 0
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "integer_below_min_value",
    "param": "max_tool_calls",
    "message": "'max_tool_calls' must be an integer ≥ 1"
  },
  "request_id": "req-…"
}

{
  "model": "your-model",
  "messages": [
    {
      "role": "user",
      "content": "帮我写一个快速排序的单元测试"
    }
  ],
  "temperature": 2.5
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "number_out_of_range",
    "param": "temperature",
    "message": "'temperature' must be between 0.0 and 2.0"
  },
  "request_id": "req-…"
}

{
  "model": "your-model",
  "messages": []
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "array_empty",
    "param": "messages",
    "message": "'messages' must not be empty"
  },
  "request_id": "req-…"
}

{
  "model": "your-model",
  "messages": [
    {
      "role": "user",
      "content": "帮我写一个快速排序的单元测试"
    }
  ],
  "stop": [
    "END",
    "STOP",
    "###",
    "总结",
    "完"
  ]
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "array_above_max_items",
    "param": "stop",
    "message": "'stop' must hold at most 4 items"
  },
  "request_id": "req-…"
}

{
  "model": "your-model",
  "messages": [
    {
      "role": "user",
      "content": "帮我写一个快速排序的单元测试"
    }
  ],
  "stop": [
    "END",
    5
  ]
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "array_item_invalid",
    "param": "stop[1]",
    "message": "'stop[1]' must be a string"
  },
  "request_id": "req-…"
}

{
  "model": "your-model",
  "messages": [
    {
      "role": "user",
      "content": "帮我写一个快速排序的单元测试"
    }
  ],
  "thinking": {
    "type": "enabled",
    "budget_tokens": 8000
  },
  "output_config": {
    "effort": "high"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "mutually_exclusive",
    "param": "output_config.effort",
    "message": "'output_config.effort' and 'thinking' are mutually exclusive; declare one"
  },
  "request_id": "req-…"
}

{
  "model": "your-model",
  "messages": [
    {
      "role": "user",
      "content": "帮我写一个快速排序的单元测试"
    }
  ],
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "__search",
        "description": "在知识库里检索文档"
      }
    }
  ]
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "reserved_value",
    "param": "tools[0].function.name",
    "message": "Tool name must not use the reserved prefix '__': __search"
  },
  "request_id": "req-…"
}

{
  "model": "your-model",
  "messages": [
    {
      "role": "user",
      "content": "帮我写一个快速排序的单元测试"
    }
  ],
  "mcp_servers": [
    {
      "type": "url",
      "url": "https://mcp.example.net/sse"
    }
  ]
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "unsupported_parameter",
    "param": "mcp_servers",
    "message": "Client-declarable MCP tools are not supported; hosted tools are defined server-side (docs/unsupported-features.md)"
  },
  "request_id": "req-…"
}

curl https://api.model-r.com/v1/chat/completions \
  -H "Authorization: Bearer mr-…" \
  -H "Content-Type: application/json" \
  -d '[{"role": "user", "content": "帮我写一个快速排序的单元测试"}]'

{
  "error": {
    "type": "invalid_request_error",
    "code": "malformed_json",
    "message": "Request body must be a JSON object"
  },
  "request_id": "req-…"
}

{
  "model": "your-model",
  "previous_response_id": "resp_9f8e7d6c"
}

{
  "error": {
    "type": "not_found_error",
    "code": "previous_response_not_found",
    "param": "previous_response_id",
    "message": "The referenced conversation is not held by this deployment (it expired, was evicted, or was created elsewhere)"
  },
  "request_id": "req-…"
}

curl https://api.model-r.com/v1/chat/completions \
  -H "Authorization: Bearer mr-not-a-valid-key" \
  -H "Content-Type: application/json" \
  -d '{"model": "your-model", "messages": [{"role": "user", "content": "帮我写一个快速排序的单元测试"}]}'

{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "Invalid API key provided."
  },
  "request_id": "req-…"
}

{
  "model": "your-model",
  "messages": [
    {
      "role": "user",
      "content": "帮我写一个快速排序的单元测试"
    }
  ]
}

{
  "error": {
    "type": "permission_error",
    "code": "alias_not_granted",
    "message": "The presented key was not granted the requested alias."
  },
  "request_id": "req-…"
}

curl https://api.model-r.com/v1/chat/completions \
  -H "Host: api.wrong-host.example" \
  -H "Authorization: Bearer mr-…" \
  -d '{"model": "your-model", "messages": [{"role": "user", "content": "帮我写一个快速排序的单元测试"}]}'

{
  "error": {
    "type": "not_found_error",
    "code": "undeclared_host",
    "message": "No access endpoint is declared for host 'api.wrong-host.example'."
  },
  "request_id": "req-…"
}

{
  "error": {
    "type": "permission_error",
    "code": "insufficient_balance",
    "message": "The account's balance is negative; recharge to resume requests."
  },
  "request_id": "req-…"
}

{
  "model": "no-such-model",
  "messages": [
    {
      "role": "user",
      "content": "帮我写一个快速排序的单元测试"
    }
  ]
}

{
  "error": {
    "type": "not_found_error",
    "code": "model_not_found",
    "param": "model",
    "message": "No route is configured for model 'no-such-model'"
  },
  "request_id": "req-…"
}

{
  "error": {
    "type": "permission_error",
    "code": "access_restricted",
    "message": "This account has been disabled by the operator; contact the operator to resume requests."
  },
  "request_id": "req-…"
}

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded for window 'per-minute' (60 requests per 60 seconds); wait the Retry-After delay and retry"
  },
  "request_id": "req-…"
}