fix(ai): deprecate topK and temperature for hybrid (#9816)

hsubox76 · web-flow · commit 6cbe86569cc4 · 2026-04-08T13:09:08.000-07:00
diff --git a/.changeset/gold-chefs-jam.md b/.changeset/gold-chefs-jam.md
@@ -0,0 +1,6 @@
+---
+'@firebase/ai': minor
+'firebase': minor
+---
+
+Deprecate `topK` and `temperature` properties for hybrid inference mode.
diff --git a/common/api-review/ai.api.md b/common/api-review/ai.api.md
@@ -896,9 +896,9 @@ export type Language = (typeof Language)[keyof typeof Language];
 export interface LanguageModelCreateCoreOptions {
     // (undocumented)
     expectedInputs?: LanguageModelExpected[];
-    // (undocumented)
+    // @deprecated (undocumented)
     temperature?: number;
-    // (undocumented)
+    // @deprecated (undocumented)
     topK?: number;
 }
 
diff --git a/docs-devsite/ai.languagemodelcreatecoreoptions.md b/docs-devsite/ai.languagemodelcreatecoreoptions.md
@@ -45,6 +45,10 @@ expectedInputs?: LanguageModelExpected[];
 > This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
 > 
 
+> Warning: This API is now obsolete.
+> 
+> 
+
 <b>Signature:</b>
 
 ```typescript
@@ -56,6 +60,10 @@ temperature?: number;
 > This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
 > 
 
+> Warning: This API is now obsolete.
+> 
+> 
+
 <b>Signature:</b>
 
 ```typescript
diff --git a/packages/ai/src/types/language-model.ts b/packages/ai/src/types/language-model.ts
@@ -54,7 +54,13 @@ export enum Availability {
  * @beta
  */
 export interface LanguageModelCreateCoreOptions {
+  /**
+   * @deprecated
+   */
   topK?: number;
+  /**
+   * @deprecated
+   */
   temperature?: number;
   expectedInputs?: LanguageModelExpected[];
 }
