From 60b8bccd374172b6c1d587cef0375e03c92ac1e1 Mon Sep 17 00:00:00 2001
From: "Paul Gauthier (aider)" <paul@aider.chat>
Date: Mon, 27 Jan 2025 16:45:00 -0800
Subject: [PATCH] feat: Add documentation for controlling OpenRouter provider
 selection in model settings

---
 aider/website/docs/llms/openrouter.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/aider/website/docs/llms/openrouter.md b/aider/website/docs/llms/openrouter.md
index 20888a33c..94849ae05 100644
--- a/aider/website/docs/llms/openrouter.md
+++ b/aider/website/docs/llms/openrouter.md
@@ -39,5 +39,24 @@ If you get errors, check your
 Be sure to "enable providers that may train on inputs"
 to allow use of all models.
 
+## Controlling provider selection
+
+You can control which OpenRouter providers are used by creating a `.aider.model.settings.yml` file in your home directory or project root. For example:
+
+```yaml
+- name: openrouter/anthropic/claude-3.5-sonnet
+  extra_params:
+    provider:
+      # Only use these providers, in this order
+      order: ["Anthropic", "Together"]
+      # Don't fall back to other providers
+      allow_fallbacks: false
+      # Skip providers that may train on inputs
+      data_collection: "deny"
+      # Only use providers supporting all parameters
+      require_parameters: true
+```
+
+See [OpenRouter's provider routing docs](https://openrouter.ai/docs/provider-routing) for full details on these settings.