Layermod
Blog
·5 min·Layermod

OpenAI-kompatible API: Migration in 5 Minuten

Wechseln Sie in wenigen Minuten zu Layermod — ohne Code-Umbau. Einfach die Base-URL ändern und DSGVO-konforme KI nutzen.

So einfach ist der Wechsel

Layermod bietet eine vollständig OpenAI-kompatible API. Das bedeutet: Sie müssen keinen Code umschreiben. Ändern Sie einfach zwei Zeilen in Ihrer Konfiguration und Ihre gesamte Anwendung läuft sofort über europäische Infrastruktur — DSGVO-konform und ohne Vendor-Lock-in.

Egal ob Sie das OpenAI SDK direkt nutzen, LangChain-Pipelines betreiben oder den Vercel AI SDK einsetzen: Die Migration funktioniert überall gleich. In diesem Guide zeigen wir Ihnen Schritt für Schritt, wie der Wechsel gelingt.

Schritt 1: Account erstellen

Registrieren Sie sich unter console.layermod.com und erstellen Sie einen API-Schlüssel. Der Prozess dauert weniger als eine Minute:

  1. Konto anlegen (E-Mail oder OAuth)
  2. Im Dashboard unter API Keys einen neuen Schlüssel generieren
  3. Den Schlüssel sicher in Ihrer .env-Datei speichern:
LAYERMOD_KEY=lm_sk_your_api_key_here

Layermod-API-Schlüssel beginnen immer mit dem Präfix lm_sk_. Bewahren Sie den Schlüssel sicher auf — er wird nur einmal angezeigt. Starter-Credits sind im kostenlosen Plan enthalten, weitere Pakete finden Sie unter /pricing.

Schritt 2: Base-URL ändern

Ersetzen Sie die OpenAI Base-URL durch die Layermod-URL. Das ist die einzige Code-Änderung, die Sie vornehmen müssen:

// Vorher
const openai = new OpenAI({
  baseURL: "https://api.openai.com/v1"
})
 
// Nachher
const openai = new OpenAI({
  baseURL: "https://api.layermod.com/v1",
  apiKey: process.env.LAYERMOD_KEY
})

Wenn Sie die Base-URL über eine Umgebungsvariable setzen, reicht sogar eine Änderung in der .env-Datei — ganz ohne Ihren Code anzufassen:

OPENAI_BASE_URL=https://api.layermod.com/v1
OPENAI_API_KEY=lm_sk_your_api_key_here

Das OpenAI SDK liest diese Variablen automatisch aus. So können Sie zwischen Layermod und OpenAI wechseln, ohne Code zu ändern. Mehr dazu, warum EU-Hosting für KI-Anwendungen wichtig ist.

Schritt 3: Modell wählen

Nutzen Sie jedes verfügbare Modell — GPT-5.4, Claude, Llama und mehr. Layermod fungiert als LLM API Gateway und gibt Ihnen Zugang zu allen großen Modellanbietern über eine einzige API:

const response = await openai.chat.completions.create({
  model: "gpt-5.4", // oder "claude-sonnet-4-6", "llama-4-maverick"
  messages: [{ role: "user", content: "Hallo!" }]
})

Eine vollständige Liste aller verfügbaren Modelle finden Sie jederzeit über den /v1/models-Endpunkt oder in Ihrem Dashboard.

Was sich ändert (und was nicht)

Ändert sich:

  • Base-URL zeigt auf Layermod
  • API-Key ist ein Layermod-Schlüssel
  • Daten werden in der EU verarbeitet

Ändert sich nicht:

  • Ihr bestehender Code
  • Das OpenAI SDK
  • Die API-Schnittstelle (Chat Completions, Streaming, Function Calling)

Framework-spezifische Anleitungen

LangChain (Python)

Wenn Sie LangChain nutzen, ersetzen Sie einfach die Konfiguration des ChatOpenAI-Modells:

from langchain_openai import ChatOpenAI
 
llm = ChatOpenAI(
    model="gpt-5.4",
    base_url="https://api.layermod.com/v1",
    api_key="lm_sk_your_api_key_here"
)
 
response = llm.invoke("Erkläre mir die DSGVO in drei Sätzen.")
print(response.content)

Alle LangChain-Features wie Chains, Agents, Retrieval-Augmented Generation und Output-Parser funktionieren ohne Anpassung. Die kompatible API sorgt dafür, dass LangChain keinen Unterschied bemerkt.

Vercel AI SDK (TypeScript)

Der Vercel AI SDK funktioniert ebenfalls nahtlos mit Layermod. Nutzen Sie den OpenAI-Provider mit angepasster Base-URL:

import { createOpenAI } from "@ai-sdk/openai";
import { generateText } from "ai";
 
