Overview
Type: Framework or PlatformPrimary Path: OpenAI-compatible defaultSupport Confidence: Recommended integration pattern
Recommended Default: OpenAI-Compatible Provider
Generate Text
Stream Text
Tool Calling
Structured Output
If You Explicitly Need Responses-Native Behavior
Use
@ai-sdk/openai-compatible as the safe default for proxy-style integrations. Switch to @ai-sdk/openai only when you explicitly want a provider path built on /v1/responses.Environment Variables
Best Practices
Prefer openai-compatible first
Prefer openai-compatible first
For third-party gateways and proxy backends,
@ai-sdk/openai-compatible is usually the least surprising starting point.Move to Responses only when needed
Move to Responses only when needed
If you need provider behavior tied to
/v1/responses, switch the provider package deliberately instead of mixing both patterns in one client.Keep secrets on the server
Keep secrets on the server
Never expose your AI Sonar API key in client-side code. Put provider setup in server files or API routes.