add-provider-package

To integrate a new AI provider into the AI SDK, create a structured @ai-sdk/<provider> package implementing provider settings, model factories, and classes conforming to mandatory SDK interfaces like LanguageModelV4, then configure build and test tooling.

A custom AI provider must implement adapter-pattern architecture conforming to SDK interfaces including LanguageModelV4, EmbeddingModelV4, and ImageModelV4, alongside provider settings, model factories, and schema-validated responses.

Set up build and test tooling for an AI SDK provider package by creating a packages/<provider> folder with a valid package.json, adding tests and fixtures, then validating via build, type-check, and both Node and Edge test runs.

Yes, the AI SDK requires schema-validated responses for provider integration. Provider implementations must also handle secure API key loading and satisfy workspace dependencies on provider and provider-utils.

You can develop both first-party and third-party AI provider packages. The integration process applies to either scenario, covering provider architecture, model implementations, fixtures, examples, and documentation.

The best way to structure files when adding a provider to the AI SDK is creating a packages/<provider> directory with a valid package.json, then implementing src/index.ts and src/<provider>-provider.ts as entry points.