@cartesia/cartesia-js 1.0.1 → 1.0.3

package/dist/tts/index.cjs

@@ -122,20 +122,25 @@ var constructApiUrl = (baseUrl, path, { websocket = false } = {}) => {
 // src/lib/client.ts
 var Client = class {
   constructor(options = {}) {
-    if (!(options.apiKey || process.env.CARTESIA_API_KEY)) {
+    const apiKey = options.apiKey || process.env.CARTESIA_API_KEY;
+    if (!apiKey) {
       throw new Error("Missing Cartesia API key.");
     }
-    this.apiKey = options.apiKey || process.env.CARTESIA_API_KEY;
+    this.apiKey = typeof apiKey === "function" ? apiKey : () => __async(this, null, function* () {
+      return apiKey;
+    });
     this.baseUrl = options.baseUrl || BASE_URL;
   }
-  fetch(path, options = {}) {
-    const url = constructApiUrl(this.baseUrl, path);
-    return (0, import_cross_fetch.default)(url.toString(), __spreadProps(__spreadValues({}, options), {
-      headers: __spreadValues({
-        "X-API-Key": this.apiKey,
-        "Cartesia-Version": CARTESIA_VERSION
-      }, options.headers)
-    }));
+  _fetch(_0) {
+    return __async(this, arguments, function* (path, options = {}) {
+      const url = constructApiUrl(this.baseUrl, path);
+      const headers = new Headers(options.headers);
+      headers.set("X-API-Key", yield this.apiKey());
+      headers.set("Cartesia-Version", CARTESIA_VERSION);
+      return (0, import_cross_fetch.default)(url.toString(), __spreadProps(__spreadValues({}, options), {
+        headers
+      }));
+    });
   }
 };
 
@@ -478,56 +483,61 @@ var WebSocket = class extends Client {
    * @throws {Error} If the WebSocket fails to connect.
    */
   connect() {
-    const url = constructApiUrl(this.baseUrl, "/tts/websocket", {
-      websocket: true
+    return __async(this, null, function* () {
+      const emitter = new import_emittery2.default();
+      this.socket = new import_partysocket.WebSocket(() => __async(this, null, function* () {
+        const url = constructApiUrl(this.baseUrl, "/tts/websocket", {
+          websocket: true
+        });
+        url.searchParams.set("api_key", yield this.apiKey());
+        url.searchParams.set("cartesia_version", CARTESIA_VERSION);
+        return url.toString();
+      }));
+      this.socket.binaryType = "arraybuffer";
+      this.socket.onopen = () => {
+        __privateSet(this, _isConnected, true);
+        emitter.emit("open");
+      };
+      this.socket.onclose = () => {
+        __privateSet(this, _isConnected, false);
+        emitter.emit("close");
+      };
+      return new Promise(
+        (resolve, reject) => {
+          var _a, _b, _c;
+          (_a = this.socket) == null ? void 0 : _a.addEventListener(
+            "open",
+            () => {
+              resolve(getEmitteryCallbacks(emitter));
+            },
+            {
+              once: true
+            }
+          );
+          const aborter = new AbortController();
+          (_b = this.socket) == null ? void 0 : _b.addEventListener(
+            "error",
+            () => {
+              aborter.abort();
+              reject(new Error("WebSocket failed to connect."));
+            },
+            {
+              signal: aborter.signal
+            }
+          );
+          (_c = this.socket) == null ? void 0 : _c.addEventListener(
+            "close",
+            () => {
+              aborter.abort();
+              reject(new Error("WebSocket closed before it could connect."));
+            },
+            {
+              signal: aborter.signal
+            }
+          );
+        }
+      );
     });
-    url.searchParams.set("api_key", this.apiKey);
-    url.searchParams.set("cartesia_version", CARTESIA_VERSION);
-    const emitter = new import_emittery2.default();
-    this.socket = new import_partysocket.WebSocket(url.toString());
-    this.socket.onopen = () => {
-      __privateSet(this, _isConnected, true);
-      emitter.emit("open");
-    };
-    this.socket.onclose = () => {
-      __privateSet(this, _isConnected, false);
-      emitter.emit("close");
-    };
-    return new Promise(
-      (resolve, reject) => {
-        var _a, _b, _c;
-        (_a = this.socket) == null ? void 0 : _a.addEventListener(
-          "open",
-          () => {
-            resolve(getEmitteryCallbacks(emitter));
-          },
-          {
-            once: true
-          }
-        );
-        const aborter = new AbortController();
-        (_b = this.socket) == null ? void 0 : _b.addEventListener(
-          "error",
-          () => {
-            aborter.abort();
-            reject(new Error("WebSocket failed to connect."));
-          },
-          {
-            signal: aborter.signal
-          }
-        );
-        (_c = this.socket) == null ? void 0 : _c.addEventListener(
-          "close",
-          () => {
-            aborter.abort();
-            reject(new Error("WebSocket closed before it could connect."));
-          },
-          {
-            signal: aborter.signal
-          }
-        );
-      }
-    );
   }
   /**
    * Disconnect from the Cartesia streaming WebSocket.

package/dist/tts/index.js

@@ -1,8 +1,8 @@
 import {
   TTS
-} from "../chunk-2NA5SEML.js";
-import "../chunk-ASZKHN7Q.js";
-import "../chunk-5M33ZF3Y.js";
+} from "../chunk-NWCW6C7H.js";
+import "../chunk-EUW2435M.js";
+import "../chunk-PISCPZK4.js";
 import "../chunk-2BFEKY3F.js";
 import "../chunk-BHY7MNGT.js";
 import "../chunk-6YQ6KDIQ.js";

package/dist/tts/websocket.cjs

@@ -125,20 +125,25 @@ var constructApiUrl = (baseUrl, path, { websocket = false } = {}) => {
 // src/lib/client.ts
 var Client = class {
   constructor(options = {}) {
-    if (!(options.apiKey || process.env.CARTESIA_API_KEY)) {
+    const apiKey = options.apiKey || process.env.CARTESIA_API_KEY;
+    if (!apiKey) {
       throw new Error("Missing Cartesia API key.");
     }
-    this.apiKey = options.apiKey || process.env.CARTESIA_API_KEY;
+    this.apiKey = typeof apiKey === "function" ? apiKey : () => __async(this, null, function* () {
+      return apiKey;
+    });
     this.baseUrl = options.baseUrl || BASE_URL;
   }
-  fetch(path, options = {}) {
-    const url = constructApiUrl(this.baseUrl, path);
-    return (0, import_cross_fetch.default)(url.toString(), __spreadProps(__spreadValues({}, options), {
-      headers: __spreadValues({
-        "X-API-Key": this.apiKey,
-        "Cartesia-Version": CARTESIA_VERSION
-      }, options.headers)
-    }));
+  _fetch(_0) {
+    return __async(this, arguments, function* (path, options = {}) {
+      const url = constructApiUrl(this.baseUrl, path);
+      const headers = new Headers(options.headers);
+      headers.set("X-API-Key", yield this.apiKey());
+      headers.set("Cartesia-Version", CARTESIA_VERSION);
+      return (0, import_cross_fetch.default)(url.toString(), __spreadProps(__spreadValues({}, options), {
+        headers
+      }));
+    });
   }
 };
 
@@ -476,56 +481,61 @@ var WebSocket = class extends Client {
    * @throws {Error} If the WebSocket fails to connect.
    */
   connect() {
-    const url = constructApiUrl(this.baseUrl, "/tts/websocket", {
-      websocket: true
+    return __async(this, null, function* () {
+      const emitter = new import_emittery2.default();
+      this.socket = new import_partysocket.WebSocket(() => __async(this, null, function* () {
+        const url = constructApiUrl(this.baseUrl, "/tts/websocket", {
+          websocket: true
+        });
+        url.searchParams.set("api_key", yield this.apiKey());
+        url.searchParams.set("cartesia_version", CARTESIA_VERSION);
+        return url.toString();
+      }));
+      this.socket.binaryType = "arraybuffer";
+      this.socket.onopen = () => {
+        __privateSet(this, _isConnected, true);
+        emitter.emit("open");
+      };
+      this.socket.onclose = () => {
+        __privateSet(this, _isConnected, false);
+        emitter.emit("close");
+      };
+      return new Promise(
+        (resolve, reject) => {
+          var _a, _b, _c;
+          (_a = this.socket) == null ? void 0 : _a.addEventListener(
+            "open",
+            () => {
+              resolve(getEmitteryCallbacks(emitter));
+            },
+            {
+              once: true
+            }
+          );
+          const aborter = new AbortController();
+          (_b = this.socket) == null ? void 0 : _b.addEventListener(
+            "error",
+            () => {
+              aborter.abort();
+              reject(new Error("WebSocket failed to connect."));
+            },
+            {
+              signal: aborter.signal
+            }
+          );
+          (_c = this.socket) == null ? void 0 : _c.addEventListener(
+            "close",
+            () => {
+              aborter.abort();
+              reject(new Error("WebSocket closed before it could connect."));
+            },
+            {
+              signal: aborter.signal
+            }
+          );
+        }
+      );
     });
-    url.searchParams.set("api_key", this.apiKey);
-    url.searchParams.set("cartesia_version", CARTESIA_VERSION);
-    const emitter = new import_emittery2.default();
-    this.socket = new import_partysocket.WebSocket(url.toString());
-    this.socket.onopen = () => {
-      __privateSet(this, _isConnected, true);
-      emitter.emit("open");
-    };
-    this.socket.onclose = () => {
-      __privateSet(this, _isConnected, false);
-      emitter.emit("close");
-    };
-    return new Promise(
-      (resolve, reject) => {
-        var _a, _b, _c;
-        (_a = this.socket) == null ? void 0 : _a.addEventListener(
-          "open",
-          () => {
-            resolve(getEmitteryCallbacks(emitter));
-          },
-          {
-            once: true
-          }
-        );
-        const aborter = new AbortController();
-        (_b = this.socket) == null ? void 0 : _b.addEventListener(
-          "error",
-          () => {
-            aborter.abort();
-            reject(new Error("WebSocket failed to connect."));
-          },
-          {
-            signal: aborter.signal
-          }
-        );
-        (_c = this.socket) == null ? void 0 : _c.addEventListener(
-          "close",
-          () => {
-            aborter.abort();
-            reject(new Error("WebSocket closed before it could connect."));
-          },
-          {
-            signal: aborter.signal
-          }
-        );
-      }
-    );
   }
   /**
    * Disconnect from the Cartesia streaming WebSocket.

package/dist/tts/websocket.js

@@ -1,7 +1,7 @@
 import {
   WebSocket
-} from "../chunk-ASZKHN7Q.js";
-import "../chunk-5M33ZF3Y.js";
+} from "../chunk-EUW2435M.js";
+import "../chunk-PISCPZK4.js";
 import "../chunk-2BFEKY3F.js";
 import "../chunk-BHY7MNGT.js";
 import "../chunk-6YQ6KDIQ.js";

package/dist/types/index.d.cts

@@ -1,7 +1,7 @@
 import emittery__default from 'emittery';
 
 interface ClientOptions {
-    apiKey?: string;
+    apiKey?: string | (() => Promise<string>);
     baseUrl?: string;
 }
 type Sentinel = null;
@@ -11,10 +11,10 @@ type ConnectionEventData = {
     close: never;
 };
 type VoiceSpecifier = {
-    mode: "id";
+    mode?: "id";
     id: string;
 } | {
-    mode: "embedding";
+    mode?: "embedding";
     embedding: number[];
 };
 type Emotion = "anger" | "sadness" | "positivity" | "curiosity" | "surprise";
@@ -22,7 +22,7 @@ type Intensity = "lowest" | "low" | "high" | "highest";
 type EmotionControl = Emotion | `${Emotion}:${Intensity}`;
 type VoiceOptions = VoiceSpecifier & {
     __experimental_controls?: {
-        speed?: "slowest" | "slow" | "normal" | "fast" | "fastest";
+        speed?: "slowest" | "slow" | "normal" | "fast" | "fastest" | number;
         emotion?: EmotionControl[];
     };
 };
@@ -77,10 +77,20 @@ type EmitteryCallbacks<T> = {
 type CloneOptions = {
     mode: "url";
     link: string;
+    enhance?: boolean;
 } | {
     mode: "clip";
     clip: Blob;
+    enhance?: boolean;
 };
+interface VoiceToMix {
+    id?: string;
+    embedding?: number[];
+    weight: number;
+}
+interface MixVoicesOptions {
+    voices: VoiceToMix[];
+}
 type Voice = {
     id: string;
     name: string;
@@ -89,11 +99,16 @@ type Voice = {
     is_public: boolean;
     user_id: string;
     created_at: string;
+    language: string;
 };
 type CreateVoice = Pick<Voice, "name" | "description" | "embedding"> & Partial<Omit<Voice, "name" | "description" | "embedding">>;
+type UpdateVoice = Partial<Pick<Voice, "name" | "description" | "embedding">>;
 type CloneResponse = {
     embedding: number[];
 };
+type MixVoicesResponse = {
+    embedding: number[];
+};
 type WebSocketOptions = {
     container?: string;
     encoding?: string;
@@ -108,4 +123,4 @@ type SourceEventData = {
 type TypedArray = Float32Array | Int16Array | Uint8Array;
 type Encoding = "pcm_f32le" | "pcm_s16le" | "pcm_alaw" | "pcm_mulaw";
 
-export type { Chunk, ClientOptions, CloneOptions, CloneResponse, ConnectionEventData, CreateVoice, EmitteryCallbacks, Emotion, EmotionControl, Encoding, Intensity, Sentinel, SourceEventData, StreamOptions, StreamRequest, TypedArray, Voice, VoiceOptions, VoiceSpecifier, WebSocketBaseResponse, WebSocketChunkResponse, WebSocketErrorResponse, WebSocketOptions, WebSocketResponse, WebSocketTimestampsResponse, WordTimestamps };
+export type { Chunk, ClientOptions, CloneOptions, CloneResponse, ConnectionEventData, CreateVoice, EmitteryCallbacks, Emotion, EmotionControl, Encoding, Intensity, MixVoicesOptions, MixVoicesResponse, Sentinel, SourceEventData, StreamOptions, StreamRequest, TypedArray, UpdateVoice, Voice, VoiceOptions, VoiceSpecifier, VoiceToMix, WebSocketBaseResponse, WebSocketChunkResponse, WebSocketErrorResponse, WebSocketOptions, WebSocketResponse, WebSocketTimestampsResponse, WordTimestamps };

package/dist/types/index.d.ts

@@ -1,7 +1,7 @@
 import emittery__default from 'emittery';
 
 interface ClientOptions {
-    apiKey?: string;
+    apiKey?: string | (() => Promise<string>);
     baseUrl?: string;
 }
 type Sentinel = null;
@@ -11,10 +11,10 @@ type ConnectionEventData = {
     close: never;
 };
 type VoiceSpecifier = {
-    mode: "id";
+    mode?: "id";
     id: string;
 } | {
-    mode: "embedding";
+    mode?: "embedding";
     embedding: number[];
 };
 type Emotion = "anger" | "sadness" | "positivity" | "curiosity" | "surprise";
@@ -22,7 +22,7 @@ type Intensity = "lowest" | "low" | "high" | "highest";
 type EmotionControl = Emotion | `${Emotion}:${Intensity}`;
 type VoiceOptions = VoiceSpecifier & {
     __experimental_controls?: {
-        speed?: "slowest" | "slow" | "normal" | "fast" | "fastest";
+        speed?: "slowest" | "slow" | "normal" | "fast" | "fastest" | number;
         emotion?: EmotionControl[];
     };
 };
@@ -77,10 +77,20 @@ type EmitteryCallbacks<T> = {
 type CloneOptions = {
     mode: "url";
     link: string;
+    enhance?: boolean;
 } | {
     mode: "clip";
     clip: Blob;
+    enhance?: boolean;
 };
+interface VoiceToMix {
+    id?: string;
+    embedding?: number[];
+    weight: number;
+}
+interface MixVoicesOptions {
+    voices: VoiceToMix[];
+}
 type Voice = {
     id: string;
     name: string;
@@ -89,11 +99,16 @@ type Voice = {
     is_public: boolean;
     user_id: string;
     created_at: string;
+    language: string;
 };
 type CreateVoice = Pick<Voice, "name" | "description" | "embedding"> & Partial<Omit<Voice, "name" | "description" | "embedding">>;
+type UpdateVoice = Partial<Pick<Voice, "name" | "description" | "embedding">>;
 type CloneResponse = {
     embedding: number[];
 };
+type MixVoicesResponse = {
+    embedding: number[];
+};
 type WebSocketOptions = {
     container?: string;
     encoding?: string;
@@ -108,4 +123,4 @@ type SourceEventData = {
 type TypedArray = Float32Array | Int16Array | Uint8Array;
 type Encoding = "pcm_f32le" | "pcm_s16le" | "pcm_alaw" | "pcm_mulaw";
 
-export type { Chunk, ClientOptions, CloneOptions, CloneResponse, ConnectionEventData, CreateVoice, EmitteryCallbacks, Emotion, EmotionControl, Encoding, Intensity, Sentinel, SourceEventData, StreamOptions, StreamRequest, TypedArray, Voice, VoiceOptions, VoiceSpecifier, WebSocketBaseResponse, WebSocketChunkResponse, WebSocketErrorResponse, WebSocketOptions, WebSocketResponse, WebSocketTimestampsResponse, WordTimestamps };
+export type { Chunk, ClientOptions, CloneOptions, CloneResponse, ConnectionEventData, CreateVoice, EmitteryCallbacks, Emotion, EmotionControl, Encoding, Intensity, MixVoicesOptions, MixVoicesResponse, Sentinel, SourceEventData, StreamOptions, StreamRequest, TypedArray, UpdateVoice, Voice, VoiceOptions, VoiceSpecifier, VoiceToMix, WebSocketBaseResponse, WebSocketChunkResponse, WebSocketErrorResponse, WebSocketOptions, WebSocketResponse, WebSocketTimestampsResponse, WordTimestamps };

package/dist/voices/index.cjs

@@ -88,20 +88,25 @@ var constructApiUrl = (baseUrl, path, { websocket = false } = {}) => {
 // src/lib/client.ts
 var Client = class {
   constructor(options = {}) {
-    if (!(options.apiKey || process.env.CARTESIA_API_KEY)) {
+    const apiKey = options.apiKey || process.env.CARTESIA_API_KEY;
+    if (!apiKey) {
       throw new Error("Missing Cartesia API key.");
     }
-    this.apiKey = options.apiKey || process.env.CARTESIA_API_KEY;
+    this.apiKey = typeof apiKey === "function" ? apiKey : () => __async(this, null, function* () {
+      return apiKey;
+    });
     this.baseUrl = options.baseUrl || BASE_URL;
   }
-  fetch(path, options = {}) {
-    const url = constructApiUrl(this.baseUrl, path);
-    return (0, import_cross_fetch.default)(url.toString(), __spreadProps(__spreadValues({}, options), {
-      headers: __spreadValues({
-        "X-API-Key": this.apiKey,
-        "Cartesia-Version": CARTESIA_VERSION
-      }, options.headers)
-    }));
+  _fetch(_0) {
+    return __async(this, arguments, function* (path, options = {}) {
+      const url = constructApiUrl(this.baseUrl, path);
+      const headers = new Headers(options.headers);
+      headers.set("X-API-Key", yield this.apiKey());
+      headers.set("Cartesia-Version", CARTESIA_VERSION);
+      return (0, import_cross_fetch.default)(url.toString(), __spreadProps(__spreadValues({}, options), {
+        headers
+      }));
+    });
   }
 };
 
@@ -109,40 +114,43 @@ var Client = class {
 var Voices = class extends Client {
   list() {
     return __async(this, null, function* () {
-      const response = yield this.fetch("/voices");
+      const response = yield this._fetch("/voices");
       return response.json();
     });
   }
   get(voiceId) {
     return __async(this, null, function* () {
-      const response = yield this.fetch(`/voices/${voiceId}`);
+      const response = yield this._fetch(`/voices/${voiceId}`);
       return response.json();
     });
   }
   create(voice) {
     return __async(this, null, function* () {
-      const response = yield this.fetch("/voices", {
+      const response = yield this._fetch("/voices", {
         method: "POST",
         body: JSON.stringify(voice)
       });
       return response.json();
     });
   }
+  update(id, voice) {
+    return __async(this, null, function* () {
+      const response = yield this._fetch(`/voices/${id}`, {
+        method: "PATCH",
+        body: JSON.stringify(voice)
+      });
+      return response.json();
+    });
+  }
   clone(options) {
     return __async(this, null, function* () {
-      if (options.mode === "url") {
-        const response = yield this.fetch(
-          `/voices/clone/url?link=${options.link}`,
-          {
-            method: "POST"
-          }
-        );
-        return response.json();
-      }
       if (options.mode === "clip") {
         const formData = new FormData();
         formData.append("clip", options.clip);
-        const response = yield this.fetch("/voices/clone/clip", {
+        if (options.enhance !== void 0) {
+          formData.append("enhance", options.enhance.toString());
+        }
+        const response = yield this._fetch("/voices/clone/clip", {
           method: "POST",
           body: formData
         });
@@ -151,4 +159,14 @@ var Voices = class extends Client {
       throw new Error("Invalid mode for clone()");
     });
   }
+  mix(options) {
+    return __async(this, null, function* () {
+      const request = options;
+      const response = yield this._fetch("/voices/mix", {
+        method: "POST",
+        body: JSON.stringify(request)
+      });
+      return response.json();
+    });
+  }
 };

package/dist/voices/index.d.cts

@@ -1,12 +1,14 @@
 import { Client } from '../lib/client.cjs';
-import { Voice, CreateVoice, CloneOptions, CloneResponse } from '../types/index.cjs';
+import { Voice, CreateVoice, UpdateVoice, CloneOptions, CloneResponse, MixVoicesOptions, MixVoicesResponse } from '../types/index.cjs';
 import 'emittery';
 
 declare class Voices extends Client {
     list(): Promise<Voice[]>;
     get(voiceId: string): Promise<Voice>;
     create(voice: CreateVoice): Promise<Voice>;
+    update(id: string, voice: UpdateVoice): Promise<Voice>;
     clone(options: CloneOptions): Promise<CloneResponse>;
+    mix(options: MixVoicesOptions): Promise<MixVoicesResponse>;
 }
 
 export { Voices as default };

package/dist/voices/index.d.ts

@@ -1,12 +1,14 @@
 import { Client } from '../lib/client.js';
-import { Voice, CreateVoice, CloneOptions, CloneResponse } from '../types/index.js';
+import { Voice, CreateVoice, UpdateVoice, CloneOptions, CloneResponse, MixVoicesOptions, MixVoicesResponse } from '../types/index.js';
 import 'emittery';
 
 declare class Voices extends Client {
     list(): Promise<Voice[]>;
     get(voiceId: string): Promise<Voice>;
     create(voice: CreateVoice): Promise<Voice>;
+    update(id: string, voice: UpdateVoice): Promise<Voice>;
     clone(options: CloneOptions): Promise<CloneResponse>;
+    mix(options: MixVoicesOptions): Promise<MixVoicesResponse>;
 }
 
 export { Voices as default };

package/dist/voices/index.js

@@ -1,7 +1,7 @@
 import {
   Voices
-} from "../chunk-KUSVZXDT.js";
-import "../chunk-5M33ZF3Y.js";
+} from "../chunk-YFN6TFR4.js";
+import "../chunk-PISCPZK4.js";
 import "../chunk-2BFEKY3F.js";
 import "../chunk-GHY2WEOK.js";
 export {

package/package.json

@@ -4,7 +4,7 @@
 		"name": "Cartesia",
 		"url": "https://cartesia.ai"
 	},
-	"version": "1.0.1",
+	"version": "1.0.3",
 	"description": "Client for the Cartesia API.",
 	"type": "module",
 	"module": "./dist/index.js",

package/src/lib/client.ts

@@ -3,29 +3,29 @@ import type { ClientOptions } from "../types";
 import { BASE_URL, CARTESIA_VERSION, constructApiUrl } from "./constants";
 
 export class Client {
-	apiKey: string;
+	apiKey: () => Promise<string>;
 	baseUrl: string;
 
 	constructor(options: ClientOptions = {}) {
-		if (!(options.apiKey || process.env.CARTESIA_API_KEY)) {
+		const apiKey = options.apiKey || process.env.CARTESIA_API_KEY;
+		if (!apiKey) {
 			throw new Error("Missing Cartesia API key.");
 		}
 
-		// biome-ignore lint/style/noNonNullAssertion: Guaranteed to be defined by the check above.
-		this.apiKey = (options.apiKey || process.env.CARTESIA_API_KEY)!;
+		this.apiKey = typeof apiKey === "function" ? apiKey : async () => apiKey;
 		this.baseUrl = options.baseUrl || BASE_URL;
 	}
 
-	fetch(path: string, options: RequestInit = {}) {
+	protected async _fetch(path: string, options: RequestInit = {}) {
 		const url = constructApiUrl(this.baseUrl, path);
+		const headers = new Headers(options.headers);
+
+		headers.set("X-API-Key", await this.apiKey());
+		headers.set("Cartesia-Version", CARTESIA_VERSION);
 
 		return fetch(url.toString(), {
 			...options,
-			headers: {
-				"X-API-Key": this.apiKey,
-				"Cartesia-Version": CARTESIA_VERSION,
-				...options.headers,
-			},
+			headers,
 		});
 	}
 }