@providerkit/core 0.8.1 → 0.10.0

package/src/presets.ts

@@ -37,9 +37,11 @@ export type PresetAuth = "key" | "bearer" | "oauth";
 export interface ProviderPreset {
   /** Adapter wire format. */
   shape: PresetShape;
-  /** API root — the adapter appends its own path (/v1/chat/completions,
-   *  /v1/messages, …), so this must NOT carry the version. */
+  /** API root — if it ends with /v1, /v4 or another version segment, the
+   *  adapter automatically routes to /chat/completions instead of /v1/chat/completions. */
   baseUrl: string;
+  /** Explicit path override when a gateway has custom routing. */
+  path?: string;
   auth: PresetAuth;
   /** Fallback when the caller passes no model. */
   defaultModel?: string;
@@ -65,15 +67,15 @@ export const PROVIDER_PRESETS = {
     shape: "anthropic",
     baseUrl: "https://api.anthropic.com",
     auth: "key",
-    defaultModel: "claude-sonnet-4-6",
-    models: ["claude-sonnet-4-6", "claude-opus-5", "claude-fable-5-1"],
+    defaultModel: "claude-sonnet-5",
+    models: ["claude-sonnet-5", "claude-opus-5", "claude-fable-5-1", "claude-haiku-4-5"],
   },
   openai: {
     shape: "openai",
     baseUrl: "https://api.openai.com",
     auth: "key",
     defaultModel: "gpt-5.6-sol",
-    models: ["gpt-5.6-sol", "gpt-5-pro", "gpt-5-nano"],
+    models: ["gpt-5.6-sol", "gpt-5.5-pro", "gpt-5.4-mini"],
   },
   google: {
     // Native Generative Language REST — the adapter authenticates with
@@ -81,8 +83,8 @@ export const PROVIDER_PRESETS = {
     shape: "gemini",
     baseUrl: "https://generativelanguage.googleapis.com",
     auth: "key",
-    defaultModel: "gemini-3.1-pro",
-    models: ["gemini-3.1-pro", "gemini-2.5-flash"],
+    defaultModel: "gemini-3.1-pro-preview",
+    models: ["gemini-3.1-pro-preview", "gemini-3.8-flash", "gemini-flash-latest"],
   },
   /** Gemini behind its OpenAI-compatible route — the drop-in for codebases
    *  that only speak the openai shape. */
@@ -90,15 +92,17 @@ export const PROVIDER_PRESETS = {
     shape: "openai",
     baseUrl: "https://generativelanguage.googleapis.com/v1beta/openai",
     auth: "key",
-    defaultModel: "gemini-3.1-pro",
-    models: ["gemini-3.1-pro", "gemini-2.5-flash"],
+    defaultModel: "gemini-3.1-pro-preview",
+    models: ["gemini-3.1-pro-preview", "gemini-3.8-flash", "gemini-flash-latest"],
   },
   deepseek: {
     shape: "openai",
     baseUrl: "https://api.deepseek.com",
     auth: "key",
-    defaultModel: "deepseek-v4-flash",
-    models: ["deepseek-v4-flash", "deepseek-v4-pro", "deepseek-flash"],
+    // Measured 2026-09-13 via /models on live key: first-party serves only
+    // deepseek-flash and deepseek-v4-pro. v4.1-flash is OpenRouter/Baseten.
+    defaultModel: "deepseek-flash",
+    models: ["deepseek-flash", "deepseek-v4-pro"],
     // Text-only API — an image part in the body is a hard 400 (measured).
     textOnly: true,
   },
@@ -107,7 +111,7 @@ export const PROVIDER_PRESETS = {
     baseUrl: "https://openrouter.ai/api",
     auth: "key",
     defaultModel: "deepseek/deepseek-v4.1-flash",
-    models: ["deepseek/deepseek-v4.1-flash", "z-ai/glm-5.3-flash", "qwen/qwen3.7-max"],
+    models: ["deepseek/deepseek-v4.1-flash", "z-ai/glm-5.3-flash", "x-ai/grok-4.6", "openai/gpt-5.6-luna-pro"],
   },
   groq: {
     shape: "openai",
@@ -121,25 +125,28 @@ export const PROVIDER_PRESETS = {
     baseUrl: "https://api.mistral.ai/v1",
     auth: "key",
     defaultModel: "devstral-2512",
-    models: ["devstral-2512", "magistral-small", "mistral-small-2506"],
+    models: ["devstral-2512", "mistral-large-latest", "magistral-small"],
   },
   xai: {
     shape: "openai",
     baseUrl: "https://api.x.ai/v1",
     auth: "key",
-    defaultModel: "grok-4.5",
-    models: ["grok-4.5", "grok-4.3", "grok-4.20-0309-reasoning"],
+    defaultModel: "grok-4.6",
+    models: ["grok-4.6", "grok-4.5", "grok-4.3"],
   },
   together: {
     shape: "openai",
     baseUrl: "https://api.together.xyz/v1",
     auth: "key",
-    defaultModel: "deepseek-ai/DeepSeek-V3",
+    defaultModel: "MiniMaxAI/MiniMax-M3",
+    models: ["MiniMaxAI/MiniMax-M3", "Qwen/Qwen3-Coder-Next-FP8"],
   },
   fireworks: {
     shape: "openai",
     baseUrl: "https://api.fireworks.ai/inference/v1",
     auth: "key",
+    defaultModel: "accounts/fireworks/models/deepseek-v4p1-flash",
+    models: ["accounts/fireworks/models/deepseek-v4p1-flash", "accounts/fireworks/models/glm-5p3-flash"],
   },
   cerebras: {
     shape: "openai",
@@ -158,16 +165,119 @@ export const PROVIDER_PRESETS = {
   zhipu: {
     shape: "openai",
     baseUrl: "https://api.z.ai/api/paas/v4",
+    path: "/chat/completions",
     auth: "key",
     defaultModel: "glm-5.3-flash",
-    models: ["glm-5.3-flash", "glm-5.2", "glm-4.7"],
+    models: ["glm-5.3-flash", "glm-5.3", "glm-5.2"],
   },
   minimax: {
     shape: "anthropic",
     baseUrl: "https://api.minimax.io/anthropic",
     auth: "key",
-    defaultModel: "MiniMax-M2.5",
-    models: ["MiniMax-M3", "MiniMax-M2.5", "MiniMax-M2.1"],
+    defaultModel: "MiniMax-M3",
+    models: ["MiniMax-M3", "MiniMax-M2.7", "MiniMax-M2.5"],
+  },
+  "minimax-openai": {
+    shape: "openai",
+    baseUrl: "https://api.minimax.io/v1",
+    auth: "key",
+    defaultModel: "MiniMax-M3",
+    models: ["MiniMax-M3", "MiniMax-M2.7", "MiniMax-M2.5"],
+  },
+
+  // ── Popular gateways & cloud providers ──────────────────────────────────
+  nvidia: {
+    shape: "openai",
+    baseUrl: "https://integrate.api.nvidia.com/v1",
+    auth: "key",
+    defaultModel: "deepseek-ai/deepseek-v4-flash",
+    models: ["deepseek-ai/deepseek-v4-flash", "deepseek-ai/deepseek-v4-pro"],
+  },
+  perplexity: {
+    shape: "openai",
+    baseUrl: "https://api.perplexity.ai",
+    auth: "key",
+    defaultModel: "sonar",
+    models: ["sonar", "sonar-pro", "sonar-reasoning-pro", "sonar-deep-research"],
+  },
+  deepinfra: {
+    shape: "openai",
+    baseUrl: "https://api.deepinfra.com/v1/openai",
+    path: "/chat/completions",
+    auth: "key",
+    defaultModel: "MiniMaxAI/MiniMax-M3",
+    models: ["MiniMaxAI/MiniMax-M3", "ByteDance/Seed-2.0-pro"],
+  },
+  nebius: {
+    shape: "openai",
+    baseUrl: "https://api.tokenfactory.nebius.com/v1",
+    auth: "key",
+    defaultModel: "Qwen/Qwen3.5-397B-A17B",
+    models: ["Qwen/Qwen3.5-397B-A17B", "deepseek-ai/DeepSeek-V4-Flash-0731"],
+  },
+  novita: {
+    shape: "openai",
+    baseUrl: "https://api.novita.ai/openai",
+    path: "/v1/chat/completions",
+    auth: "key",
+    defaultModel: "baichuan/baichuan-m2-32b",
+    models: ["baichuan/baichuan-m2-32b", "baidu/ernie-4.5-300b-a47b-paddle"],
+  },
+  chutes: {
+    shape: "openai",
+    baseUrl: "https://llm.chutes.ai/v1",
+    auth: "key",
+    defaultModel: "Qwen/Qwen3.8-27B-TEE",
+    models: ["Qwen/Qwen3.8-27B-TEE", "Qwen/Qwen3.5-397B-A17B-TEE"],
+  },
+  siliconflow: {
+    shape: "openai",
+    baseUrl: "https://api.siliconflow.com/v1",
+    auth: "key",
+    defaultModel: "Qwen/Qwen3-235B-A22B-Thinking-2507",
+    models: ["Qwen/Qwen3-235B-A22B-Thinking-2507", "MiniMaxAI/MiniMax-M2.5"],
+  },
+  volcengine: {
+    shape: "openai",
+    baseUrl: "https://ark.cn-beijing.volces.com/api/v3",
+    auth: "key",
+    defaultModel: "doubao-seed-1-8-251228",
+    models: ["doubao-seed-1-8-251228", "deepseek-v4-flash-ga-260731"],
+  },
+  stepfun: {
+    shape: "openai",
+    baseUrl: "https://api.stepfun.com/v1",
+    auth: "key",
+    defaultModel: "step-3.7-flash",
+    models: ["step-3.7-flash", "step-3.5-flash"],
+  },
+  digitalocean: {
+    shape: "openai",
+    baseUrl: "https://inference.do-ai.run/v1",
+    auth: "key",
+    defaultModel: "anthropic-claude-3.7-sonnet",
+    models: ["anthropic-claude-3.7-sonnet", "alibaba-qwen3-32b"],
+  },
+  crusoe: {
+    shape: "openai",
+    baseUrl: "https://api.inference.crusoecloud.com/v1",
+    auth: "key",
+    defaultModel: "Qwen/Qwen3-235B-A22B-Instruct-2507",
+    models: ["Qwen/Qwen3-235B-A22B-Instruct-2507", "nvidia/NVIDIA-Nemotron-3-Super-120B-A12B"],
+  },
+  baseten: {
+    shape: "openai",
+    baseUrl: "https://inference.baseten.co/v1",
+    auth: "key",
+    defaultModel: "deepseek-ai/DeepSeek-V4.1-Flash",
+    models: ["deepseek-ai/DeepSeek-V4.1-Flash", "MiniMaxAI/MiniMax-M2.5"],
+  },
+  huggingface: {
+    shape: "openai",
+    baseUrl: "https://router.huggingface.co/v1",
+    auth: "key",
+    defaultModel: "MiniMaxAI/MiniMax-M3",
+    models: ["MiniMaxAI/MiniMax-M3", "Qwen/Qwen2.5-Coder-32B-Instruct"],
   },
 
   // ── Coding plans — Anthropic wire + Bearer (measured family trait) ─────
@@ -176,25 +286,40 @@ export const PROVIDER_PRESETS = {
     baseUrl: "https://api.z.ai/api/anthropic",
     auth: "bearer",
     defaultModel: "glm-5.3-flash",
-    models: ["glm-5.3-flash", "glm-5.3-highspeed", "glm-5.2", "glm-5-turbo"],
+    models: ["glm-5.3-flash", "glm-5.3-highspeed", "glm-5.3", "glm-5.2"],
     // Model ids are BARE here — the gateway-prefixed spelling
     // (`z-ai/glm-5.3-flash`) answers 400 [1211] Unknown Model.
     explicitNone: true,
   },
+  "zai-openai": {
+    shape: "openai",
+    baseUrl: "https://api.z.ai/api/paas/v4",
+    path: "/chat/completions",
+    auth: "key",
+    defaultModel: "glm-5.3-flash",
+    models: ["glm-5.3-flash", "glm-5.3", "glm-5.2"],
+  },
   kimi: {
     shape: "anthropic",
     baseUrl: "https://api.kimi.ai/coding",
     auth: "bearer",
     defaultModel: "kimi-for-coding",
-    models: ["kimi-for-coding", "kimi-for-coding-highspeed", "k3"],
+    models: ["kimi-for-coding", "kimi-for-coding-highspeed", "k3", "k3-256k"],
+  },
+  "kimi-openai": {
+    shape: "openai",
+    baseUrl: "https://api.moonshot.ai/v1",
+    auth: "key",
+    defaultModel: "kimi-k2.7-code",
+    models: ["kimi-k2.7-code", "kimi-k2.7-code-highspeed", "kimi-k3"],
   },
   /** Alibaba's dashscope coding plan — OpenAI-compatible per its registry. */
   "alibaba-coding-plan": {
     shape: "openai",
     baseUrl: "https://coding-intl.dashscope.aliyuncs.com/v1",
     auth: "bearer",
-    defaultModel: "qwen3.7-max",
-    models: ["qwen3.7-max", "qwen3-coder-next", "glm-4.7"],
+    defaultModel: "qwen3.5-plus",
+    models: ["qwen3.5-plus", "qwen3-coder-next", "glm-5"],
   },
   /** QwenCloud's token plan — Anthropic wire (measured by tabrunner). */
   qwen: {
@@ -202,7 +327,31 @@ export const PROVIDER_PRESETS = {
     baseUrl: "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
     auth: "bearer",
     defaultModel: "qwen3.8-max",
-    models: ["qwen3.8-max", "qwen3.6-flash"],
+    models: ["qwen3.8-max", "qwen3.8-flash", "qwen3.6-flash"],
+  },
+  /** QwenCloud's token plan — OpenAI-compatible endpoint. */
+  "qwen-token-plan-openai": {
+    shape: "openai",
+    baseUrl: "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
+    auth: "bearer",
+    defaultModel: "qwen3.8-max",
+    models: ["qwen3.8-max", "qwen3.8-flash", "qwen3.6-flash"],
+  },
+  /** Alibaba DashScope Platform API — standard pay-as-you-go API key. */
+  alibaba: {
+    shape: "openai",
+    baseUrl: "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
+    auth: "bearer",
+    defaultModel: "qwen-max",
+    models: ["qwen-max", "qwen-plus", "qwen-turbo", "qwen-flash"],
+  },
+  /** Alias for alibaba (DashScope platform API). */
+  "qwen-api": {
+    shape: "openai",
+    baseUrl: "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
+    auth: "bearer",
+    defaultModel: "qwen-max",
+    models: ["qwen-max", "qwen-plus", "qwen-turbo", "qwen-flash"],
   },
 
   // ── Local runtimes ──────────────────────────────────────────────────────
@@ -227,8 +376,8 @@ export const PROVIDER_PRESETS = {
     shape: "anthropic",
     baseUrl: "https://api.anthropic.com",
     auth: "oauth",
-    defaultModel: "claude-sonnet-4-6",
-    models: ["claude-sonnet-4-6", "claude-opus-5"],
+    defaultModel: "claude-sonnet-5",
+    models: ["claude-sonnet-5", "claude-opus-5", "claude-fable-5"],
     // The beta flag is what switches the API into OAuth-token mode (measured
     // by tabrunner's Claude plan sign-in).
     headers: { "anthropic-beta": "claude-code-20250219,oauth-2025-04-20" },
@@ -240,7 +389,7 @@ export const PROVIDER_PRESETS = {
     baseUrl: "https://chatgpt.com/backend-api/codex",
     auth: "oauth",
     defaultModel: "gpt-5.3-codex",
-    models: ["gpt-5.3-codex", "gpt-5.5", "gpt-5.4-mini"],
+    models: ["gpt-5.3-codex", "gpt-5.3-codex-spark", "gpt-5.5", "gpt-5.4-mini"],
   },
   /** Kimi's coding endpoint reached with a subscription token instead of a
    *  key — Kimi bills the two separately. */
@@ -255,7 +404,7 @@ export const PROVIDER_PRESETS = {
     baseUrl: "https://api.githubcopilot.com",
     auth: "oauth",
     defaultModel: "gpt-5.6-sol",
-    models: ["gpt-5.6-sol", "claude-opus-5", "claude-opus-4.8", "kimi-k2.7-code"],
+    models: ["gpt-5.6-sol", "claude-opus-5", "claude-sonnet-5", "gpt-6-astra"],
   },
 } as const satisfies Record<string, ProviderPreset>;
 

package/src/providers/anthropic.ts

@@ -1,6 +1,6 @@
 // Anthropic-shape adapter — SSE from POST /v1/messages.
 import { streamError } from "../errors.ts";
-import { schemaPrompt } from "../schema.ts";
+import { schemaPrompt, toAnthropicToolSchema } from "../schema.ts";
 import { parseToolArgs } from "../tool-args.ts";
 import { streamSse, apiUrl } from "../transport.ts";
 import { withConfiguredFallbacks, type ProviderFallbackConfig } from "../fallback.ts";
@@ -249,7 +249,7 @@ export function createAnthropicProvider(config: AnthropicConfig): Provider {
         request.tools = tools.map((tool) => ({
           name: tool.name,
           description: tool.description,
-          input_schema: tool.inputSchema,
+          input_schema: toAnthropicToolSchema(tool.inputSchema),
         }));
       }
       if (opts.toolChoice && opts.toolChoice !== "auto") {

package/src/providers/factory.ts

@@ -91,6 +91,7 @@ export function createPresetProvider(id: ProviderPresetId, config: PresetProvide
         effort: config.effort,
         maxTokens: config.maxTokens,
         baseUrl: preset.baseUrl,
+        ...(preset.path ? { path: preset.path } : {}),
         headers,
         ...(config.providerOrder ? { providerOrder: config.providerOrder } : {}),
         fetchImpl: config.fetchImpl,

package/src/providers/gemini.ts

@@ -6,7 +6,7 @@
 // wire rather than @google/genai, because this package ships zero dependencies
 // and the SDK is a Node-shaped one.
 import { streamError } from "../errors.ts";
-import { schemaPrompt } from "../schema.ts";
+import { schemaPrompt, toGeminiToolSchema } from "../schema.ts";
 import { parseToolArgs } from "../tool-args.ts";
 import { streamSse, apiUrl } from "../transport.ts";
 import { withConfiguredFallbacks, type ProviderFallbackConfig } from "../fallback.ts";
@@ -69,6 +69,19 @@ const THINKING_LEVEL: Record<Effort, string> = {
   max: "HIGH",
 };
 
+/**
+ * Gemini 2.x thinking budget dial (tokens).
+ * Gemini 2.5 uses `thinkingBudget` (0 disables thinking), while Gemini 3+ uses
+ * `thinkingLevel` (MINIMAL, LOW, MEDIUM, HIGH).
+ */
+const GEMINI_2_THINKING_BUDGET: Record<Effort, number> = {
+  none: 0,
+  low: 1024,
+  medium: 4096,
+  high: 8192,
+  max: 16384,
+};
+
 /** A turn in Gemini's history. `model` is its word for the assistant. */
 export interface GeminiContent {
   role: "user" | "model";
@@ -261,15 +274,27 @@ export function createGeminiProvider(config: GeminiConfig): Provider {
       const maxTokens = opts.maxTokens ?? config.maxTokens;
       const { system, contents } = toGeminiContents(messages);
 
+      // A model id copied out of Gemini's docs is often already `models/…`, and
+      // the doubled segment 404s as "model not found" — a confusing way to
+      // learn about a prefix.
+      const model = (opts.model ?? config.model).replace(/^models\//, "");
+      const isGemini3 = /gemini-3/i.test(model);
+
       const generationConfig: Record<string, unknown> = {};
       if (maxTokens !== undefined) generationConfig.maxOutputTokens = maxTokens;
       if (opts.temperature !== undefined) generationConfig.temperature = opts.temperature;
       if (opts.topP !== undefined) generationConfig.topP = opts.topP;
       if (opts.stopSequences?.length) generationConfig.stopSequences = opts.stopSequences;
-      // No effort means the model's own dynamic thinking. Sending MINIMAL here
+      // No effort means the model's own dynamic thinking. Sending MINIMAL / 0 here
       // would switch that off for a caller who never asked, which is the whole
       // reason the seam treats an absent effort as "never sent".
-      if (effort) generationConfig.thinkingConfig = { thinkingLevel: THINKING_LEVEL[effort] };
+      // Gemini 3 uses thinkingLevel (MINIMAL..HIGH), while Gemini 2.5 uses
+      // thinkingBudget (0 tokens disables thinking, positive numbers set budget).
+      if (effort) {
+        generationConfig.thinkingConfig = isGemini3
+          ? { thinkingLevel: THINKING_LEVEL[effort] }
+          : { thinkingBudget: GEMINI_2_THINKING_BUDGET[effort] };
+      }
       // A schema that shares its call with tools pins the decoder, and a pinned
       // decoder cannot emit a functionCall — the model narrates the call it
       // could not make and the turn ends, with nothing logged. See
@@ -281,7 +306,7 @@ export function createGeminiProvider(config: GeminiConfig): Provider {
         // `responseJsonSchema` takes JSON Schema as written; `responseSchema`
         // is Gemini's own trimmed dialect and rejects most of what a real
         // schema carries.
-        generationConfig.responseJsonSchema = opts.json.schema;
+        generationConfig.responseJsonSchema = toGeminiToolSchema(opts.json.schema);
       }
 
       const request: Record<string, unknown> = { contents, generationConfig };
@@ -302,7 +327,7 @@ export function createGeminiProvider(config: GeminiConfig): Provider {
               description: tool.description,
               // Same rule as the response schema: `parameters` is the trimmed
               // dialect, `parametersJsonSchema` is the schema we actually wrote.
-              parametersJsonSchema: tool.inputSchema,
+              parametersJsonSchema: toGeminiToolSchema(tool.inputSchema),
             })),
           },
         ];
@@ -312,11 +337,6 @@ export function createGeminiProvider(config: GeminiConfig): Provider {
         if (toolConfig) request.toolConfig = toolConfig;
       }
 
-      // A model id copied out of Gemini's docs is often already `models/…`, and
-      // the doubled segment 404s as "model not found" — a confusing way to
-      // learn about a prefix.
-      const model = (opts.model ?? config.model).replace(/^models\//, "");
-
       // Gemini reports the finish reason on a candidate that can arrive AFTER
       // the chunk carrying the function calls, so a turn's tool use has to be
       // remembered rather than read off the final chunk.

package/src/providers/openai.ts

@@ -83,10 +83,56 @@ export interface OpenAIConfig extends ProviderFallbackConfig {
    * not a lock.
    */
   providerOrder?: string[];
+  /**
+   * Automatically pin OpenRouter calls to the first-party model vendor's host
+   * when hitting openrouter.ai and providerOrder is not passed. Defaults to true.
+   */
+  pinHost?: boolean;
 }
 
 const DEFAULT_BASE_URL = "https://api.openai.com";
 
+/**
+ * Known first-party host slugs on OpenRouter for route pinning.
+ * Pinning keeps consecutive turns on the vendor's own endpoint, preserving
+ * the server-side KV prompt cache across rounds.
+ */
+const OPENROUTER_HOSTS: Record<string, string> = {
+  anthropic: "anthropic",
+  "arcee-ai": "arcee-ai",
+  cohere: "cohere",
+  deepseek: "deepseek",
+  google: "google-ai-studio",
+  meta: "meta",
+  minimax: "minimax",
+  mistralai: "mistral",
+  moonshotai: "moonshotai",
+  morph: "morph",
+  openai: "openai",
+  perplexity: "perplexity",
+  qwen: "alibaba",
+  stepfun: "stepfun",
+  tencent: "tencent",
+  upstage: "upstage",
+  "x-ai": "xai",
+  "z-ai": "z-ai",
+  zai: "z-ai",
+};
+
+export function openRouterHostFor(baseUrl: string, model: string): string | undefined {
+  let host: string;
+  try {
+    host = new URL(baseUrl).hostname;
+  } catch {
+    return undefined;
+  }
+  if (!host.includes("openrouter.ai")) return undefined;
+  const slash = model.indexOf("/");
+  if (slash <= 0) return undefined;
+  const vendor = model.slice(0, slash).toLowerCase();
+  return OPENROUTER_HOSTS[vendor];
+}
+
 /** The spellings of "think this hard" across the dialects that share this
  *  adapter. `off` sends nothing and leaves the model on its own default. */
 export type EffortDialect = "openai" | "openrouter" | "deepseek" | "off";
@@ -316,10 +362,11 @@ export function createOpenAIProvider(config: OpenAIConfig): Provider {
       opts: StreamOptions = {},
     ): AsyncIterable<ProviderChunk> {
       const effort = opts.effort ?? config.effort;
+      const model = opts.model ?? config.model;
 
       const body = toOpenAIMessages(messages);
       const request: Record<string, unknown> = {
-        model: opts.model ?? config.model,
+        model,
         messages: body,
         stream: true,
         // Without this the usage record never arrives and every call costs
@@ -398,12 +445,25 @@ export function createOpenAIProvider(config: OpenAIConfig): Provider {
           body.push({ role: "system", content: schemaPrompt(opts.json.schema) });
         }
       }
-      if (config.providerOrder?.length) {
-        request.provider = { order: config.providerOrder, allow_fallbacks: true };
+      const pinOrder = config.providerOrder?.length
+        ? config.providerOrder
+        : config.pinHost !== false
+          ? (() => {
+              const pinned = openRouterHostFor(baseUrl, model);
+              return pinned ? [pinned] : undefined;
+            })()
+          : undefined;
+
+      if (pinOrder?.length) {
+        request.provider = { order: pinOrder, allow_fallbacks: true };
       }
 
+      const defaultPath = /\/v\d+[^/]*$/i.test(baseUrl.replace(/\/+$/, ""))
+        ? "/chat/completions"
+        : "/v1/chat/completions";
+
       for await (const data of streamSse({
-        url: apiUrl(baseUrl, config.path ?? "/v1/chat/completions"),
+        url: apiUrl(baseUrl, config.path ?? defaultPath),
         headers: { authorization: `Bearer ${config.apiKey}`, ...config.headers },
         body: request,
         provider: id,