const layermod = createOpenAI({
  baseURL: "https://api.layermod.com/v1",
  apiKey: process.env.LAYERMOD_KEY,
});
 
const { text } = await generateText({
  model: layermod("gpt-5.4"),
  prompt: "Was ist Layermod?",
});

Dies funktioniert sowohl mit generateText als auch mit streamText für Streaming-Anwendungen in Next.js, Nuxt oder SvelteKit.

curl (Schnelltest)

Testen Sie die API direkt über die Kommandozeile, bevor Sie Ihren Code ändern:

curl https://api.layermod.com/v1/chat/completions \
  -H "Authorization: Bearer lm_sk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [{"role": "user", "content": "Hallo Layermod!"}]
  }'

Wenn Sie hier eine gültige Antwort erhalten, wissen Sie, dass Ihr API-Schlüssel funktioniert und die Verbindung steht.

Streaming

Server-Sent Events (SSE) Streaming funktioniert exakt wie bei OpenAI. Sie müssen nichts an Ihrem Streaming-Code ändern:

const stream = await openai.chat.completions.create({
  model: "gpt-5.4",
  messages: [{ role: "user", content: "Schreibe eine kurze Geschichte." }],
  stream: true,
});
 
for await (const chunk of stream) {
  const content = chunk.choices[0]?.delta?.content || "";
  process.stdout.write(content);
}

Das Streaming-Format ist zu 100 % kompatibel. Egal ob Sie stream: true im SDK nutzen, Server-Sent Events direkt konsumieren oder den Vercel AI SDK mit streamText einsetzen — alles funktioniert ohne Anpassung.

Function Calling / Tool Use

Layermod unterstützt Function Calling (Tool Use) vollständig. Definieren Sie Ihre Tools wie gewohnt:

const response = await openai.chat.completions.create({
  model: "gpt-5.4",
  messages: [{ role: "user", content: "Wie ist das Wetter in Berlin?" }],
  tools: [
    {
      type: "function",
      function: {
        name: "get_weather",
        description: "Aktuelles Wetter für einen Ort abrufen",
        parameters: {
          type: "object",
          properties: {
            location: { type: "string", description: "Stadt oder Ort" }
          },
          required: ["location"]
        }
      }
    }
  ]
});
 
const toolCall = response.choices[0].message.tool_calls?.[0];
if (toolCall) {
  console.log(toolCall.function.name); // "get_weather"
  console.log(toolCall.function.arguments); // '{"location": "Berlin"}'
}

Parallel Function Calling, erzwungene Tool-Aufrufe via tool_choice und mehrstufige Konversationen mit Tool-Ergebnissen werden vollständig unterstützt.

Fehlerbehebung

Authentifizierungsfehler (401 Unauthorized)

  • Prüfen Sie, ob Ihr API-Schlüssel mit lm_sk_ beginnt. OpenAI-Schlüssel (sk-...) funktionieren nicht mit Layermod.
  • Stellen Sie sicher, dass der Schlüssel korrekt in Ihrer Umgebungsvariable steht — keine Leerzeichen oder Zeilenumbrüche.
  • Generieren Sie bei Bedarf einen neuen Schlüssel im Dashboard.

Modell nicht gefunden (404 Not Found)

  • Nicht alle OpenAI-Modellnamen sind 1:1 verfügbar. Rufen Sie die verfügbaren Modelle ab:
curl https://api.layermod.com/v1/models \
  -H "Authorization: Bearer lm_sk_your_api_key_here"
  • Prüfen Sie die exakte Schreibweise des Modellnamens (Groß-/Kleinschreibung beachten).

Rate Limiting (429 Too Many Requests)

  • Im Starter-Plan gelten Standard-Limits. Für höhere Limits können Sie ein Credit-Paket unter /pricing erwerben.
  • Die Antwort-Header x-ratelimit-remaining und x-ratelimit-reset zeigen Ihren aktuellen Status.
  • Bei Bedarf kontaktieren Sie den Support für Enterprise-Limits.

Timeout-Fehler

  • Bei großen Kontextfenstern oder langen Antworten kann die Antwortzeit steigen. Erhöhen Sie das Timeout in Ihrem HTTP-Client.
  • Nutzen Sie Streaming (stream: true), um die erste Token-Antwortzeit zu verkürzen.

Fazit

Die Migration zu Layermod dauert buchstäblich 5 Minuten. Keine Breaking Changes, keine neuen SDKs, keine Lernkurve. Egal ob OpenAI SDK, LangChain, Vercel AI SDK oder ein einfacher curl-Aufruf — alles funktioniert sofort über unsere DSGVO-konforme Infrastruktur in der EU.

Bereit loszulegen? Erstellen Sie Ihren Account und sichern Sie sich Ihre ersten Credits. Flexible Pakete finden Sie auf unserer Preisseite.