Skip to main content
Use @phaseo/ai-sdk-provider to connect Vercel AI SDK v6 to Phaseo Gateway.

Install packages

npm install @phaseo/ai-sdk-provider ai@^6

Quick start

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

const result = await generateText({
  model: phaseo("openai/gpt-5-nano"),
  prompt: "Summarize the benefits of vector search.",
});

console.log(result.text);
console.log(result.providerMetadata);

Environment variables

Set:
  • PHASEO_API_KEY
Optional base URL:
  • PHASEO_BASE_URL

Custom provider instance

import { createPhaseo } from "@phaseo/ai-sdk-provider";
import { generateText } from "ai";

const provider = createPhaseo({
  apiKey: process.env.PHASEO_API_KEY,
  baseURL: process.env.PHASEO_BASE_URL ?? "https://api.phaseo.ai/v1",
  headers: {
    "x-title": "My App",
    "http-referer": "https://example.com",
  },
});

const result = await generateText({
  model: provider("openai/gpt-5-nano"),
  prompt: "Hello from a custom provider instance.",
});

console.log(result.text);
console.log(result.providerMetadata);

What this reference covers

Streaming example

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

const result = streamText({
  model: phaseo("openai/gpt-5-nano"),
  prompt: "Stream a short greeting.",
});

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

console.log(await result.providerMetadata);

Notes

  • Text, embeddings, image, speech, and transcription calls expose gateway routing metadata through providerMetadata.
  • Audio currently uses the AI SDK experimental entry points: experimental_transcribe(...) and experimental_generateSpeech(...).
Last modified on July 9, 2026