@ai-sdk/hume 3.0.64 → 3.0.66

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @ai-sdk/hume
 
+## 3.0.66
+
+### Patch Changes
+
+- Updated dependencies [10026d1]
+  - @ai-sdk/provider@4.0.32
+  - @ai-sdk/provider-utils@5.0.66
+
+## 3.0.65
+
+### Patch Changes
+
+- 489a00d: Defer construction of provider validation schemas until first use to reduce package import time.
+- Updated dependencies [b089ce8]
+- Updated dependencies [39a776b]
+  - @ai-sdk/provider-utils@5.0.65
+
 ## 3.0.64
 
 ### Patch Changes

package/dist/index.d.ts

@@ -1,6 +1,5 @@
 import { ProviderV4, SpeechModelV4 } from "@ai-sdk/provider";
-import { FetchFunction, WORKFLOW_DESERIALIZE, WORKFLOW_SERIALIZE } from "@ai-sdk/provider-utils";
-import { z } from "zod/v4";
+import { FetchFunction, InferSchema, WORKFLOW_DESERIALIZE, WORKFLOW_SERIALIZE } from "@ai-sdk/provider-utils";
 //#region src/hume-config.d.ts
 type HumeConfig = {
   provider: string;
@@ -72,32 +71,26 @@ export declare function createHume(options?: HumeProviderSettings): HumeProvider
 export declare const hume: HumeProvider;
 //#endregion
 //#region src/hume-speech-model-options.d.ts
-declare const humeSpeechModelOptionsSchema: z.ZodObject<{
-  context: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodObject<{
-    generationId: z.ZodString;
-  }, z.core.$strip>, z.ZodObject<{
-    utterances: z.ZodArray<z.ZodObject<{
-      text: z.ZodString;
-      description: z.ZodOptional<z.ZodString>;
-      speed: z.ZodOptional<z.ZodNumber>;
-      trailingSilence: z.ZodOptional<z.ZodNumber>;
-      voice: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
-        id: z.ZodString;
-        provider: z.ZodOptional<z.ZodEnum<{
-          HUME_AI: "HUME_AI";
-          CUSTOM_VOICE: "CUSTOM_VOICE";
-        }>>;
-      }, z.core.$strip>, z.ZodObject<{
-        name: z.ZodString;
-        provider: z.ZodOptional<z.ZodEnum<{
-          HUME_AI: "HUME_AI";
-          CUSTOM_VOICE: "CUSTOM_VOICE";
-        }>>;
-      }, z.core.$strip>]>>;
-    }, z.core.$strip>>;
-  }, z.core.$strip>]>>>;
-}, z.core.$strip>;
-type HumeSpeechModelOptions = z.infer<typeof humeSpeechModelOptionsSchema>;
+declare const humeSpeechModelOptionsSchema: import("@ai-sdk/provider-utils").LazySchema<{
+  context?: {
+    generationId: string;
+  } | {
+    utterances: {
+      text: string;
+      description?: string | undefined;
+      speed?: number | undefined;
+      trailingSilence?: number | undefined;
+      voice?: {
+        id: string;
+        provider?: "HUME_AI" | "CUSTOM_VOICE" | undefined;
+      } | {
+        name: string;
+        provider?: "HUME_AI" | "CUSTOM_VOICE" | undefined;
+      } | undefined;
+    }[];
+  } | null | undefined;
+}>;
+type HumeSpeechModelOptions = InferSchema<typeof humeSpeechModelOptionsSchema>;
 //#endregion
 //#region src/version.d.ts
 export declare const VERSION: string;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/hume-config.ts","../src/hume-speech-model.ts","../src/hume-provider.ts","../src/hume-speech-model-options.ts","../src/version.ts"],"mappings":";;;;KAEY;EACV;EACA,MAAM;IAAW;IAAiB;;EAClC,gBAAgB;EAChB,QAAQ;EACR;;;;UCQQ,8BAA8B;EACtC;IACE,oBAAoB;;;cAIX,2BAA2B;WAsB3B;mBACQ;WAtBV;MAEL;UAII,oBAAoB,OAAO;;;;UAO3B,sBAAsB;IAC5B;IACA,QAAQ;MACT;EAKU,YAAA,aACQ,QAAQ;UAGb;EAgGR,WACJ,SAAS,WAAW,kCACnB,QAAQ,QAAQ,WAAW;;;;UCpIf,qBAAqB;GACnC;IACC,QAAQ;;;;;EAMV,UAAU;;UAGK;;;;EAIf;;;;EAKA,UAAU;;;;;EAMV,QAAQ;;;;;wBAMM,WAAW,UAAS,uBAA4B;;;;qBA8DnD,MAAI;;;cCxGJ,8BAA4B,EAAA;;;;;;;;;;;;;;;;;;;;;;;;GAqEvC,EAAA,KAAA;KAEU,yBAAyB,EAAE,aAC9B;;;qBCzEI"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/hume-config.ts","../src/hume-speech-model.ts","../src/hume-provider.ts","../src/hume-speech-model-options.ts","../src/version.ts"],"mappings":";;;KAEY;EACV;EACA,MAAM;IAAW;IAAiB;;EAClC,gBAAgB;EAChB,QAAQ;EACR;;;;UCQQ,8BAA8B;EACtC;IACE,oBAAoB;;;cAIX,2BAA2B;WAsB3B;mBACQ;WAtBV;MAEL;UAII,oBAAoB,OAAO;;;;UAO3B,sBAAsB;IAC5B;IACA,QAAQ;MACT;EAKU,YAAA,aACQ,QAAQ;UAGb;EAgGR,WACJ,SAAS,WAAW,kCACnB,QAAQ,QAAQ,WAAW;;;;UCpIf,qBAAqB;GACnC;IACC,QAAQ;;;;;EAMV,UAAU;;UAGK;;;;EAIf;;;;EAKA,UAAU;;;;;EAMV,QAAQ;;;;;wBAMM,WAAW,UAAS,uBAA4B;;;;qBA8DnD,MAAI;;;cCnGJ,+DAA4B;;;;;;;;;;;;;;;;;;;KA2E7B,yBAAyB,mBAC5B;;;qBClFI"}

