> This page is for Voice APIs.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://dev.hume.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://dev.hume.ai/_mcp/server.

# Voice Conversion (Streamed File)

POST https://api.hume.ai/v0/tts/voice_conversion/file
Content-Type: multipart/form-data

Reference: https://dev.hume.ai/voice/reference/text-to-speech-tts/convert-voice-file

## Authentication

- `X-Hume-Api-Key` header (required) — API Key authentication via header

## Request

### Body (multipart/form-data)

This endpoint expects a multipart form containing a file.

- `strip_headers` (boolean, optional) — If enabled, the audio for all the chunks of a generation, once concatenated together, will constitute a single audio file. Otherwise, if disabled, each chunk's audio will be its own audio file, each with its own headers (if applicable).
- `audio` (file, required) — Audio file containing speech to be converted to the target voice. Supported formats include `MP3`, `WAV`, `M4A`, and `OGG`.
- `context` (V0TtsVoiceConversionFilePostRequestBodyContentMultipartFormDataSchemaContext, optional) — Utterances to use as context for generating consistent speech style and prosody across multiple requests. These will not be converted to speech output.
- `voice` (VoiceRef, optional)
- `format` (Format, optional) — Specifies the output audio file format.
- `include_timestamp_types` (list of enum, optional) — The set of timestamp types to include in the response. When used in multipart/form-data, specify each value using bracket notation: `include_timestamp_types[0]=word&include_timestamp_types[1]=phoneme`. Only supported for Octave 2 requests.

## Response

### 200

Successful Response

- File download.

## Errors

### 422 Unprocessable Entity Error

Validation Error

- `detail` (list of ValidationError, optional)

## Types

### ValidationError

- `loc` (list of ValidationErrorLocItems, required)
- `msg` (string, required)
- `type` (string, required)

### ValidationErrorLocItems

## Examples

**Request**

```json
{
  "audio": "<file: string>"
}
```