The Complete Production SOP: How to Deploy and Run OpenRouter API Unified Multi-Provider Routing in Autonomous AI Agents

---
name: "openrouter-model-routing-failover"
description: "Access 100+ open and proprietary language models through a single OpenAI-compatible API."
metadata:
  author: "OpenRouter"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "call models with openrouter"
  - "use openrouter auto router"
  - "configure openrouter fallbacks"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

import OpenAI from 'openai';

if (!process.env.OPENROUTER_API_KEY) {
  throw new Error('OPENROUTER_API_KEY environment variable is missing.');
}

export const openrouter = new OpenAI({
  baseURL: 'https://openrouter.ai/api/v1',
  apiKey: process.env.OPENROUTER_API_KEY,
  defaultHeaders: {
    'HTTP-Referer': process.env.APP_URL || 'http://localhost:3000',
    'X-Title': 'Production Agent Engine',
  },
});

import { openrouter } from '../lib/openrouter';

export async function generateResilientCompletion(prompt: string) {
  return await openrouter.chat.completions.create({
    // Primary model with ordered automatic fallbacks
    model: 'anthropic/claude-3.5-sonnet',
    messages: [{ role: 'user', content: prompt }],
    // OpenRouter-specific routing extensions
    extra_body: {
      models: [
        'anthropic/claude-3.5-sonnet',
        'meta-llama/llama-3.3-70b-instruct',
        'google/gemini-2.0-flash-001'
      ],
      route: 'fallback'
    }
  } as any);
}