add openrouter compat client

Author: leafo

README.md

@@ -524,6 +524,26 @@ end
 See the `examples/gemini/` directory for more examples including structured
 output with JSON schemas.
 
+## Using with OpenRouter
+
+[OpenRouter](https://openrouter.ai/) provides access to many AI models through a
+unified API. This library includes an `OpenRouter` client that uses their
+[OpenAI-compatible endpoint](https://openrouter.ai/docs/quickstart).
+
+```lua
+local OpenRouter = require("openai.compat.openrouter")
+local client = OpenRouter.new(os.getenv("OPENROUTER_API_KEY"))
+
+local status, response = client:create_chat_completion({
+  {role = "user", content = "Hello, how are you?"}
+}, {
+  model = "anthropic/claude-sonnet-4" -- default model is openai/gpt-4.1
+})
+```
+
+The `OpenRouter` client extends `OpenAI` and supports all the same methods
+including chat completions, chat sessions, and streaming.
+
 ## Appendix
 
 ### Chat Session With Functions

lua-openai-dev-1.rockspec

@@ -20,12 +20,13 @@ dependencies = {
   "luasec",
 }
 build = {
-   type = "builtin",
-   modules = {
-      ["openai"] = "openai/init.lua",
-      ["openai.sse"] = "openai/sse.lua",
-      ["openai.chat_completions"] = "openai/chat_completions.lua",
-      ["openai.responses"] = "openai/responses.lua",
-      ["openai.compat.gemini"] = "openai/compat/gemini.lua"
-   }
+  type = "builtin",
+  modules = {
+    ["openai.chat_completions"] = "openai/chat_completions.lua",
+    ["openai.compat.gemini"] = "openai/compat/gemini.lua",
+    ["openai.compat.openrouter"] = "openai/compat/openrouter.lua",
+    ["openai"] = "openai/init.lua",
+    ["openai.responses"] = "openai/responses.lua",
+    ["openai.sse"] = "openai/sse.lua",
+  }
 }

openai/compat/openrouter.lua

@@ -0,0 +1,47 @@
+local OpenAI
+OpenAI = require("openai").OpenAI
+local OpenRouter
+do
+  local _class_0
+  local _parent_0 = OpenAI
+  local _base_0 = {
+    api_base = "https://openrouter.ai/api/v1",
+    default_model = "openai/gpt-4.1"
+  }
+  _base_0.__index = _base_0
+  setmetatable(_base_0, _parent_0.__base)
+  _class_0 = setmetatable({
+    __init = function(self, ...)
+      return _class_0.__parent.__init(self, ...)
+    end,
+    __base = _base_0,
+    __name = "OpenRouter",
+    __parent = _parent_0
+  }, {
+    __index = function(cls, name)
+      local val = rawget(_base_0, name)
+      if val == nil then
+        local parent = rawget(cls, "__parent")
+        if parent then
+          return parent[name]
+        end
+      else
+        return val
+      end
+    end,
+    __call = function(cls, ...)
+      local _self_0 = setmetatable({}, _base_0)
+      cls.__init(_self_0, ...)
+      return _self_0
+    end
+  })
+  _base_0.__class = _class_0
+  if _parent_0.__inherited then
+    _parent_0.__inherited(_parent_0, _class_0)
+  end
+  OpenRouter = _class_0
+end
+return {
+  OpenRouter = OpenRouter,
+  new = OpenRouter
+}

openai/compat/openrouter.moon

@@ -0,0 +1,10 @@
+-- OpenRouter client using OpenAI compatibility layer
+-- https://openrouter.ai/docs/quickstart
+
+import OpenAI from require "openai"
+
+class OpenRouter extends OpenAI
+  api_base: "https://openrouter.ai/api/v1"
+  default_model: "openai/gpt-4.1"
+
+{:OpenRouter, new: OpenRouter}