OpenRouter: Einfache Integration von KI-Modellen in Node.js

Mit OpenRouter bündelt sich der Zugriff auf hunderte große Sprachmodelle (LLMs) führender Anbieter wie OpenAI, Anthropic, Google und Meta über eine einheitliche API. Entwickler können so mit einer einzigen Schnittstelle arbeiten, einem API-Schlüssel und einer Abrechnungsoberfläche. Der Wechsel zwischen Modellen erfolgt durch das einfache Anpassen eines Anbieter/Modell-Strings.

In diesem Leitfaden erfahren Sie, wie Sie OpenRouter in drei gängigen Node.js-Umgebungen integrieren: über das offizielle SDK @openrouter/sdk, das bewährte openai-Paket mit angepasster Basis-URL oder die moderne Vercel AI SDK mit dem Provider @openrouter/ai-sdk-provider.

Vorteile der OpenRouter-Integration

Die Nutzung von OpenRouter bietet mehrere praktische Vorteile für Entwicklerteams:

• Einheitliche Schnittstelle: Eine API für alle Modelle reduziert den Wartungsaufwand.
• Flexible Modellauswahl: Wechseln Sie zwischen Anbietern wie openai/gpt-5.5, anthropic/claude-opus-4.8 oder google/gemini-3.1-flash-lite ohne Codeänderungen.
• Konsistente Abrechnung: Eine zentrale Rechnung fasst die Kosten aller genutzten Modelle zusammen.
• Produktionsbereite Features: Unterstützt Streaming, System-Prompts und erweiterte Metadaten wie HTTP-Referer oder X-OpenRouter-Title.

Vorbereitung: Voraussetzungen und Einrichtung

Bevor Sie mit der Integration beginnen, stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind:

• Ein aktives OpenRouter-Konto mit gültigem API-Schlüssel
• Guthaben oder aktivierte Abrechnung für das gewünschte Modell
• Node.js in Version 26 oder höher
• Die Installation der benötigten Pakete entsprechend Ihrer gewählten Integrationsmethode:
• Für das @openrouter/sdk-Paket: npm install @openrouter/sdk
• Für das openai-Paket: npm install openai
• Für die Vercel AI SDK: npm install ai @openrouter/ai-sdk-provider

Wichtige Umgebungsvariablen für den Betrieb

Für eine sichere und flexible Konfiguration empfiehlt sich die Verwendung von Umgebungsvariablen. Diese ermöglichen eine einfache Anpassung in verschiedenen Umgebungen wie Entwicklung, Staging oder Produktion.

