OpenRouter (TypeScript)

npm install @fallom/trace openai

import { trace } from "@fallom/trace";
import OpenAI from "openai";

// Initialize Fallom
await trace.init({ apiKey: process.env.FALLOM_API_KEY });

// Wrap OpenAI client with OpenRouter base URL
const openrouter = trace.wrapOpenAI(
  new OpenAI({
    baseURL: "https://openrouter.ai/api/v1",
    apiKey: process.env.OPENROUTER_API_KEY,
  })
);

// Set session context (configKey, sessionId, userId)
trace.setSession("my-app", "session-123", "user-456");

// Use any OpenRouter model
const response = await openrouter.chat.completions.create({
  model: "openai/gpt-4o-mini",
  messages: [{ role: "user", content: "Hello!" }],
});

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

// OpenAI
model: "openai/gpt-4o";
model: "openai/gpt-4o-mini";

// Anthropic
model: "anthropic/claude-sonnet-4-20250514";
model: "anthropic/claude-3-opus";

// Google
model: "google/gemini-1.5-pro";
model: "google/gemini-1.5-flash";

// Meta
model: "meta-llama/llama-3.1-70b-instruct";

// And many more...

import { trace } from "@fallom/trace";
import * as ai from "ai";
import { createOpenAI } from "@ai-sdk/openai";

await trace.init({ apiKey: "your-fallom-api-key" });

const { generateText, streamText } = trace.wrapAISDK(ai);

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

trace.setSession("my-agent", "session-123");

const { text } = await generateText({
  model: openrouter("openai/gpt-4o-mini"),
  prompt: "Hello!",
});

import { trace, models } from "@fallom/trace";
import OpenAI from "openai";

// Initialize both trace and models
await trace.init({ apiKey: "your-fallom-api-key" });
models.init({ apiKey: "your-fallom-api-key" });

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

// Get assigned model - could be GPT-4o, Claude, Gemini, etc.
const modelId = await models.get("my-experiment", "session-123", {
  fallback: "openai/gpt-4o-mini",
});

trace.setSession("my-experiment", "session-123");

const response = await openrouter.chat.completions.create({
  model: modelId,
  messages: [{ role: "user", content: "Hello!" }],
});

const stream = await openrouter.chat.completions.create({
  model: "openai/gpt-4o-mini",
  messages: [{ role: "user", content: "Write a poem." }],
  stream: true,
});

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