Skip to main content

Use the Vercel AI SDK with Radium

Use the Vercel AI SDK with Radium

Use the AI SDK's OpenAI-compatible provider to call Radium from Node.js or server-side code in a Next.js application.

Before you start

You need:

  • Node.js 22 or newer
  • npm
  • A Radium API key

Radium calls must run on the server. Never expose the key through browser code or a NEXT_PUBLIC_... environment variable.

1. Create a project and install the packages

mkdir radium-vercel-ai-sdk
cd radium-vercel-ai-sdk
npm init -y
npm pkg set type=module
npm install ai @ai-sdk/openai-compatible

2. Set your Radium credentials

macOS or Linux:

export RADIUM_API_KEY="your-radium-api-key"
export RADIUM_MODEL="hal-1.0"

Windows PowerShell:

$env:RADIUM_API_KEY = "your-radium-api-key"
$env:RADIUM_MODEL = "hal-1.0"

3. Create main.mjs

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

if (!process.env.RADIUM_API_KEY) {
  throw new Error("Set RADIUM_API_KEY before running this program.");
}

const radium = createOpenAICompatible({
  name: "radium",
  apiKey: process.env.RADIUM_API_KEY,
  baseURL: "https://api.radium.cloud/v1",
});

const { text } = await generateText({
  model: radium.chatModel(process.env.RADIUM_MODEL ?? "hal-1.0"),
  system: "Follow the user's instruction exactly.",
  prompt: "Reply with exactly: Radium connected.",
  maxOutputTokens: 512,
  temperature: 0,
});

if (!text?.trim()) {
  throw new Error("Radium returned no visible text.");
}
console.log(`RADIUM_RESPONSE: ${text.trim()}`);

The base URL must include /v1. The provider adds /chat/completions itself.

4. Run it

node main.mjs

Expected output:

RADIUM_RESPONSE: Radium connected.

Choose a model

export RADIUM_MODEL="clarke-1.0"  # or hal-1.0 or tycho-1.0
node main.mjs

Migrate an existing AI SDK application

Create the provider once:

import { createOpenAICompatible } from "@ai-sdk/openai-compatible";

const radium = createOpenAICompatible({
  name: "radium",
  apiKey: process.env.RADIUM_API_KEY,
  baseURL: "https://api.radium.cloud/v1",
});

Then replace the model supplied to generateText, streamText, or your server route:

const model = radium.chatModel("hal-1.0");

Your prompts and server-side AI SDK handlers can remain unchanged.

Troubleshooting

  • Node version errors: use Node.js 22 or newer for the pinned packages.
  • Authentication errors: verify RADIUM_API_KEY in the server process.
  • 404: use the exact base URL and one of the listed model IDs.
  • Browser key exposure: move the call into a server route or server action.
  • Provider compatibility warning: update both ai and @ai-sdk/openai-compatible together so they use compatible current releases.

Validation

Version note: these instructions were verified with Node.js 24.1.0, ai@7.0.71, and @ai-sdk/openai-compatible@3.0.33 on August 20, 2026. You do not need those exact package versions. Text generation and multi-step tool calling passed cleanly with hal-1.0, clarke-1.0, and tycho-1.0.

Reference: Vercel AI SDK OpenAI-compatible providers.

Next

Back to top