Cencori

The Cencori adapter provides access to 14+ AI providers (OpenAI, Anthropic, Google, xAI, and more) through a unified interface with built-in security, observability, and cost tracking.

Installation

shell

npm install @cencori/ai-sdk

Basic Usage

import { chat } from "@tanstack/ai";
import { cencori } from "@cencori/ai-sdk/tanstack";

const adapter = cencori("gpt-4o");

for await (const chunk of chat({
  adapter,
  messages: [{ role: "user", content: "Hello!" }],
})) {
  if (chunk.type === "TEXT_MESSAGE_CONTENT") {
    console.log(chunk.delta);
  }
}

Configuration

import { createCencori } from "@cencori/ai-sdk/tanstack";

const cencori = createCencori({
  apiKey: process.env.CENCORI_API_KEY!,
  baseUrl: "https://cencori.com", // Optional
});

const adapter = cencori("gpt-4o");

Streaming

import { chat } from "@tanstack/ai";
import { cencori } from "@cencori/ai-sdk/tanstack";

const adapter = cencori("claude-3-5-sonnet");

for await (const chunk of chat({
  adapter,
  messages: [{ role: "user", content: "Tell me a story" }],
})) {
  if (chunk.type === "TEXT_MESSAGE_CONTENT") {
    process.stdout.write(chunk.delta);
  } else if (chunk.type === "RUN_FINISHED") {
    console.log("\nDone:", chunk.finishReason);
  }
}

Tool Calling

import { chat, toolDefinition } from "@tanstack/ai";
import { cencori } from "@cencori/ai-sdk/tanstack";
import { z } from "zod";

const adapter = cencori("gpt-4o");

const getWeatherDef = toolDefinition({
  name: "getWeather",
  description: "Get weather for a location",
  inputSchema: z.object({ location: z.string() }),
});

const getWeather = getWeatherDef.server(async ({ location }) => {
  // Look up the weather for `location`
  return { temperature: 72, conditions: "Sunny" };
});

for await (const chunk of chat({
  adapter,
  messages: [{ role: "user", content: "What's the weather in NYC?" }],
  tools: [getWeather],
})) {
  if (chunk.type === "TOOL_CALL_START") {
    console.log("Tool call:", chunk.toolName);
  } else if (chunk.type === "TOOL_CALL_END") {
    console.log("Tool result:", chunk.result);
  }
}

Multi-Provider Support

Switch between providers with a single parameter:

import { cencori } from "@cencori/ai-sdk/tanstack";

// OpenAI
const openai = cencori("gpt-4o");

// Anthropic
const anthropic = cencori("claude-3-5-sonnet");

// Google
const google = cencori("gemini-2.5-flash");

// xAI
const grok = cencori("grok-3");

// DeepSeek
const deepseek = cencori("deepseek-v3.2");

All responses use the same unified format regardless of provider.

Supported Models

Provider	Models
OpenAI	gpt-5, gpt-4o, gpt-4o-mini, o3, o1
Anthropic	claude-opus-4, claude-sonnet-4, claude-3-5-sonnet
Google	gemini-3-pro, gemini-2.5-flash, gemini-2.0-flash
xAI	grok-4, grok-3
Mistral	mistral-large, codestral, devstral
DeepSeek	deepseek-v3.2, deepseek-reasoner
+ More	Groq, Cohere, Perplexity, Together, Qwen, OpenRouter

Note: Cencori is an external package and its catalogue changes over time. Verify the model ids above against Cencori's current catalogue before relying on them.

Environment Variables

shell

CENCORI_API_KEY=csk_your_api_key_here

Getting an API Key

Go to Cencori
Create an account and generate an API key
Add it to your environment variables

Why Cencori?

🔒 Security — PII filtering, jailbreak detection, content moderation
📊 Observability — Request logs, latency metrics, cost tracking
💰 Cost Control — Budgets, alerts, per-route analytics
🔌 Multi-Provider — One API key for 14+ AI providers
🛠️ Tool Calling — Full support for function calling across providers
🔄 Failover — Automatic retry and fallback to alternative providers

API Reference

cencori(model)

Creates a Cencori adapter using environment variables.

Parameters:

model - Model name (e.g., "gpt-4o", "claude-3-5-sonnet", "gemini-2.5-flash")
Returns: A Cencori TanStack AI adapter instance.

createCencori(config)

Creates a custom Cencori adapter factory.

Parameters:

config.apiKey - Your Cencori API key
config.baseUrl? - Custom base URL (optional)
Returns: A function that creates adapter instances for specific models.