@ai-sdk/gateway 3.0.119 → 3.0.120

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @ai-sdk/gateway
 
+## 3.0.120
+
+### Patch Changes
+
+- 27a1b22: Add `serviceTier: 'flex' | 'priority'` to `GatewayProviderOptions`.
+
 ## 3.0.119
 
 ### Patch Changes

package/dist/index.d.mts

@@ -568,6 +568,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.d.ts

@@ -568,6 +568,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

@@ -1627,7 +1627,7 @@ async function getVercelRequestId() {
 }
 
 // src/version.ts
-var VERSION = true ? "3.0.119" : "0.0.0-test";
+var VERSION = true ? "3.0.120" : "0.0.0-test";
 
 // src/gateway-provider.ts
 var AI_GATEWAY_PROTOCOL_VERSION = "0.0.1";

package/dist/index.mjs

@@ -1672,7 +1672,7 @@ async function getVercelRequestId() {
 }
 
 // src/version.ts
-var VERSION = true ? "3.0.119" : "0.0.0-test";
+var VERSION = true ? "3.0.120" : "0.0.0-test";
 
 // src/gateway-provider.ts
 var AI_GATEWAY_PROTOCOL_VERSION = "0.0.1";

package/docs/00-ai-gateway.mdx

@@ -844,6 +844,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": "3.0.119",
+  "version": "3.0.120",
   "license": "Apache-2.0",
   "sideEffects": false,
   "main": "./dist/index.js",

package/src/gateway-provider-options.ts

@@ -101,6 +101,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(),
     }),
   ),
 );