telnyx 6.8.2 → 6.10.0

package/resources/voice-designs.d.ts

@@ -0,0 +1,312 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { DefaultFlatPagination, type DefaultFlatPaginationParams, PagePromise } from "../core/pagination.js";
+import { RequestOptions } from "../internal/request-options.js";
+/**
+ * Create and manage AI-generated voice designs using natural language prompts.
+ */
+export declare class VoiceDesigns extends APIResource {
+    /**
+     * Creates a new voice design (version 1) when `voice_design_id` is omitted. When
+     * `voice_design_id` is provided, adds a new version to the existing design
+     * instead. A design can have at most 50 versions.
+     *
+     * @example
+     * ```ts
+     * const voiceDesign = await client.voiceDesigns.create({
+     *   prompt: 'Speak in a warm, friendly tone',
+     *   text: 'Hello, welcome to our service.',
+     * });
+     * ```
+     */
+    create(body: VoiceDesignCreateParams, options?: RequestOptions): APIPromise<VoiceDesignCreateResponse>;
+    /**
+     * Returns the latest version of a voice design, or a specific version when
+     * `?version=N` is provided. The `id` parameter accepts either a UUID or the design
+     * name.
+     *
+     * @example
+     * ```ts
+     * const voiceDesign = await client.voiceDesigns.retrieve(
+     *   'id',
+     * );
+     * ```
+     */
+    retrieve(id: string, query?: VoiceDesignRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<VoiceDesignRetrieveResponse>;
+    /**
+     * Returns a paginated list of voice designs belonging to the authenticated
+     * account.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const voiceDesignListResponse of client.voiceDesigns.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query?: VoiceDesignListParams | null | undefined, options?: RequestOptions): PagePromise<VoiceDesignListResponsesDefaultFlatPagination, VoiceDesignListResponse>;
+    /**
+     * Permanently deletes a voice design and all of its versions. This action cannot
+     * be undone.
+     *
+     * @example
+     * ```ts
+     * await client.voiceDesigns.delete('id');
+     * ```
+     */
+    delete(id: string, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Permanently deletes a specific version of a voice design. The version number
+     * must be a positive integer.
+     *
+     * @example
+     * ```ts
+     * await client.voiceDesigns.deleteVersion(1, { id: 'id' });
+     * ```
+     */
+    deleteVersion(version: number, params: VoiceDesignDeleteVersionParams, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Downloads the WAV audio sample for the voice design. Returns the latest
+     * version's sample by default, or a specific version when `?version=N` is
+     * provided. The `id` parameter accepts either a UUID or the design name.
+     *
+     * @example
+     * ```ts
+     * const response = await client.voiceDesigns.downloadSample(
+     *   'id',
+     * );
+     *
+     * const content = await response.blob();
+     * console.log(content);
+     * ```
+     */
+    downloadSample(id: string, query?: VoiceDesignDownloadSampleParams | null | undefined, options?: RequestOptions): APIPromise<Response>;
+    /**
+     * Updates the name of a voice design. All versions retain their other properties.
+     *
+     * @example
+     * ```ts
+     * const response = await client.voiceDesigns.rename('id', {
+     *   name: 'updated-narrator',
+     * });
+     * ```
+     */
+    rename(id: string, body: VoiceDesignRenameParams, options?: RequestOptions): APIPromise<VoiceDesignRenameResponse>;
+}
+export type VoiceDesignListResponsesDefaultFlatPagination = DefaultFlatPagination<VoiceDesignListResponse>;
+/**
+ * A voice design object with full version detail.
+ */
+export interface VoiceDesignData {
+    /**
+     * Unique identifier for the voice design.
+     */
+    id?: string;
+    /**
+     * Timestamp when the voice design was first created.
+     */
+    created_at?: string;
+    /**
+     * Name of the voice design.
+     */
+    name?: string;
+    /**
+     * Natural language prompt used to define the voice style for this version.
+     */
+    prompt?: string;
+    /**
+     * Identifies the resource type.
+     */
+    record_type?: 'voice_design';
+    /**
+     * Sample text used to synthesize this version.
+     */
+    text?: string;
+    /**
+     * Timestamp when the voice design was last updated.
+     */
+    updated_at?: string;
+    /**
+     * Version number of this voice design.
+     */
+    version?: number;
+    /**
+     * Timestamp when this specific version was created.
+     */
+    version_created_at?: string;
+    /**
+     * Size of the voice sample audio in bytes.
+     */
+    voice_sample_size?: number;
+}
+/**
+ * Response envelope for a single voice design with full version detail.
+ */
+export interface VoiceDesignCreateResponse {
+    /**
+     * A voice design object with full version detail.
+     */
+    data?: VoiceDesignData;
+}
+/**
+ * Response envelope for a single voice design with full version detail.
+ */
+export interface VoiceDesignRetrieveResponse {
+    /**
+     * A voice design object with full version detail.
+     */
+    data?: VoiceDesignData;
+}
+/**
+ * A summarized voice design object (without version-specific fields).
+ */
+export interface VoiceDesignListResponse {
+    /**
+     * Unique identifier for the voice design.
+     */
+    id?: string;
+    /**
+     * Timestamp when the voice design was first created.
+     */
+    created_at?: string;
+    /**
+     * Name of the voice design.
+     */
+    name?: string;
+    /**
+     * Identifies the resource type.
+     */
+    record_type?: 'voice_design';
+    /**
+     * Timestamp when the voice design was last updated.
+     */
+    updated_at?: string;
+}
+/**
+ * Response envelope for a voice design after a rename operation (no
+ * version-specific fields).
+ */
+export interface VoiceDesignRenameResponse {
+    /**
+     * A summarized voice design object (without version-specific fields).
+     */
+    data?: VoiceDesignRenameResponse.Data;
+}
+export declare namespace VoiceDesignRenameResponse {
+    /**
+     * A summarized voice design object (without version-specific fields).
+     */
+    interface Data {
+        /**
+         * Unique identifier for the voice design.
+         */
+        id?: string;
+        /**
+         * Timestamp when the voice design was first created.
+         */
+        created_at?: string;
+        /**
+         * Name of the voice design.
+         */
+        name?: string;
+        /**
+         * Identifies the resource type.
+         */
+        record_type?: 'voice_design';
+        /**
+         * Timestamp when the voice design was last updated.
+         */
+        updated_at?: string;
+    }
+}
+export interface VoiceDesignCreateParams {
+    /**
+     * Natural language description of the voice style, e.g. 'Speak in a warm, friendly
+     * tone with a slight British accent'.
+     */
+    prompt: string;
+    /**
+     * Sample text to synthesize for this voice design.
+     */
+    text: string;
+    /**
+     * Language for synthesis. Supported values: Auto, Chinese, English, Japanese,
+     * Korean, German, French, Russian, Portuguese, Spanish, Italian. Defaults to Auto.
+     */
+    language?: string;
+    /**
+     * Maximum number of tokens to generate. Default: 2048.
+     */
+    max_new_tokens?: number;
+    /**
+     * Name for the voice design. Required when creating a new design
+     * (`voice_design_id` is not provided); ignored when adding a version. Cannot be a
+     * UUID.
+     */
+    name?: string;
+    /**
+     * Repetition penalty to reduce repeated patterns in generated audio. Default:
+     * 1.05.
+     */
+    repetition_penalty?: number;
+    /**
+     * Sampling temperature controlling randomness. Higher values produce more varied
+     * output. Default: 0.9.
+     */
+    temperature?: number;
+    /**
+     * Top-k sampling parameter — limits the token vocabulary considered at each step.
+     * Default: 50.
+     */
+    top_k?: number;
+    /**
+     * Top-p (nucleus) sampling parameter — cumulative probability cutoff for token
+     * selection. Default: 1.0.
+     */
+    top_p?: number;
+    /**
+     * ID of an existing voice design to add a new version to. When provided, a new
+     * version is created instead of a new design.
+     */
+    voice_design_id?: string;
+}
+export interface VoiceDesignRetrieveParams {
+    /**
+     * Specific version number to retrieve. Defaults to the latest version.
+     */
+    version?: number;
+}
+export interface VoiceDesignListParams extends DefaultFlatPaginationParams {
+    /**
+     * Case-insensitive substring filter on the name field.
+     */
+    'filter[name]'?: string;
+    /**
+     * Sort order. Prefix with `-` for descending. Defaults to `-created_at`.
+     */
+    sort?: 'name' | '-name' | 'created_at' | '-created_at';
+}
+export interface VoiceDesignDeleteVersionParams {
+    /**
+     * The voice design UUID or name.
+     */
+    id: string;
+}
+export interface VoiceDesignDownloadSampleParams {
+    /**
+     * Specific version number to download the sample for. Defaults to the latest
+     * version.
+     */
+    version?: number;
+}
+export interface VoiceDesignRenameParams {
+    /**
+     * New name for the voice design.
+     */
+    name: string;
+}
+export declare namespace VoiceDesigns {
+    export { type VoiceDesignData as VoiceDesignData, type VoiceDesignCreateResponse as VoiceDesignCreateResponse, type VoiceDesignRetrieveResponse as VoiceDesignRetrieveResponse, type VoiceDesignListResponse as VoiceDesignListResponse, type VoiceDesignRenameResponse as VoiceDesignRenameResponse, type VoiceDesignListResponsesDefaultFlatPagination as VoiceDesignListResponsesDefaultFlatPagination, type VoiceDesignCreateParams as VoiceDesignCreateParams, type VoiceDesignRetrieveParams as VoiceDesignRetrieveParams, type VoiceDesignListParams as VoiceDesignListParams, type VoiceDesignDeleteVersionParams as VoiceDesignDeleteVersionParams, type VoiceDesignDownloadSampleParams as VoiceDesignDownloadSampleParams, type VoiceDesignRenameParams as VoiceDesignRenameParams, };
+}
+//# sourceMappingURL=voice-designs.d.ts.map

package/resources/voice-designs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-designs.d.ts","sourceRoot":"","sources":["../src/resources/voice-designs.ts"],"names":[],"mappings":"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"}

package/resources/voice-designs.js

@@ -0,0 +1,131 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VoiceDesigns = void 0;
+const resource_1 = require("../core/resource.js");
+const pagination_1 = require("../core/pagination.js");
+const headers_1 = require("../internal/headers.js");
+const path_1 = require("../internal/utils/path.js");
+/**
+ * Create and manage AI-generated voice designs using natural language prompts.
+ */
+class VoiceDesigns extends resource_1.APIResource {
+    /**
+     * Creates a new voice design (version 1) when `voice_design_id` is omitted. When
+     * `voice_design_id` is provided, adds a new version to the existing design
+     * instead. A design can have at most 50 versions.
+     *
+     * @example
+     * ```ts
+     * const voiceDesign = await client.voiceDesigns.create({
+     *   prompt: 'Speak in a warm, friendly tone',
+     *   text: 'Hello, welcome to our service.',
+     * });
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/voice_designs', { body, ...options });
+    }
+    /**
+     * Returns the latest version of a voice design, or a specific version when
+     * `?version=N` is provided. The `id` parameter accepts either a UUID or the design
+     * name.
+     *
+     * @example
+     * ```ts
+     * const voiceDesign = await client.voiceDesigns.retrieve(
+     *   'id',
+     * );
+     * ```
+     */
+    retrieve(id, query = {}, options) {
+        return this._client.get((0, path_1.path) `/voice_designs/${id}`, { query, ...options });
+    }
+    /**
+     * Returns a paginated list of voice designs belonging to the authenticated
+     * account.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const voiceDesignListResponse of client.voiceDesigns.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/voice_designs', (pagination_1.DefaultFlatPagination), {
+            query,
+            ...options,
+        });
+    }
+    /**
+     * Permanently deletes a voice design and all of its versions. This action cannot
+     * be undone.
+     *
+     * @example
+     * ```ts
+     * await client.voiceDesigns.delete('id');
+     * ```
+     */
+    delete(id, options) {
+        return this._client.delete((0, path_1.path) `/voice_designs/${id}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Permanently deletes a specific version of a voice design. The version number
+     * must be a positive integer.
+     *
+     * @example
+     * ```ts
+     * await client.voiceDesigns.deleteVersion(1, { id: 'id' });
+     * ```
+     */
+    deleteVersion(version, params, options) {
+        const { id } = params;
+        return this._client.delete((0, path_1.path) `/voice_designs/${id}/versions/${version}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Downloads the WAV audio sample for the voice design. Returns the latest
+     * version's sample by default, or a specific version when `?version=N` is
+     * provided. The `id` parameter accepts either a UUID or the design name.
+     *
+     * @example
+     * ```ts
+     * const response = await client.voiceDesigns.downloadSample(
+     *   'id',
+     * );
+     *
+     * const content = await response.blob();
+     * console.log(content);
+     * ```
+     */
+    downloadSample(id, query = {}, options) {
+        return this._client.get((0, path_1.path) `/voice_designs/${id}/sample`, {
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: 'audio/wav' }, options?.headers]),
+            __binaryResponse: true,
+        });
+    }
+    /**
+     * Updates the name of a voice design. All versions retain their other properties.
+     *
+     * @example
+     * ```ts
+     * const response = await client.voiceDesigns.rename('id', {
+     *   name: 'updated-narrator',
+     * });
+     * ```
+     */
+    rename(id, body, options) {
+        return this._client.patch((0, path_1.path) `/voice_designs/${id}`, { body, ...options });
+    }
+}
+exports.VoiceDesigns = VoiceDesigns;
+//# sourceMappingURL=voice-designs.js.map

package/resources/voice-designs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-designs.js","sourceRoot":"","sources":["../src/resources/voice-designs.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAE/C,sDAA0G;AAC1G,oDAAmD;AAEnD,oDAA8C;AAE9C;;GAEG;AACH,MAAa,YAAa,SAAQ,sBAAW;IAC3C;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAA6B,EAAE,OAAwB;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;IAED;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,EAAU,EACV,QAAsD,EAAE,EACxD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,kBAAkB,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;;;;;;;OAWG;IACH,IAAI,CACF,QAAkD,EAAE,EACpD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAA,kCAA8C,CAAA,EAAE;YAC/F,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,kBAAkB,EAAE,EAAE,EAAE;YACrD,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,aAAa,CACX,OAAe,EACf,MAAsC,EACtC,OAAwB;QAExB,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,kBAAkB,EAAE,aAAa,OAAO,EAAE,EAAE;YACzE,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,cAAc,CACZ,EAAU,EACV,QAA4D,EAAE,EAC9D,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,kBAAkB,EAAE,SAAS,EAAE;YACzD,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAClE,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CACJ,EAAU,EACV,IAA6B,EAC7B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,kBAAkB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9E,CAAC;CACF;AA9ID,oCA8IC"}

package/resources/voice-designs.mjs

@@ -0,0 +1,127 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+import { DefaultFlatPagination } from "../core/pagination.mjs";
+import { buildHeaders } from "../internal/headers.mjs";
+import { path } from "../internal/utils/path.mjs";
+/**
+ * Create and manage AI-generated voice designs using natural language prompts.
+ */
+export class VoiceDesigns extends APIResource {
+    /**
+     * Creates a new voice design (version 1) when `voice_design_id` is omitted. When
+     * `voice_design_id` is provided, adds a new version to the existing design
+     * instead. A design can have at most 50 versions.
+     *
+     * @example
+     * ```ts
+     * const voiceDesign = await client.voiceDesigns.create({
+     *   prompt: 'Speak in a warm, friendly tone',
+     *   text: 'Hello, welcome to our service.',
+     * });
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/voice_designs', { body, ...options });
+    }
+    /**
+     * Returns the latest version of a voice design, or a specific version when
+     * `?version=N` is provided. The `id` parameter accepts either a UUID or the design
+     * name.
+     *
+     * @example
+     * ```ts
+     * const voiceDesign = await client.voiceDesigns.retrieve(
+     *   'id',
+     * );
+     * ```
+     */
+    retrieve(id, query = {}, options) {
+        return this._client.get(path `/voice_designs/${id}`, { query, ...options });
+    }
+    /**
+     * Returns a paginated list of voice designs belonging to the authenticated
+     * account.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const voiceDesignListResponse of client.voiceDesigns.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/voice_designs', (DefaultFlatPagination), {
+            query,
+            ...options,
+        });
+    }
+    /**
+     * Permanently deletes a voice design and all of its versions. This action cannot
+     * be undone.
+     *
+     * @example
+     * ```ts
+     * await client.voiceDesigns.delete('id');
+     * ```
+     */
+    delete(id, options) {
+        return this._client.delete(path `/voice_designs/${id}`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Permanently deletes a specific version of a voice design. The version number
+     * must be a positive integer.
+     *
+     * @example
+     * ```ts
+     * await client.voiceDesigns.deleteVersion(1, { id: 'id' });
+     * ```
+     */
+    deleteVersion(version, params, options) {
+        const { id } = params;
+        return this._client.delete(path `/voice_designs/${id}/versions/${version}`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Downloads the WAV audio sample for the voice design. Returns the latest
+     * version's sample by default, or a specific version when `?version=N` is
+     * provided. The `id` parameter accepts either a UUID or the design name.
+     *
+     * @example
+     * ```ts
+     * const response = await client.voiceDesigns.downloadSample(
+     *   'id',
+     * );
+     *
+     * const content = await response.blob();
+     * console.log(content);
+     * ```
+     */
+    downloadSample(id, query = {}, options) {
+        return this._client.get(path `/voice_designs/${id}/sample`, {
+            query,
+            ...options,
+            headers: buildHeaders([{ Accept: 'audio/wav' }, options?.headers]),
+            __binaryResponse: true,
+        });
+    }
+    /**
+     * Updates the name of a voice design. All versions retain their other properties.
+     *
+     * @example
+     * ```ts
+     * const response = await client.voiceDesigns.rename('id', {
+     *   name: 'updated-narrator',
+     * });
+     * ```
+     */
+    rename(id, body, options) {
+        return this._client.patch(path `/voice_designs/${id}`, { body, ...options });
+    }
+}
+//# sourceMappingURL=voice-designs.mjs.map

package/resources/voice-designs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-designs.mjs","sourceRoot":"","sources":["../src/resources/voice-designs.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,EAAE,qBAAqB,EAAiD;OACxE,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,WAAW;IAC3C;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAA6B,EAAE,OAAwB;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;IAED;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,EAAU,EACV,QAAsD,EAAE,EACxD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,kBAAkB,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;;;;;;;OAWG;IACH,IAAI,CACF,QAAkD,EAAE,EACpD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAA,qBAA8C,CAAA,EAAE;YAC/F,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,kBAAkB,EAAE,EAAE,EAAE;YACrD,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,aAAa,CACX,OAAe,EACf,MAAsC,EACtC,OAAwB;QAExB,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,kBAAkB,EAAE,aAAa,OAAO,EAAE,EAAE;YACzE,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,cAAc,CACZ,EAAU,EACV,QAA4D,EAAE,EAC9D,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,kBAAkB,EAAE,SAAS,EAAE;YACzD,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAClE,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CACJ,EAAU,EACV,IAA6B,EAC7B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,kBAAkB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9E,CAAC;CACF"}

package/src/client.ts

@@ -902,6 +902,33 @@ import {
   VirtualCrossConnectsCoverageListResponse,
   VirtualCrossConnectsCoverageListResponsesDefaultFlatPagination,
 } from './resources/virtual-cross-connects-coverage';
+import {
+  VoiceCloneCreateFromUploadParams,
+  VoiceCloneCreateFromUploadResponse,
+  VoiceCloneCreateParams,
+  VoiceCloneCreateResponse,
+  VoiceCloneData,
+  VoiceCloneDataDefaultFlatPagination,
+  VoiceCloneListParams,
+  VoiceCloneUpdateParams,
+  VoiceCloneUpdateResponse,
+  VoiceClones,
+} from './resources/voice-clones';
+import {
+  VoiceDesignCreateParams,
+  VoiceDesignCreateResponse,
+  VoiceDesignData,
+  VoiceDesignDeleteVersionParams,
+  VoiceDesignDownloadSampleParams,
+  VoiceDesignListParams,
+  VoiceDesignListResponse,
+  VoiceDesignListResponsesDefaultFlatPagination,
+  VoiceDesignRenameParams,
+  VoiceDesignRenameResponse,
+  VoiceDesignRetrieveParams,
+  VoiceDesignRetrieveResponse,
+  VoiceDesigns,
+} from './resources/voice-designs';
 import {
   Attempt,
   HTTP,
@@ -2818,6 +2845,14 @@ export class Telnyx {
    * Manage Whatsapp message templates
    */
   whatsappMessageTemplates: API.WhatsappMessageTemplates = new API.WhatsappMessageTemplates(this);
+  /**
+   * Capture and manage voice identities as clones for use in text-to-speech synthesis.
+   */
+  voiceClones: API.VoiceClones = new API.VoiceClones(this);
+  /**
+   * Create and manage AI-generated voice designs using natural language prompts.
+   */
+  voiceDesigns: API.VoiceDesigns = new API.VoiceDesigns(this);
 }
 
 Telnyx.Legacy = Legacy;
@@ -2975,6 +3010,8 @@ Telnyx.MessagingProfileMetrics = MessagingProfileMetrics;
 Telnyx.SessionAnalysis = SessionAnalysis;
 Telnyx.Whatsapp = Whatsapp;
 Telnyx.WhatsappMessageTemplates = WhatsappMessageTemplates;
+Telnyx.VoiceClones = VoiceClones;
+Telnyx.VoiceDesigns = VoiceDesigns;
 
 export declare namespace Telnyx {
   export type RequestOptions = Opts.RequestOptions;
@@ -4643,6 +4680,35 @@ export declare namespace Telnyx {
     type WhatsappMessageTemplateUpdateParams as WhatsappMessageTemplateUpdateParams,
   };
 
+  export {
+    VoiceClones as VoiceClones,
+    type VoiceCloneData as VoiceCloneData,
+    type VoiceCloneCreateResponse as VoiceCloneCreateResponse,
+    type VoiceCloneUpdateResponse as VoiceCloneUpdateResponse,
+    type VoiceCloneCreateFromUploadResponse as VoiceCloneCreateFromUploadResponse,
+    type VoiceCloneDataDefaultFlatPagination as VoiceCloneDataDefaultFlatPagination,
+    type VoiceCloneCreateParams as VoiceCloneCreateParams,
+    type VoiceCloneUpdateParams as VoiceCloneUpdateParams,
+    type VoiceCloneListParams as VoiceCloneListParams,
+    type VoiceCloneCreateFromUploadParams as VoiceCloneCreateFromUploadParams,
+  };
+
+  export {
+    VoiceDesigns as VoiceDesigns,
+    type VoiceDesignData as VoiceDesignData,
+    type VoiceDesignCreateResponse as VoiceDesignCreateResponse,
+    type VoiceDesignRetrieveResponse as VoiceDesignRetrieveResponse,
+    type VoiceDesignListResponse as VoiceDesignListResponse,
+    type VoiceDesignRenameResponse as VoiceDesignRenameResponse,
+    type VoiceDesignListResponsesDefaultFlatPagination as VoiceDesignListResponsesDefaultFlatPagination,
+    type VoiceDesignCreateParams as VoiceDesignCreateParams,
+    type VoiceDesignRetrieveParams as VoiceDesignRetrieveParams,
+    type VoiceDesignListParams as VoiceDesignListParams,
+    type VoiceDesignDeleteVersionParams as VoiceDesignDeleteVersionParams,
+    type VoiceDesignDownloadSampleParams as VoiceDesignDownloadSampleParams,
+    type VoiceDesignRenameParams as VoiceDesignRenameParams,
+  };
+
   export type APIError = API.APIError;
   export type AvailablePhoneNumbersMetadata = API.AvailablePhoneNumbersMetadata;
   export type AzureVoiceSettings = API.AzureVoiceSettings;