# Voices

## Create voice

**post** `/audio/voices`

Creates a voice from a text prompt or from a consent recording and an audio sample.

For prompt-based creation, send `type: "prompt"` with a `name` and `prompt` as JSON or multipart form data. For creation from an audio sample, send `type: "audio_sample"` with a `name`, `audio_sample`, and `consent` recording ID as multipart form data. The type defaults to `audio_sample` when omitted.

Returns the saved voice's metadata. Voices created from text prompts are supported only in Live, not in Realtime or the speech endpoint. The response does not include preview audio.

### Body Parameters

- `name: string`

  The name of the new voice.

- `prompt: string`

  A description of the desired voice. Must not contain only whitespace.

- `type: "prompt"`

  Set to `prompt` to create a voice from a text description.

  - `"prompt"`

- `model: optional string or "auto" or "2026-10-08"`

  The voice creation model to use. Defaults to `auto`.

  - `string`

  - `"auto" or "2026-10-08"`

    The voice creation model to use. Defaults to `auto`.

    - `"auto"`

    - `"2026-10-08"`

- `script_hint: optional string`

  Optional text for the voice to speak during creation. If omitted, a script is generated from the prompt. Must not be blank after trimming whitespace; scripts that are too short are rejected.

### Returns

- `Voice object { id, created_at, name, 3 more }`

  A custom voice that can be used for audio output. Voices created from text prompts are supported only in Live.

  - `id: string`

    The voice identifier, which can be referenced in API endpoints.

  - `created_at: number`

    The Unix timestamp (in seconds) for when the voice was created.

  - `name: string`

    The name of the voice.

  - `object: "audio.voice"`

    The object type, which is always `audio.voice`.

    - `"audio.voice"`

  - `type: "audio_sample" or "prompt"`

    How the voice was created.

    - `"audio_sample"`

    - `"prompt"`

  - `prompt: optional string`

    The original text prompt used to create the voice. Present for prompt-generated voices with a stored prompt; omitted for audio-sample voices and older voices without a stored prompt.

### Example

```http
curl https://api.openai.com/v1/audio/voices \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -d '{
          "name": "x",
          "prompt": "x",
          "type": "prompt"
        }'
```

#### Response

```json
{
  "id": "id",
  "created_at": 0,
  "name": "name",
  "object": "audio.voice",
  "type": "audio_sample",
  "prompt": "prompt"
}
```

### Example

```http
curl https://api.openai.com/v1/audio/voices \
  -X POST \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "prompt",
    "name": "Warm narrator",
    "prompt": "A warm, calm narrator with a clear, measured delivery.",
    "model": "auto"
  }'
```

## Delete voice

**delete** `/audio/voices/{voice_id}`

Deletes a voice created from a text prompt or an audio sample.

Requires voice write permission and access to the voice's project. Access to voices created from recordings is limited to eligible customers. See the [custom voices guide](https://developers.openai.com/api/docs/guides/custom-voices).

Deleting a voice does not delete its consent recording. Deleting an already deleted voice returns a 404 error.

### Path Parameters

- `voice_id: string`

### Returns

- `VoiceDeleted object { id, deleted, object }`

  - `id: string`

    The voice identifier.

  - `deleted: boolean`

    Whether the voice was deleted.

  - `object: "audio.voice.deleted"`

    The object type, which is always `audio.voice.deleted`.

    - `"audio.voice.deleted"`

### Example

```http
curl https://api.openai.com/v1/audio/voices/$VOICE_ID \
    -X DELETE \
    -H "Authorization: Bearer $OPENAI_API_KEY"
```

#### Response

```json
{
  "id": "voice_1234",
  "deleted": true,
  "object": "audio.voice.deleted"
}
```

### Example

```http
curl https://api.openai.com/v1/audio/voices/voice_1234 \
  -X DELETE \
  -H "Authorization: Bearer $OPENAI_API_KEY"
```

#### Response

```json
{
  "id": "voice_1234",
  "object": "audio.voice.deleted",
  "deleted": true
}
```

## Domain Types

### Voice

- `Voice object { id, created_at, name, 3 more }`

  A custom voice that can be used for audio output. Voices created from text prompts are supported only in Live.

  - `id: string`

    The voice identifier, which can be referenced in API endpoints.

  - `created_at: number`

    The Unix timestamp (in seconds) for when the voice was created.

  - `name: string`

    The name of the voice.

  - `object: "audio.voice"`

    The object type, which is always `audio.voice`.

    - `"audio.voice"`

  - `type: "audio_sample" or "prompt"`

    How the voice was created.

    - `"audio_sample"`

    - `"prompt"`

  - `prompt: optional string`

    The original text prompt used to create the voice. Present for prompt-generated voices with a stored prompt; omitted for audio-sample voices and older voices without a stored prompt.

### Voice Deleted

- `VoiceDeleted object { id, deleted, object }`

  - `id: string`

    The voice identifier.

  - `deleted: boolean`

    Whether the voice was deleted.

  - `object: "audio.voice.deleted"`

    The object type, which is always `audio.voice.deleted`.

    - `"audio.voice.deleted"`