Phaseo ships an official Vercel AI SDK provider in the @phaseo/ai-sdk-provider package.
Install
AI SDK 7 and the native Phaseo ProviderV4 implementation are the default for new projects:
AI SDK 6 maintenance line
AI SDK 6 uses the previous ProviderV3 contract. Pin Phaseo provider 1.x and AI SDK 6:
Phaseo provider 1.x remains in maintenance while AI SDK 7 is current. When AI SDK 8 reaches a stable release, Phaseo will mark the 1.x line as deprecated on npm. Deprecation will not remove existing releases; any eventual end-of-support decision will be announced separately.
AI SDK 5 compatibility
AI SDK 5 only accepts the older v2 provider contract. Use Vercel’s version-matched OpenAI-compatible provider with Phaseo:
Basic usage
Supported AI SDK 7 surfaces
Provider 2.x implements and tests AI SDK 7’s native v4 contracts for:
- Text generation and streaming
- Provider-agnostic reasoning settings and reasoning output
- Standard function tools, streamed tool inputs, and tool-result round trips
- JSON and JSON Schema structured output
- Text and image file inputs using V7’s tagged file-data format
- URL citation sources
- Embeddings and image generation
- Transcription and speech generation
- Provider metadata, usage, request headers, abort signals, and raw stream chunks
Use model ids from the Models endpoint. Individual capabilities still depend on the selected model and upstream provider.
Explicitly unsupported V7 surfaces
ProviderV4 capabilities that require Phaseo API surfaces not currently exposed—managed file uploads and references, skills, reranking, provider-executed tools, and tool-approval flows—are not advertised. Unsupported provider-specific or custom prompt parts fail with a clear error instead of being silently discarded. Last modified on August 5, 2026