Sovereign Docs

Vercel AI SDK

Connect the Vercel AI SDK to Sovereign through an OpenAI-compatible provider instance.

Official docs:

Use the OpenAI-compatible surface.

Option 1: Use the OpenAI provider directly

import { createOpenAI } from "@ai-sdk/openai";
import { generateText } from "ai";
 
const sovereign = createOpenAI({
  apiKey: process.env.SOVEREIGN_API_KEY,
  baseURL: "https://api.sovrun.one/v1",
});
 
const { text } = await generateText({
  model: sovereign("sovereign-alpha"),
  prompt: "Hello",
});

Option 2: Use the OpenAI-compatible provider

import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
 
const sovereign = createOpenAICompatible({
  name: "sovereign",
  apiKey: process.env.SOVEREIGN_API_KEY,
  baseURL: "https://api.sovrun.one/v1",
  includeUsage: true,
});

Notes

  • AI SDK docs explicitly support custom baseURL for OpenAI-style providers.
  • The OpenAI provider in AI SDK 5 uses the Responses API by default; Sovereign supports that route.

On this page