package/dist/index.js

@@ -1,18 +1,18 @@
 import { NoSuchModelError } from "@ai-sdk/provider";
-import { WORKFLOW_DESERIALIZE, WORKFLOW_SERIALIZE, combineHeaders, createBinaryResponseHandler, createJsonErrorResponseHandler, loadApiKey, parseProviderOptions, postJsonToApi, serializeModelOptions, withUserAgentSuffix } from "@ai-sdk/provider-utils";
+import { WORKFLOW_DESERIALIZE, WORKFLOW_SERIALIZE, combineHeaders, createBinaryResponseHandler, createJsonErrorResponseHandler, lazySchema, loadApiKey, parseProviderOptions, postJsonToApi, serializeModelOptions, withUserAgentSuffix, zodSchema } from "@ai-sdk/provider-utils";
 import { z } from "zod/v4";
 //#region src/hume-error.ts
-const humeErrorDataSchema = z.object({ error: z.object({
+const humeErrorDataSchema = lazySchema(() => zodSchema(z.object({ error: z.object({
 	message: z.string(),
 	code: z.number()
-}) });
+}) })));
 const humeFailedResponseHandler = createJsonErrorResponseHandler({
 	errorSchema: humeErrorDataSchema,
 	errorToMessage: (data) => data.error.message
 });
 //#endregion
 //#region src/hume-speech-model-options.ts
