Hume Provider

The Hume provider contains support for the Hume text-to-speech (TTS) API.

Setup

The Hume provider is available in the @ai-sdk/hume module. You can install it with

pnpm add @ai-sdk/hume

Provider Instance

You can import the default provider instance hume from @ai-sdk/hume:

1
import { hume } from '@ai-sdk/hume';

If you need a customized setup, you can import createHume from @ai-sdk/hume and create a provider instance with your settings:

1
import { createHume } from '@ai-sdk/hume';
2

3
const hume = createHume({
4
  // custom settings, e.g.
5
  fetch: customFetch,
6
});

You can use the following optional settings to customize the Hume provider instance:

• apiKey string

  API key that is being sent using the X-Hume-Api-Key header. It defaults to the HUME_API_KEY environment variable.

• headers Record<string,string>

  Custom headers to include in the requests.

• fetch (input: RequestInfo, init?: RequestInit) => Promise<Response>

  Custom fetch implementation. Defaults to the global fetch function. You can use it as a middleware to intercept requests, or to provide a custom fetch implementation for e.g. testing.

Speech Models

You can create models that call the Hume speech API using the .speech() factory method.

1
const model = hume.speech();

You can pass standard speech generation options like voice, speed, instructions, and outputFormat:

1
import { experimental_generateSpeech as generateSpeech } from 'ai';
2
import { hume } from '@ai-sdk/hume';
3

4
const result = await generateSpeech({
5
  model: hume.speech(),
6
  text: 'Hello, world!',
7
  voice: 'd8ab67c6-953d-4bd8-9370-8fa53a0f1453',
8
  speed: 1.0,
9
  instructions: 'Speak in a friendly, conversational tone.',
10
  outputFormat: 'mp3',
11
});

Supported Parameters

• text string (required)

  The text to convert to speech.

• voice string

  The voice ID to use for the generated audio. Defaults to 'd8ab67c6-953d-4bd8-9370-8fa53a0f1453'.

• speed number

  Speech rate multiplier.

• instructions string

  Description or instructions for how the text should be spoken.

• outputFormat string

  The audio format to generate. Supported values: 'mp3', 'pcm', 'wav'. Defaults to 'mp3'.

Provider Options

You can pass additional provider-specific options using the providerOptions argument:

1
import { experimental_generateSpeech as generateSpeech } from 'ai';
2
import { hume } from '@ai-sdk/hume';
3

4
const result = await generateSpeech({
5
  model: hume.speech(),
6
  text: 'Hello, world!',
7
  providerOptions: {
8
    hume: {
9
      context: {
10
        generationId: 'previous-generation-id',
11
      },
12
    },
13
  },
14
});

The following provider options are available:

• context object

  Context for the speech synthesis request. Can be either:

  • { generationId: string } - ID of a previously generated speech synthesis to use as context.
  • { utterances: Utterance[] } - An array of utterance objects for context, where each utterance has:
    • text string (required) - The text content.
    • description string - Instructions for how the text should be spoken.
    • speed number - Speech rate multiplier.
    • trailingSilence number - Duration of silence to add after the utterance in seconds.
    • voice object - Voice configuration, either { id: string, provider?: 'HUME_AI' | 'CUSTOM_VOICE' } or { name: string, provider?: 'HUME_AI' | 'CUSTOM_VOICE' }.

Model Capabilities