Migrate from OpenRouter

Switch to OffRail for built-in analytics, self-hosting options, and simpler API. Two-line code change.

OffRail works just like OpenRouter—same API format, same model names—but with built-in analytics and the option to self-host. Migration takes two lines of code.

Let your AI agent do the migration

Copy this prompt into Claude Code, Cursor, or any coding agent — it reads our docs and handles the migration from OpenRouter for you.

Quick Migration

Change your base URL and API key:

- const baseURL = "https://openrouter.ai/api/v1";
- const apiKey = process.env.OPENROUTER_API_KEY;
+ const baseURL = "https://api.offrail.ai/v1";
+ const apiKey = process.env.OFFRAIL_API_KEY;

Migration Steps

Get Your OffRail API Key

Update Environment Variables

# Remove OpenRouter credentials
# OPENROUTER_API_KEY=sk-or-...

# Add OffRail credentials
OFFRAIL_API_KEY=orl_your_key_here

Update Your Code

Using fetch/axios

// Before (OpenRouter)
const response = await fetch("https://openrouter.ai/api/v1/chat/completions", {
	method: "POST",
	headers: {
		Authorization: `Bearer ${process.env.OPENROUTER_API_KEY}`,
		"Content-Type": "application/json",
	},
	body: JSON.stringify({
		model: "openai/gpt-5.2",
		messages: [{ role: "user", content: "Hello!" }],
	}),
});

// After (OffRail)
const response = await fetch("https://api.offrail.ai/v1/chat/completions", {
	method: "POST",
	headers: {
		Authorization: `Bearer ${process.env.OFFRAIL_API_KEY}`,
		"Content-Type": "application/json",
	},
	body: JSON.stringify({
		model: "gpt-5.2",
		messages: [{ role: "user", content: "Hello!" }],
	}),
});

Using OpenAI SDK

import OpenAI from "openai";

// Before (OpenRouter)
const client = new OpenAI({
	baseURL: "https://openrouter.ai/api/v1",
	apiKey: process.env.OPENROUTER_API_KEY,
});

// After (OffRail)
const client = new OpenAI({
	baseURL: "https://api.offrail.ai/v1",
	apiKey: process.env.OFFRAIL_API_KEY,
});

// Usage remains the same
const completion = await client.chat.completions.create({
	model: "anthropic/claude-3-5-sonnet-20241022",
	messages: [{ role: "user", content: "Hello!" }],
});

Using Vercel AI SDK

Both OpenRouter and OffRail have native AI SDK providers, making migration straightforward:

import { generateText } from "ai";

// Before (OpenRouter AI SDK Provider)
import { createOpenRouter } from "@openrouter/ai-sdk-provider";

const openrouter = createOpenRouter({
	apiKey: process.env.OPENROUTER_API_KEY,
});

const { text } = await generateText({
	model: openrouter("gpt-5.2"),
	prompt: "Hello!",
});

// After (OffRail AI SDK Provider)
import { createOpenAI } from "@ai-sdk/openai";

const offrail = createOpenAI({
	apiKey: process.env.OFFRAIL_API_KEY,
	baseURL: "https://api.offrail.ai/v1",
});

const { text } = await generateText({
	model: offrail("gpt-5.2"),
	prompt: "Hello!",
});

Model Name Mapping

Most model names are compatible, but here are some common mappings:

OpenRouter Model	OffRail Model
openai/gpt-5.2	gpt-5.2 or openai/gpt-5.2
gemini/gemini-3-flash-preview	gemini-3-flash-preview or google-ai-studio/gemini-3-flash-preview
bedrock/claude-opus-4-5-20251101	claude-opus-4-5-20251101 or aws-bedrock/claude-opus-4-5-20251101

Check the models page for the full list of available models.

Streaming Support

OffRail supports streaming responses identically to OpenRouter:

const stream = await client.chat.completions.create({
	model: "anthropic/claude-3-5-sonnet-20241022",
	messages: [{ role: "user", content: "Write a story" }],
	stream: true,
});

for await (const chunk of stream) {
	process.stdout.write(chunk.choices[0]?.delta?.content || "");
}

Full Comparison

Want to see a detailed breakdown of all features? Check out our OffRail vs OpenRouter comparison page.

Migrate from OpenRouter

On this page