Skip to main content
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

​
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:
ParameterTypeDefaultDescription
apiKeystringAURIKO_API_KEY envAPI key
baseURLstring"https://api.auriko.ai/v1"API base URL
headersRecord<string, string>undefinedCustom headers
fetchtypeof fetchglobalThis.fetchCustom fetch implementation
routingRoutingOptionsundefinedDefault routing configuration
metadataAurikoMetadataParamundefinedRequest 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

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.