@elizaos/plugin-openrouter 1.3.1 → 1.5.13

package/README.md

@@ -24,6 +24,7 @@ The plugin requires the OpenRouter API key and can be configured via environment
   "OPENROUTER_LARGE_MODEL": "google/gemini-pro", // Optional: Overrides default large model
   "OPENROUTER_IMAGE_MODEL": "x-ai/grok-2-vision-1212", // Optional: Overrides default image model
     "OPENROUTER_IMAGE_GENERATION_MODEL": "google/gemini-2.5-flash-image-preview", // Optional: Overrides default image generation model
+  "OPENROUTER_BROWSER_BASE_URL": "https://your-proxy.example.com/openrouter"
   // Fallbacks if specific OPENROUTER models are not set
   "SMALL_MODEL": "google/gemini-flash",
   "LARGE_MODEL": "google/gemini-pro",
@@ -42,6 +43,8 @@ OPENROUTER_SMALL_MODEL=google/gemini-flash
 OPENROUTER_LARGE_MODEL=google/gemini-pro
 OPENROUTER_IMAGE_MODEL=x-ai/grok-2-vision-1212
 OPENROUTER_IMAGE_GENERATION_MODEL=google/gemini-2.5-flash-image-preview
+# Browser proxy (frontend builds only)
+OPENROUTER_BROWSER_BASE_URL=https://your-proxy.example.com/openrouter
 # Fallbacks if specific OPENROUTER models are not set
 SMALL_MODEL=google/gemini-flash
 LARGE_MODEL=google/gemini-pro
@@ -53,6 +56,35 @@ IMAGE_GENERATION_MODEL=google/gemini-2.5-flash-image-preview
 
 - `OPENROUTER_API_KEY` (required): Your OpenRouter API key.
 - `OPENROUTER_BASE_URL`: Custom API endpoint (default: https://openrouter.ai/api/v1).
+- `OPENROUTER_BROWSER_BASE_URL`: Browser-only base URL to a proxy endpoint that forwards requests to OpenRouter without exposing keys.
+### Browser mode and proxying
+
+When bundled for the browser, this plugin avoids sending Authorization headers. Set `OPENROUTER_BROWSER_BASE_URL` to a server-side proxy you control that injects the OpenRouter API key. This prevents exposing secrets in frontend builds.
+
+Example minimal proxy (Express):
+
+```ts
+import express from 'express';
+import fetch from 'node-fetch';
+
+const app = express();
+app.use(express.json());
+
+app.post('/openrouter/*', async (req, res) => {
+  const url = `https://openrouter.ai/api/v1/${req.params[0]}`;
+  const r = await fetch(url, {
+    method: 'POST',
+    headers: {
+      'Authorization': `Bearer ${process.env.OPENROUTER_API_KEY}`,
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify(req.body),
+  });
+  res.status(r.status).set(Object.fromEntries(r.headers)).send(await r.text());
+});
+
+app.listen(3000);
+```
 - `OPENROUTER_SMALL_MODEL`: Specific model to use for `TEXT_SMALL` and `OBJECT_SMALL`. Overrides `SMALL_MODEL` if set.
 - `OPENROUTER_LARGE_MODEL`: Specific model to use for `TEXT_LARGE` and `OBJECT_LARGE`. Overrides `LARGE_MODEL` if set.
 - `OPENROUTER_IMAGE_MODEL`: Specific model to use for `IMAGE_DESCRIPTION`. Overrides `IMAGE_MODEL` if set.