Vercel AI SDK - Auriko

Use Auriko as your LLM provider in the Vercel AI SDK with a first-party provider package. This integration is for TypeScript and JavaScript. For Python, use the LangChain or LlamaIndex integration.

@auriko/ai-sdk-provider is at 0.2.0. Expect API changes before 1.0.

Prerequisites

An Auriko API key
Node.js 18+

Install

npm install @auriko/ai-sdk-provider ai

Use the provider

Create a provider instance and pass it to any AI SDK function:

import { createAuriko } from "@auriko/ai-sdk-provider";
import { generateText } from "ai";

const auriko = createAuriko();

const { text } = await generateText({
  model: auriko("gpt-4o"),
  prompt: "What is the capital of France?",
});

console.log(text);

createAuriko() reads your AURIKO_API_KEY environment variable by default.

Stream responses

Use streamText for streaming:

import { createAuriko } from "@auriko/ai-sdk-provider";
import { streamText } from "ai";

const auriko = createAuriko();

const result = streamText({
  model: auriko("gpt-4o"),
  prompt: "Count to 10",
});

for await (const chunk of result.textStream) {
  process.stdout.write(chunk);
}

Configure options

createAuriko() accepts these parameters:

Parameter	Type	Default	Description
`apiKey`	`string`	`AURIKO_API_KEY` env	API key
`baseURL`	`string`	`"https://api.auriko.ai/v1"`	API base URL
`headers`	`Record<string, string>`	`undefined`	Custom headers
`fetch`	`typeof fetch`	`globalThis.fetch`	Custom fetch implementation
`routing`	`RoutingOptions`	`undefined`	Default routing configuration
`metadata`	`AurikoMetadataParam`	`undefined`	Request metadata (tags, user ID, trace ID)

Configure routing

Set routing defaults when you create the provider:

import { createAuriko, Optimize } from "@auriko/ai-sdk-provider";
import type { AurikoResponseMetadata } from "@auriko/ai-sdk-provider";
import { generateText } from "ai";

const auriko = createAuriko({
  routing: { optimize: Optimize.COST, max_ttft_ms: 1000 },
});

const result = await generateText({
  model: auriko("gpt-4o"),
  prompt: "Hello!",
});

const meta = result.providerMetadata?.auriko as AurikoResponseMetadata | undefined;
if (meta) {
  console.log(`Provider: ${meta.provider}`);
  console.log(`Cost: $${meta.cost?.usd}`);
}

For routing parameters, see the routing options guide and advanced routing guide.

Access routing metadata

For non-streaming calls, read result.providerMetadata?.auriko:

const meta = result.providerMetadata?.auriko as AurikoResponseMetadata | undefined;
console.log(meta?.provider);

For streaming calls, await the metadata:

const result = streamText({ model: auriko("gpt-4o"), prompt: "Hello!" });
const metadata = await result.providerMetadata;
const meta = metadata?.auriko as AurikoResponseMetadata | undefined;
console.log(meta?.provider);

Import AurikoResponseMetadata from @auriko/ai-sdk-provider for type-safe access.

Configure manually

Alternative: use @ai-sdk/openai directly

You can point the OpenAI-compatible provider at Auriko’s API:

npm install @ai-sdk/openai ai

import { createOpenAI } from "@ai-sdk/openai";
import { generateText } from "ai";

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

const { text } = await generateText({
  model: openai.chat("gpt-4o"), // .chat() recommended: routing metadata available via Chat Completions
  prompt: "Hello!",
});

This approach doesn’t include built-in routing or response metadata. You can set a routing strategy with a suffix shortcut (e.g., openai.chat("gpt-4o:cost-focus")). For routing configuration and typed metadata, use @auriko/ai-sdk-provider.

​Prerequisites

​Install

​Use the provider

​Stream responses

​Configure options

​Configure routing

​Access routing metadata

​Configure manually

Prerequisites

Install

Use the provider

Stream responses

Configure options

Configure routing

Access routing metadata

Configure manually