@ai-sdk/gateway 4.0.0-canary.90 → 4.0.0-canary.92

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @ai-sdk/gateway
 
+## 4.0.0-canary.92
+
+### Patch Changes
+
+- Updated dependencies [6c93e36]
+- Updated dependencies [f617ac2]
+  - @ai-sdk/provider-utils@5.0.0-canary.44
+
+## 4.0.0-canary.91
+
+### Patch Changes
+
+- d4d4a5e: Add `serviceTier: 'flex' | 'priority'` to `GatewayProviderOptions`.
+
 ## 4.0.0-canary.90
 
 ### Patch Changes

package/dist/index.d.ts

@@ -594,6 +594,7 @@ declare const gatewayProviderOptions: _ai_sdk_provider_utils.LazySchema<{
     providerTimeouts?: {
         byok?: Record<string, number> | undefined;
     } | undefined;
+    serviceTier?: "flex" | "priority" | undefined;
 }>;
 type GatewayProviderOptions = InferSchema<typeof gatewayProviderOptions>;
 

package/dist/index.js

@@ -1961,7 +1961,7 @@ async function getVercelRequestId() {
 }
 
 // src/version.ts
-var VERSION = true ? "4.0.0-canary.90" : "0.0.0-test";
+var VERSION = true ? "4.0.0-canary.92" : "0.0.0-test";
 
 // src/gateway-provider.ts
 var AI_GATEWAY_PROTOCOL_VERSION = "0.0.1";

package/docs/00-ai-gateway.mdx

@@ -874,6 +874,32 @@ The following gateway provider options are available:
 
   For full details, see [Provider Timeouts](https://vercel.com/docs/ai-gateway/models-and-providers/provider-timeouts).
 
+- **serviceTier** _'flex' | 'priority'_
+
+  Unified service tier intent. The gateway translates it into whichever
+  per-provider option each provider expects, and overrides any tier
+  also set in the per-provider options. Leave unset for provider
+  default. See the [OpenAI](/providers/ai-sdk-providers/openai),
+  [Google Generative AI](/providers/ai-sdk-providers/google-generative-ai),
+  and [Google Vertex AI](/providers/ai-sdk-providers/google-vertex)
+  provider docs for tier semantics, model availability, and graceful
+  downgrade behavior on each provider.
+
+  ```ts
+  import type { GatewayProviderOptions } from '@ai-sdk/gateway';
+  import { generateText } from 'ai';
+
+  const { text } = await generateText({
+    model: 'openai/gpt-5-mini',
+    prompt: 'Hello',
+    providerOptions: {
+      gateway: {
+        serviceTier: 'priority',
+      } satisfies GatewayProviderOptions,
+    },
+  });
+  ```
+
 You can combine these options to have fine-grained control over routing and tracking:
 
 ```ts

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ai-sdk/gateway",
   "private": false,
-  "version": "4.0.0-canary.90",
+  "version": "4.0.0-canary.92",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -32,7 +32,7 @@
   "dependencies": {
     "@vercel/oidc": "3.2.0",
     "@ai-sdk/provider": "4.0.0-canary.17",
-    "@ai-sdk/provider-utils": "5.0.0-canary.43"
+    "@ai-sdk/provider-utils": "5.0.0-canary.44"
   },
   "devDependencies": {
     "@types/node": "22.19.19",
@@ -40,8 +40,8 @@
     "tsx": "4.19.2",
     "typescript": "5.8.3",
     "zod": "3.25.76",
-    "@ai-sdk/test-server": "2.0.0-canary.6",
-    "@vercel/ai-tsconfig": "0.0.0"
+    "@vercel/ai-tsconfig": "0.0.0",
+    "@ai-sdk/test-server": "2.0.0-canary.6"
   },
   "peerDependencies": {
     "zod": "^3.25.76 || ^4.1.8"

package/src/gateway-provider-options.ts

@@ -104,6 +104,13 @@ const gatewayProviderOptions = lazySchema(() =>
           byok: z.record(z.string(), z.number().int().min(1000)).optional(),
         })
         .optional(),
+      /**
+       * Unified service tier intent. Translated by the gateway into the
+       * per-provider option each provider expects, and overrides any tier
+       * also set in the per-provider options. Leave unset for provider
+       * default.
+       */
+      serviceTier: z.enum(['flex', 'priority']).optional(),
     }),
   ),
 );