-const humeSpeechModelOptionsSchema = z.object({ 
+const humeSpeechModelOptionsSchema = lazySchema(() => zodSchema(z.object({ 
 /**
 * Context for the speech synthesis request.
 * Can be either a generationId for retrieving a previous generation,
@@ -66,7 +66,7 @@ utterances: z.array(z.object({
 		*/
 		provider: z.enum(["HUME_AI", "CUSTOM_VOICE"]).optional()
 	})).optional()
-})) })).nullish() });
+})) })).nullish() })));
 //#endregion
 //#region src/hume-speech-model.ts
 var HumeSpeechModel = class HumeSpeechModel {
@@ -175,7 +175,7 @@ var HumeSpeechModel = class HumeSpeechModel {
 };
 //#endregion
 //#region src/version.ts
-const VERSION = "3.0.64";
+const VERSION = "3.0.66";
 //#endregion
 //#region src/hume-provider.ts
 /**

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/hume-error.ts","../src/hume-speech-model-options.ts","../src/hume-speech-model.ts","../src/version.ts","../src/hume-provider.ts"],"sourcesContent":["import { z } from 'zod/v4';\nimport { createJsonErrorResponseHandler } from '@ai-sdk/provider-utils';\n\nexport const humeErrorDataSchema = z.object({\n  error: z.object({\n    message: z.string(),\n    code: z.number(),\n  }),\n});\n\nexport type HumeErrorData = z.infer<typeof humeErrorDataSchema>;\n\nexport const humeFailedResponseHandler = createJsonErrorResponseHandler({\n  errorSchema: humeErrorDataSchema,\n  errorToMessage: data => data.error.message,\n});\n","import { z } from 'zod/v4';\n\n// https://dev.hume.ai/reference/text-to-speech-tts/synthesize-file\nexport const humeSpeechModelOptionsSchema = z.object({\n  /**\n   * Context for the speech synthesis request.\n   * Can be either a generationId for retrieving a previous generation,\n   * or a list of utterances to synthesize.\n   */\n  context: z\n    .object({\n      /**\n       * ID of a previously generated speech synthesis to retrieve.\n       */\n      generationId: z.string(),\n    })\n    .or(\n      z.object({\n        /**\n         * List of utterances to synthesize into speech.\n         */\n        utterances: z.array(\n          z.object({\n            /**\n             * The text content to convert to speech.\n             */\n            text: z.string(),\n            /**\n             * Optional description or instructions for how the text should be spoken.\n             */\n            description: z.string().optional(),\n            /**\n             * Optional speech rate multiplier.\n             */\n            speed: z.number().optional(),\n            /**\n             * Optional duration of silence to add after the utterance in seconds.\n             */\n            trailingSilence: z.number().optional(),\n            /**\n             * Voice configuration for the utterance.\n             * Can be specified by ID or name.\n             */\n            voice: z\n              .object({\n                /**\n                 * ID of the voice to use.\n                 */\n                id: z.string(),\n                /**\n                 * Provider of the voice, either Hume's built-in voices or a custom voice.\n                 */\n                provider: z.enum(['HUME_AI', 'CUSTOM_VOICE']).optional(),\n              })\n              .or(\n                z.object({\n                  /**\n                   * Name of the voice to use.\n                   */\n                  name: z.string(),\n                  /**\n                   * Provider of the voice, either Hume's built-in voices or a custom voice.\n                   */\n                  provider: z.enum(['HUME_AI', 'CUSTOM_VOICE']).optional(),\n                }),\n              )\n              .optional(),\n          }),\n        ),\n      }),\n    )\n    .nullish(),\n});\n\nexport type HumeSpeechModelOptions = z.infer<\n  typeof humeSpeechModelOptionsSchema\n>;\n","import type { SpeechModelV4, SharedV4Warning } from '@ai-sdk/provider';\nimport {\n  combineHeaders,\n  createBinaryResponseHandler,\n  parseProviderOptions,\n  postJsonToApi,\n  serializeModelOptions,\n  WORKFLOW_SERIALIZE,\n  WORKFLOW_DESERIALIZE,\n} from '@ai-sdk/provider-utils';\nimport type { HumeConfig } from './hume-config';\nimport { humeFailedResponseHandler } from './hume-error';\nimport { humeSpeechModelOptionsSchema } from './hume-speech-model-options';\nimport type { HumeSpeechAPITypes } from './hume-api-types';\n\ninterface HumeSpeechModelConfig extends HumeConfig {\n  _internal?: {\n    currentDate?: () => Date;\n  };\n}\n\nexport class HumeSpeechModel implements SpeechModelV4 {\n  readonly specificationVersion = 'v4';\n\n  get provider(): string {\n    return this.config.provider;\n  }\n\n  static [WORKFLOW_SERIALIZE](model: HumeSpeechModel) {\n    return serializeModelOptions({\n      modelId: model.modelId,\n      config: model.config,\n    });\n  }\n\n  static [WORKFLOW_DESERIALIZE](options: {\n    modelId: '';\n    config: HumeSpeechModelConfig;\n  }) {\n    return new HumeSpeechModel(options.modelId as '', options.config);\n  }\n\n  constructor(\n    readonly modelId: '',\n    private readonly config: HumeSpeechModelConfig,\n  ) {}\n\n  private async getArgs({\n    text,\n    voice = 'd8ab67c6-953d-4bd8-9370-8fa53a0f1453',\n    outputFormat = 'mp3',\n    speed,\n    instructions,\n    language,\n    providerOptions,\n  }: Parameters<SpeechModelV4['doGenerate']>[0]) {\n    const warnings: SharedV4Warning[] = [];\n\n    // Parse provider options\n    const humeOptions = await parseProviderOptions({\n      provider: 'hume',\n      providerOptions,\n      schema: humeSpeechModelOptionsSchema,\n    });\n\n    // Create request body\n    const requestBody: HumeSpeechAPITypes = {\n      utterances: [\n        {\n          text,\n          speed,\n          description: instructions,\n          voice: {\n            id: voice,\n            provider: 'HUME_AI',\n          },\n        },\n      ],\n      format: { type: 'mp3' },\n    };\n\n    if (outputFormat) {\n      if (['mp3', 'pcm', 'wav'].includes(outputFormat)) {\n        requestBody.format = { type: outputFormat as 'mp3' | 'pcm' | 'wav' };\n      } else {\n        warnings.push({\n          type: 'unsupported',\n          feature: 'outputFormat',\n          details: `Unsupported output format: ${outputFormat}. Using mp3 instead.`,\n        });\n      }\n    }\n\n    // Add provider-specific options\n    if (humeOptions) {\n      const speechModelOptions: Omit<\n        HumeSpeechAPITypes,\n        'utterances' | 'format'\n      > = {};\n\n      if (humeOptions.context) {\n        if ('generationId' in humeOptions.context) {\n          speechModelOptions.context = {\n            generation_id: humeOptions.context.generationId,\n          };\n        } else {\n          speechModelOptions.context = {\n            utterances: humeOptions.context.utterances.map(utterance => ({\n              text: utterance.text,\n              description: utterance.description,\n              speed: utterance.speed,\n              trailing_silence: utterance.trailingSilence,\n              voice: utterance.voice,\n            })),\n          };\n        }\n      }\n\n      for (const key in speechModelOptions) {\n        const value =\n          speechModelOptions[\n            key as keyof Omit<HumeSpeechAPITypes, 'utterances' | 'format'>\n          ];\n        if (value !== undefined) {\n          (requestBody as Record<string, unknown>)[key] = value;\n        }\n      }\n    }\n\n    if (language) {\n      warnings.push({\n        type: 'unsupported',\n        feature: 'language',\n        details: `Hume speech models do not support language selection. Language parameter \"${language}\" was ignored.`,\n      });\n    }\n\n    return {\n      requestBody,\n      warnings,\n    };\n  }\n\n  async doGenerate(\n    options: Parameters<SpeechModelV4['doGenerate']>[0],\n  ): Promise<Awaited<ReturnType<SpeechModelV4['doGenerate']>>> {\n    const currentDate = this.config._internal?.currentDate?.() ?? new Date();\n    const { requestBody, warnings } = await this.getArgs(options);\n\n    const {\n      value: audio,\n      responseHeaders,\n      rawValue: rawResponse,\n    } = await postJsonToApi({\n      url: this.config.url({\n        path: '/v0/tts/file',\n        modelId: this.modelId,\n      }),\n      headers: combineHeaders(this.config.headers?.(), options.headers),\n      body: requestBody,\n      failedResponseHandler: humeFailedResponseHandler,\n      successfulResponseHandler: createBinaryResponseHandler(),\n      abortSignal: options.abortSignal,\n      fetch: this.config.fetch,\n    });\n\n    return {\n      audio,\n      warnings,\n      request: {\n        body: JSON.stringify(requestBody),\n      },\n      response: {\n        timestamp: currentDate,\n        modelId: this.modelId,\n        headers: responseHeaders,\n        body: rawResponse,\n      },\n    };\n  }\n}\n","// Version string of this package injected at build time.\ndeclare const __PACKAGE_VERSION__: string | undefined;\nexport const VERSION: string =\n  typeof __PACKAGE_VERSION__ !== 'undefined'\n    ? __PACKAGE_VERSION__\n    : '0.0.0-test';\n","import {\n  NoSuchModelError,\n  type SpeechModelV4,\n  type ProviderV4,\n} from '@ai-sdk/provider';\nimport {\n  loadApiKey,\n  withUserAgentSuffix,\n  type FetchFunction,\n} from '@ai-sdk/provider-utils';\nimport { HumeSpeechModel } from './hume-speech-model';\nimport { VERSION } from './version';\n\nexport interface HumeProvider extends ProviderV4 {\n  (settings?: {}): {\n    speech: HumeSpeechModel;\n  };\n\n  /**\n   * Creates a model for speech synthesis.\n   */\n  speech(): SpeechModelV4;\n}\n\nexport interface HumeProviderSettings {\n  /**\n   * API key for authenticating requests.\n   */\n  apiKey?: string;\n\n  /**\n   * Custom headers to include in the requests.\n   */\n  headers?: Record<string, string>;\n\n  /**\n   * Custom fetch implementation. You can use it as a middleware to intercept requests,\n   * or to provide a custom fetch implementation for e.g. testing.\n   */\n  fetch?: FetchFunction;\n}\n\n/**\n * Create an Hume provider instance.\n */\nexport function createHume(options: HumeProviderSettings = {}): HumeProvider {\n  const getHeaders = () =>\n    withUserAgentSuffix(\n      {\n        'X-Hume-Api-Key': loadApiKey({\n          apiKey: options.apiKey,\n          environmentVariableName: 'HUME_API_KEY',\n          description: 'Hume',\n        }),\n        ...options.headers,\n      },\n      `ai-sdk-hume/${VERSION}`,\n    );\n\n  const createSpeechModel = () =>\n    new HumeSpeechModel('', {\n      provider: `hume.speech`,\n      url: ({ path }) => `https://api.hume.ai${path}`,\n      headers: getHeaders,\n      fetch: options.fetch,\n    });\n\n  const provider = function () {\n    return {\n      speech: createSpeechModel(),\n    };\n  };\n\n  provider.specificationVersion = 'v4' as const;\n  provider.speech = createSpeechModel;\n  provider.speechModel = createSpeechModel;\n\n  provider.languageModel = (modelId: string) => {\n    throw new NoSuchModelError({\n      modelId,\n      modelType: 'languageModel',\n      message: 'Hume does not provide language models',\n    });\n  };\n\n  provider.embeddingModel = (modelId: string) => {\n    throw new NoSuchModelError({\n      modelId,\n      modelType: 'embeddingModel',\n      message: 'Hume does not provide embedding models',\n    });\n  };\n\n  provider.imageModel = (modelId: string) => {\n    throw new NoSuchModelError({\n      modelId,\n      modelType: 'imageModel',\n      message: 'Hume does not provide image models',\n    });\n  };\n\n  return provider as HumeProvider;\n}\n\n/**\n * Default Hume provider instance.\n */\nexport const hume = createHume();\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/hume-error.ts","../src/hume-speech-model-options.ts","../src/hume-speech-model.ts","../src/version.ts","../src/hume-provider.ts"],"sourcesContent":["import { z } from 'zod/v4';\nimport {\n  lazySchema,\n  zodSchema,\n  type InferSchema,\n  createJsonErrorResponseHandler,\n} from '@ai-sdk/provider-utils';\n\nexport const humeErrorDataSchema = lazySchema(() =>\n  zodSchema(\n    z.object({\n      error: z.object({\n        message: z.string(),\n        code: z.number(),\n      }),\n    }),\n  ),\n);\n\nexport type HumeErrorData = InferSchema<typeof humeErrorDataSchema>;\n\nexport const humeFailedResponseHandler = createJsonErrorResponseHandler({\n  errorSchema: humeErrorDataSchema,\n  errorToMessage: data => data.error.message,\n});\n","import {\n  lazySchema,\n  zodSchema,\n  type InferSchema,\n} from '@ai-sdk/provider-utils';\nimport { z } from 'zod/v4';\n\n// https://dev.hume.ai/reference/text-to-speech-tts/synthesize-file\nexport const humeSpeechModelOptionsSchema = lazySchema(() =>\n  zodSchema(\n    z.object({\n      /**\n       * Context for the speech synthesis request.\n       * Can be either a generationId for retrieving a previous generation,\n       * or a list of utterances to synthesize.\n       */\n      context: z\n        .object({\n          /**\n           * ID of a previously generated speech synthesis to retrieve.\n           */\n          generationId: z.string(),\n        })\n        .or(\n          z.object({\n            /**\n             * List of utterances to synthesize into speech.\n             */\n            utterances: z.array(\n              z.object({\n                /**\n                 * The text content to convert to speech.\n                 */\n                text: z.string(),\n                /**\n                 * Optional description or instructions for how the text should be spoken.\n                 */\n                description: z.string().optional(),\n                /**\n                 * Optional speech rate multiplier.\n                 */\n                speed: z.number().optional(),\n                /**\n                 * Optional duration of silence to add after the utterance in seconds.\n                 */\n                trailingSilence: z.number().optional(),\n                /**\n                 * Voice configuration for the utterance.\n                 * Can be specified by ID or name.\n                 */\n                voice: z\n                  .object({\n                    /**\n                     * ID of the voice to use.\n                     */\n                    id: z.string(),\n                    /**\n                     * Provider of the voice, either Hume's built-in voices or a custom voice.\n                     */\n                    provider: z.enum(['HUME_AI', 'CUSTOM_VOICE']).optional(),\n                  })\n                  .or(\n                    z.object({\n                      /**\n                       * Name of the voice to use.\n                       */\n                      name: z.string(),\n                      /**\n                       * Provider of the voice, either Hume's built-in voices or a custom voice.\n                       */\n                      provider: z.enum(['HUME_AI', 'CUSTOM_VOICE']).optional(),\n                    }),\n                  )\n                  .optional(),\n              }),\n            ),\n          }),\n        )\n        .nullish(),\n    }),\n  ),\n);\n\nexport type HumeSpeechModelOptions = InferSchema<\n  typeof humeSpeechModelOptionsSchema\n>;\n","import type { SpeechModelV4, SharedV4Warning } from '@ai-sdk/provider';\nimport {\n  combineHeaders,\n  createBinaryResponseHandler,\n  parseProviderOptions,\n  postJsonToApi,\n  serializeModelOptions,\n  WORKFLOW_SERIALIZE,\n  WORKFLOW_DESERIALIZE,\n} from '@ai-sdk/provider-utils';\nimport type { HumeConfig } from './hume-config';\nimport { humeFailedResponseHandler } from './hume-error';\nimport { humeSpeechModelOptionsSchema } from './hume-speech-model-options';\nimport type { HumeSpeechAPITypes } from './hume-api-types';\n\ninterface HumeSpeechModelConfig extends HumeConfig {\n  _internal?: {\n    currentDate?: () => Date;\n  };\n}\n\nexport class HumeSpeechModel implements SpeechModelV4 {\n  readonly specificationVersion = 'v4';\n\n  get provider(): string {\n    return this.config.provider;\n  }\n\n  static [WORKFLOW_SERIALIZE](model: HumeSpeechModel) {\n    return serializeModelOptions({\n      modelId: model.modelId,\n      config: model.config,\n    });\n  }\n\n  static [WORKFLOW_DESERIALIZE](options: {\n    modelId: '';\n    config: HumeSpeechModelConfig;\n  }) {\n    return new HumeSpeechModel(options.modelId as '', options.config);\n  }\n\n  constructor(\n    readonly modelId: '',\n    private readonly config: HumeSpeechModelConfig,\n  ) {}\n\n  private async getArgs({\n    text,\n    voice = 'd8ab67c6-953d-4bd8-9370-8fa53a0f1453',\n    outputFormat = 'mp3',\n    speed,\n    instructions,\n    language,\n    providerOptions,\n  }: Parameters<SpeechModelV4['doGenerate']>[0]) {\n    const warnings: SharedV4Warning[] = [];\n\n    // Parse provider options\n    const humeOptions = await parseProviderOptions({\n      provider: 'hume',\n      providerOptions,\n      schema: humeSpeechModelOptionsSchema,\n    });\n\n    // Create request body\n    const requestBody: HumeSpeechAPITypes = {\n      utterances: [\n        {\n          text,\n          speed,\n          description: instructions,\n          voice: {\n            id: voice,\n            provider: 'HUME_AI',\n          },\n        },\n      ],\n      format: { type: 'mp3' },\n    };\n\n    if (outputFormat) {\n      if (['mp3', 'pcm', 'wav'].includes(outputFormat)) {\n        requestBody.format = { type: outputFormat as 'mp3' | 'pcm' | 'wav' };\n      } else {\n        warnings.push({\n          type: 'unsupported',\n          feature: 'outputFormat',\n          details: `Unsupported output format: ${outputFormat}. Using mp3 instead.`,\n        });\n      }\n    }\n\n    // Add provider-specific options\n    if (humeOptions) {\n      const speechModelOptions: Omit<\n        HumeSpeechAPITypes,\n        'utterances' | 'format'\n      > = {};\n\n      if (humeOptions.context) {\n        if ('generationId' in humeOptions.context) {\n          speechModelOptions.context = {\n            generation_id: humeOptions.context.generationId,\n          };\n        } else {\n          speechModelOptions.context = {\n            utterances: humeOptions.context.utterances.map(utterance => ({\n              text: utterance.text,\n              description: utterance.description,\n              speed: utterance.speed,\n              trailing_silence: utterance.trailingSilence,\n              voice: utterance.voice,\n            })),\n          };\n        }\n      }\n\n      for (const key in speechModelOptions) {\n        const value =\n          speechModelOptions[\n            key as keyof Omit<HumeSpeechAPITypes, 'utterances' | 'format'>\n          ];\n        if (value !== undefined) {\n          (requestBody as Record<string, unknown>)[key] = value;\n        }\n      }\n    }\n\n    if (language) {\n      warnings.push({\n        type: 'unsupported',\n        feature: 'language',\n        details: `Hume speech models do not support language selection. Language parameter \"${language}\" was ignored.`,\n      });\n    }\n\n    return {\n      requestBody,\n      warnings,\n    };\n  }\n\n  async doGenerate(\n    options: Parameters<SpeechModelV4['doGenerate']>[0],\n  ): Promise<Awaited<ReturnType<SpeechModelV4['doGenerate']>>> {\n    const currentDate = this.config._internal?.currentDate?.() ?? new Date();\n    const { requestBody, warnings } = await this.getArgs(options);\n\n    const {\n      value: audio,\n      responseHeaders,\n      rawValue: rawResponse,\n    } = await postJsonToApi({\n      url: this.config.url({\n        path: '/v0/tts/file',\n        modelId: this.modelId,\n      }),\n      headers: combineHeaders(this.config.headers?.(), options.headers),\n      body: requestBody,\n      failedResponseHandler: humeFailedResponseHandler,\n      successfulResponseHandler: createBinaryResponseHandler(),\n      abortSignal: options.abortSignal,\n      fetch: this.config.fetch,\n    });\n\n    return {\n      audio,\n      warnings,\n      request: {\n        body: JSON.stringify(requestBody),\n      },\n      response: {\n        timestamp: currentDate,\n        modelId: this.modelId,\n        headers: responseHeaders,\n        body: rawResponse,\n      },\n    };\n  }\n}\n","// Version string of this package injected at build time.\ndeclare const __PACKAGE_VERSION__: string | undefined;\nexport const VERSION: string =\n  typeof __PACKAGE_VERSION__ !== 'undefined'\n    ? __PACKAGE_VERSION__\n    : '0.0.0-test';\n","import {\n  NoSuchModelError,\n  type SpeechModelV4,\n  type ProviderV4,\n} from '@ai-sdk/provider';\nimport {\n  loadApiKey,\n  withUserAgentSuffix,\n  type FetchFunction,\n} from '@ai-sdk/provider-utils';\nimport { HumeSpeechModel } from './hume-speech-model';\nimport { VERSION } from './version';\n\nexport interface HumeProvider extends ProviderV4 {\n  (settings?: {}): {\n    speech: HumeSpeechModel;\n  };\n\n  /**\n   * Creates a model for speech synthesis.\n   */\n  speech(): SpeechModelV4;\n}\n\nexport interface HumeProviderSettings {\n  /**\n   * API key for authenticating requests.\n   */\n  apiKey?: string;\n\n  /**\n   * Custom headers to include in the requests.\n   */\n  headers?: Record<string, string>;\n\n  /**\n   * Custom fetch implementation. You can use it as a middleware to intercept requests,\n   * or to provide a custom fetch implementation for e.g. testing.\n   */\n  fetch?: FetchFunction;\n}\n\n/**\n * Create an Hume provider instance.\n */\nexport function createHume(options: HumeProviderSettings = {}): HumeProvider {\n  const getHeaders = () =>\n    withUserAgentSuffix(\n      {\n        'X-Hume-Api-Key': loadApiKey({\n          apiKey: options.apiKey,\n          environmentVariableName: 'HUME_API_KEY',\n          description: 'Hume',\n        }),\n        ...options.headers,\n      },\n      `ai-sdk-hume/${VERSION}`,\n    );\n\n  const createSpeechModel = () =>\n    new HumeSpeechModel('', {\n      provider: `hume.speech`,\n      url: ({ path }) => `https://api.hume.ai${path}`,\n      headers: getHeaders,\n      fetch: options.fetch,\n    });\n\n  const provider = function () {\n    return {\n      speech: createSpeechModel(),\n    };\n  };\n\n  provider.specificationVersion = 'v4' as const;\n  provider.speech = createSpeechModel;\n  provider.speechModel = createSpeechModel;\n\n  provider.languageModel = (modelId: string) => {\n    throw new NoSuchModelError({\n      modelId,\n      modelType: 'languageModel',\n      message: 'Hume does not provide language models',\n    });\n  };\n\n  provider.embeddingModel = (modelId: string) => {\n    throw new NoSuchModelError({\n      modelId,\n      modelType: 'embeddingModel',\n      message: 'Hume does not provide embedding models',\n    });\n  };\n\n  provider.imageModel = (modelId: string) => {\n    throw new NoSuchModelError({\n      modelId,\n      modelType: 'imageModel',\n      message: 'Hume does not provide image models',\n    });\n  };\n\n  return provider as HumeProvider;\n}\n\n/**\n * Default Hume provider instance.\n */\nexport const hume = createHume();\n"],"mappings":"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"}

package/docs/150-hume.mdx

@@ -1,17 +1,59 @@
 ---
 title: Hume
-description: Learn how to use the Hume provider for the AI SDK.
+description: Learn how to set up the Hume provider and check AI Gateway availability.
 ---
 
 # Hume Provider
 
 The [Hume](https://hume.ai/) provider contains support for the Hume text-to-speech (TTS) API.
+Hume models are not currently available through [AI Gateway](https://vercel.com/ai-gateway/models), so the opening example uses `@ai-sdk/hume` directly. See [Using AI Gateway](#using-ai-gateway) below for supported alternatives.
 
-## Setup
+```ts
+import { generateSpeech } from 'ai';
+import { hume } from '@ai-sdk/hume';
+import { writeFile } from 'node:fs/promises';
+
+const { audio } = await generateSpeech({
+  model: hume.speech(),
+  text: 'Hello, world!',
+  outputFormat: 'mp3',
+});
+
+await writeFile('speech.mp3', audio.uint8Array);
+```
+
+## Using AI Gateway
+
+The current [AI Gateway model catalog](https://vercel.com/ai-gateway/models) does not list Hume models. Use `@ai-sdk/hume` for the APIs on this page. To use other speech models through Gateway, install `ai` and configure a Gateway API key:
 
-The Hume provider is available in the `@ai-sdk/hume` module. You can install it with
+<InstallPackages packages="ai" />
 
-<InstallPackages packages="@ai-sdk/hume" />
+Set an [AI Gateway API key](https://vercel.com/docs/ai-gateway/getting-started) in your environment:
+
+```bash
+export AI_GATEWAY_API_KEY=your_api_key_here
+```
+
+Vercel deployments can also use [OIDC authentication](/providers/ai-sdk-providers/ai-gateway#oidc-authentication-vercel-deployments).
+See the [Gateway documentation](/providers/ai-sdk-providers/ai-gateway) for supported models and APIs.
+
+## Using `@ai-sdk/hume`
+
+For direct access to Hume, install `ai` and `@ai-sdk/hume`:
+
+<InstallPackages packages="ai @ai-sdk/hume" />
+
+Set your Hume API credential in the `HUME_API_KEY` environment variable:
+
+```bash
+export HUME_API_KEY=your_api_key_here
+```
+
+<Note>
+  The following sections document the direct `@ai-sdk/hume` provider, including
+  its model factories and settings. Gateway model and feature availability can
+  differ.
+</Note>
 
 ## Provider Instance
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/hume",
-  "version": "3.0.64",
+  "version": "3.0.66",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -29,8 +29,8 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/provider": "4.0.31",
-    "@ai-sdk/provider-utils": "5.0.64"
+    "@ai-sdk/provider": "4.0.32",
+    "@ai-sdk/provider-utils": "5.0.66"
   },
   "devDependencies": {
     "@ai-sdk/test-server": "2.0.4",

package/src/hume-error.ts

@@ -1,14 +1,23 @@
 import { z } from 'zod/v4';
-import { createJsonErrorResponseHandler } from '@ai-sdk/provider-utils';
+import {
+  lazySchema,
+  zodSchema,
+  type InferSchema,
+  createJsonErrorResponseHandler,
+} from '@ai-sdk/provider-utils';
 
-export const humeErrorDataSchema = z.object({
-  error: z.object({
-    message: z.string(),
-    code: z.number(),
-  }),
-});
+export const humeErrorDataSchema = lazySchema(() =>
+  zodSchema(
+    z.object({
+      error: z.object({
+        message: z.string(),
+        code: z.number(),
+      }),
+    }),
+  ),
+);
 
-export type HumeErrorData = z.infer<typeof humeErrorDataSchema>;
+export type HumeErrorData = InferSchema<typeof humeErrorDataSchema>;
 
 export const humeFailedResponseHandler = createJsonErrorResponseHandler({
   errorSchema: humeErrorDataSchema,

package/src/hume-speech-model-options.ts

@@ -1,77 +1,86 @@
+import {
+  lazySchema,
+  zodSchema,
+  type InferSchema,
+} from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
 
 // https://dev.hume.ai/reference/text-to-speech-tts/synthesize-file
-export const humeSpeechModelOptionsSchema = z.object({
-  /**
-   * Context for the speech synthesis request.
-   * Can be either a generationId for retrieving a previous generation,
-   * or a list of utterances to synthesize.
-   */
-  context: z
-    .object({
+export const humeSpeechModelOptionsSchema = lazySchema(() =>
+  zodSchema(
+    z.object({
       /**
-       * ID of a previously generated speech synthesis to retrieve.
+       * Context for the speech synthesis request.
+       * Can be either a generationId for retrieving a previous generation,
+       * or a list of utterances to synthesize.
        */
-      generationId: z.string(),
-    })
-    .or(
-      z.object({
-        /**
-         * List of utterances to synthesize into speech.
-         */
-        utterances: z.array(
+      context: z
+        .object({
+          /**
+           * ID of a previously generated speech synthesis to retrieve.
+           */
+          generationId: z.string(),
+        })
+        .or(
           z.object({
             /**
-             * The text content to convert to speech.
+             * List of utterances to synthesize into speech.
              */
-            text: z.string(),
-            /**
-             * Optional description or instructions for how the text should be spoken.
-             */
-            description: z.string().optional(),
-            /**
-             * Optional speech rate multiplier.
-             */
-            speed: z.number().optional(),
-            /**
-             * Optional duration of silence to add after the utterance in seconds.
-             */
-            trailingSilence: z.number().optional(),
-            /**
-             * Voice configuration for the utterance.
-             * Can be specified by ID or name.
-             */
-            voice: z
-              .object({
+            utterances: z.array(
+              z.object({
+                /**
+                 * The text content to convert to speech.
+                 */
+                text: z.string(),
+                /**
+                 * Optional description or instructions for how the text should be spoken.
+                 */
+                description: z.string().optional(),
+                /**
+                 * Optional speech rate multiplier.
+                 */
+                speed: z.number().optional(),
                 /**
-                 * ID of the voice to use.
+                 * Optional duration of silence to add after the utterance in seconds.
                  */
-                id: z.string(),
+                trailingSilence: z.number().optional(),
                 /**
-                 * Provider of the voice, either Hume's built-in voices or a custom voice.
+                 * Voice configuration for the utterance.
+                 * Can be specified by ID or name.
                  */
-                provider: z.enum(['HUME_AI', 'CUSTOM_VOICE']).optional(),
-              })
-              .or(
-                z.object({
-                  /**
-                   * Name of the voice to use.
-                   */
-                  name: z.string(),
-                  /**
-                   * Provider of the voice, either Hume's built-in voices or a custom voice.
-                   */
-                  provider: z.enum(['HUME_AI', 'CUSTOM_VOICE']).optional(),
-                }),
-              )
-              .optional(),
+                voice: z
+                  .object({
+                    /**
+                     * ID of the voice to use.
+                     */
+                    id: z.string(),
+                    /**
+                     * Provider of the voice, either Hume's built-in voices or a custom voice.
+                     */
+                    provider: z.enum(['HUME_AI', 'CUSTOM_VOICE']).optional(),
+                  })
+                  .or(
+                    z.object({
+                      /**
+                       * Name of the voice to use.
+                       */
+                      name: z.string(),
+                      /**
+                       * Provider of the voice, either Hume's built-in voices or a custom voice.
+                       */
+                      provider: z.enum(['HUME_AI', 'CUSTOM_VOICE']).optional(),
+                    }),
+                  )
+                  .optional(),
+              }),
+            ),
           }),
-        ),
-      }),
-    )
-    .nullish(),
-});
+        )
+        .nullish(),
+    }),
+  ),
+);
 
-export type HumeSpeechModelOptions = z.infer<
+export type HumeSpeechModelOptions = InferSchema<
   typeof humeSpeechModelOptionsSchema
 >;