Merge pull request #108 from AssemblyAI/EA17A79D514289B819B9AE7C9AB1132F

Sync from internal repo (2025/10/16)

Author: he-james

package.json

@@ -1,6 +1,6 @@
 {
   "name": "assemblyai",
-  "version": "4.17.0",
+  "version": "4.18.0",
   "description": "The AssemblyAI JavaScript SDK provides an easy-to-use interface for interacting with the AssemblyAI API, which supports async and real-time transcription, as well as the latest LeMUR models.",
   "engines": {
     "node": ">=18"

src/types/openapi.generated.ts

@@ -2622,6 +2622,14 @@ export type Transcript = {
    * @defaultValue "null
    */
   speech_model: SpeechModel | null;
+  /**
+   * The list of speech models to use for the transcription in priority order.
+   */
+  speech_models?: string[] | null;
+  /**
+   * The actual speech model that was used for the transcription.
+   */
+  speech_model_used?: string | null;
   /**
    * Defaults to null. Reject audio files that contain less than this fraction of speech.
    * Valid values are in the range [0", 1] inclusive.
@@ -3152,6 +3160,10 @@ export type TranscriptOptionalParams = {
    * @defaultValue best
    */
   speech_model?: SpeechModel | null;
+  /**
+   * The list of speech models to use for the transcription in priority order.
+   */
+  speech_models?: string[] | null;
   /**
    * Reject audio files that contain less than this fraction of speech.
    * Valid values are in the range [0", 1] inclusive.

tests/unit/transcript.test.ts

@@ -468,4 +468,39 @@ describe("transcript", () => {
     expect(searchResponse.total_count).toBe(1);
     expect(searchResponse.matches).toBeInstanceOf(Array);
   });
+
+  it("should handle transcript response with speech_model_used field", async () => {
+    const transcriptWithSpeechModelUsed = {
+      id: transcriptId,
+      status: "completed",
+      speech_model_used: "best",
+    };
+    fetchMock.doMockOnceIf(
+      requestMatches({ url: `/v2/transcript/${transcriptId}`, method: "GET" }),
+      JSON.stringify(transcriptWithSpeechModelUsed),
+    );
+    const transcript = await assembly.transcripts.get(transcriptId);
+
+    expect(transcript.id).toBe(transcriptId);
+    expect(transcript.speech_model_used).toBe("best");
+  });
+
+  it("should handle transcript response without speech_model_used field", async () => {
+    // This test verifies that the SDK gracefully handles responses
+    // where speech_model_used is not present, as the field has not yet
+    // been added to the API for all users.
+    const transcriptWithoutSpeechModelUsed = {
+      id: transcriptId,
+      status: "completed",
+      // speech_model_used intentionally omitted
+    };
+    fetchMock.doMockOnceIf(
+      requestMatches({ url: `/v2/transcript/${transcriptId}`, method: "GET" }),
+      JSON.stringify(transcriptWithoutSpeechModelUsed),
+    );
+    const transcript = await assembly.transcripts.get(transcriptId);
+
+    expect(transcript.id).toBe(transcriptId);
+    expect(transcript.speech_model_used).toBeUndefined();
+  });
 });