| Variable | Zweck | Beispielwert | |----------|-------|--------------| | OPENROUTER_API_KEY | API-Schlüssel für die Authentifizierung | Ihr persönlicher API-Schlüssel aus den OpenRouter-Einstellungen | | OPENROUTER_MODEL | Standardmodell für die API-Anfragen | openai/gpt-5.5 | | OPENROUTER_SITE_URL | Optional: URL der Anwendung für OpenRouter-Rankings | | | OPENROUTER_SITE_TITLE | Optional: Name der Anwendung für Tracking | Mein KI-Assistent` |

Die Modell-IDs folgen dem Format Anbieter/Modellname, z. B. openai/gpt-5.5 oder google/gemini-3.1-flash-lite. Eine vollständige Übersicht aller verfügbaren Modelle finden Sie im OpenRouter-Modellkatalog.

Integration über das offizielle OpenRouter SDK

Das @openrouter/sdk-Paket ist die offizielle, typsichere Lösung für TypeScript-Entwickler und wird direkt aus der OpenAPI-Spezifikation generiert.

Client initialisieren

Der Client wird mit dem API-Schlüssel und optionalen Metadaten konfiguriert:

import { OpenRouter } from '@openrouter/sdk';

const client = new OpenRouter({
  apiKey: process.env.OPENROUTER_API_KEY,
  httpReferer: process.env.OPENROUTER_SITE_URL,
  appTitle: process.env.OPENROUTER_SITE_TITLE,
});

Grundlegende API-Anfrage

Eine einfache Anfrage an das Modell erfolgt mit einer Nachricht im chatRequest-Objekt:

const response = await client.chat.send({
  chatRequest: {
    model: process.env.OPENROUTER_MODEL ?? 'openai/gpt-5.5',
    messages: [
      {
        role: 'user',
        content: 'Schreibe eine einsätzige Gutenachtgeschichte über ein Einhorn.'
      },
    ],
  },
});

console.log(response.choices[0].message.content);

System-Prompts nutzen

System-Prompts helfen, den Tonfall, das Format oder die Rolle des Modells vorzugeben:

const response = await client.chat.send({
  chatRequest: {
    model: process.env.OPENROUTER_MODEL ?? 'openai/gpt-5.5',
    messages: [
      {
        role: 'system',
        content: 'Antworte in einem kurzen Satz. Verwende einfache Sprache.'
      },
      {
        role: 'user',
        content: 'Erkläre, was ein LLM ist.'
      },
    ],
  },
});

console.log(response.choices[0].message.content);

Streaming von Antworten

Für Echtzeit-Antworten aktivieren Sie das Streaming mit stream: true:

const stream = await client.chat.send({
  chatRequest: {
    model: process.env.OPENROUTER_MODEL ?? 'openai/gpt-5.5',
    messages: [
      { role: 'user', content: 'Nenne drei Farben.' }
    ],
    stream: true,
  },
});

process.stdout.write('[Stream] ');
for await (const chunk of stream) {
  const delta = chunk.choices[0]?.delta?.content;
  if (delta) {
    process.stdout.write(delta);
  }
}
process.stdout.write('\n');

Modelle dynamisch wechseln

Der Wechsel zwischen Modellen erfordert nur die Anpassung des model-Strings:

const models = ['openai/gpt-5.5', 'google/gemini-3.1-flash-lite'];

for (const model of models) {
  const response = await client.chat.send({
    chatRequest: {
      model,
      messages: [
        { role: 'user', content: 'Antworte mit genau einem Wort: ok.' }
      ],
    },
  });
  console.log(`${model} -> ${response.choices[0].message.content}`);
}

Integration über das OpenAI SDK mit angepasster Basis-URL

Falls Sie bereits das openai-Paket nutzen, können Sie es mit einer angepassten Basis-URL (baseURL) für OpenRouter konfigurieren. Die Anfragestruktur bleibt dabei unverändert.

Client einrichten

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.OPENROUTER_API_KEY,
  baseURL: '
  defaultHeaders: {
    'HTTP-Referer': process.env.OPENROUTER_SITE_URL,
    'X-OpenRouter-Title': process.env.OPENROUTER_SITE_TITLE,
  },
});

Grundlegende Anfrage

const completion = await client.chat.completions.create({
  model: process.env.OPENROUTER_MODEL ?? 'openai/gpt-5.5',
  messages: [
    {
      role: 'user',
      content: 'Schreibe eine einsätzige Gutenachtgeschichte über ein Einhorn.'
    },
  ],
});

console.log(completion.choices[0].message.content);

Integration mit der Vercel AI SDK

Die Vercel AI SDK bietet eine moderne Schnittstelle für die Arbeit mit LLMs. Mit dem Paket @openrouter/ai-sdk-provider lassen sich OpenRouter-Modelle nahtlos in Funktionen wie generateText oder streamText integrieren.

Pakete installieren und Provider einrichten

npm install ai @openrouter/ai-sdk-provider

import { generateText } from 'ai';
import { openrouter } from '@openrouter/ai-sdk-provider';

const { text } = await generateText({
  model: openrouter('openai/gpt-5.5'),
  prompt: 'Erkläre, was ein LLM ist.',
});

console.log(text);

Fazit und Ausblick

OpenRouter vereinfacht die Integration großer Sprachmodelle in Node.js-Anwendungen durch eine einheitliche API und flexible Modellauswahl. Die vorgestellten Integrationswege – über das offizielle SDK, das OpenAI-Paket oder die Vercel AI SDK – decken verschiedene Entwicklungsansätze ab und ermöglichen eine schnelle Implementierung.

Die Zukunft der LLM-Integration wird voraussichtlich noch mehr Anbieter und Modelle umfassen, während die APIs weiter standardisiert werden. Entwickler profitieren bereits heute von der Konsistenz und Benutzerfreundlichkeit von OpenRouter – ein Werkzeug, das die Arbeit mit KI-Modellen demokratisiert.