@openrouter/ai-sdk-provider breaking changes

3.0.0

22 breaking changes, first published July 6, 2026.

• Removed LanguageModelV3
  LanguageModelV3 was removed in @openrouter/ai-sdk-provider 3.0.0 npmjs.com
• Removed LanguageModelV3Prompt
  LanguageModelV3Prompt was removed in @openrouter/ai-sdk-provider 3.0.0 npmjs.com
• Behavior changed
  Image generation now uses a dedicated images API instead of the previous path. Code that depends on how images were generated may behave differently and should be checked. github.com
• Signature changed internal:OpenRouterChatLanguageModel
  Was class OpenRouterChatLanguageModel implements LanguageModelV3; now class OpenRouterChatLanguageModel implements LanguageModelV4. npmjs.com
• Signature changed internal:OpenRouterChatLanguageModel.doGenerate
  Was doGenerate(options: LanguageModelV3CallOptions): Promise<{content: Array<LanguageModelV3Content>; finishReason: LanguageModelV3FinishReason; usage: LanguageModelV3Usage; warnings: Array<SharedV3Warning>; providerMetadata?: {openrouter... npmjs.com
• Signature changed internal:OpenRouterChatLanguageModel.doStream
  Was doStream(options: LanguageModelV3CallOptions): Promise<{stream: ReadableStream<LanguageModelV3StreamPart>; warnings: Array<SharedV3Warning>; request?: {body?: unknown;}; response?: LanguageModelV3ResponseMetadata & {headers?... npmjs.com
• Signature changed internal:OpenRouterChatLanguageModel.specificationVersion
  Was readonly specificationVersion: "v3"; now readonly specificationVersion: "v4". npmjs.com
• Signature changed internal:OpenRouterCompletionLanguageModel
  Was class OpenRouterCompletionLanguageModel implements LanguageModelV3; now class OpenRouterCompletionLanguageModel implements LanguageModelV4. npmjs.com
• Signature changed internal:OpenRouterCompletionLanguageModel.doGenerate
  Was doGenerate(options: LanguageModelV3CallOptions): Promise<Awaited<ReturnType<LanguageModelV3['doGenerate']>>>; now doGenerate(options: LanguageModelV4CallOptions): Promise<Awaited<ReturnType<LanguageModelV4['doGenerate']>>>. npmjs.com
• Signature changed internal:OpenRouterCompletionLanguageModel.doStream
  Was doStream(options: LanguageModelV3CallOptions): Promise<Awaited<ReturnType<LanguageModelV3['doStream']>>>; now doStream(options: LanguageModelV4CallOptions): Promise<Awaited<ReturnType<LanguageModelV4['doStream']>>>. npmjs.com

And 12 more in this version.

2.0.0

18 breaking changes, first published January 19, 2026.

• Removed LanguageModelV2
  The language model now implements LanguageModelV3 instead of LanguageModelV2. Update code that references the V2 type. npmjs.com
• Removed LanguageModelV2Prompt
  LanguageModelV2Prompt was removed in @openrouter/ai-sdk-provider 2.0.0 npmjs.com
• Renamed EmbeddingModelV2
  The embedding model now implements EmbeddingModelV3 instead of EmbeddingModelV2. Update code that references the V2 type. github.com
• Renamed ProviderV2
  The provider now implements ProviderV3 instead of ProviderV2. Update code that references the V2 provider type to use V3. github.com
• Renamed SharedV2*
  Type imports named SharedV2* are replaced by SharedV3* equivalents. Update imports to the V3 names. github.com
• Behavior changed
  The specificationVersion value is now 'v3'. Code that checks for 'v2' must be updated. github.com
• Behavior changed
  Token usage now uses nested inputTokens and outputTokens objects with total, cache and reasoning fields. Update code that reads usage values. github.com
• Configuration changed
  The package now requires zod 3.25.0 or later within 3.x, or any 4.x. Older zod versions are no longer supported. github.com
• Configuration changed
  The package now requires ai version 6.0.0 or later. Upgrade the ai package alongside this provider. github.com
• Signature changed internal:OpenRouterChatLanguageModel
  Was class OpenRouterChatLanguageModel implements LanguageModelV2; now class OpenRouterChatLanguageModel implements LanguageModelV3. npmjs.com

And 8 more in this version.

Check your code

These are the changes. To see which of them reach your code, scan a public repository, or have your coding agent call check_code with your manifest or lockfile over MCP. The API reads every change in every version, not only the newest. On Team and up, a fix pull request opens for the changes that reach a connected repository. Nothing merges or deploys.