> ## Documentation Index
> Fetch the complete documentation index at: https://docs.humanly.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Narrators

> List available narrators for text-to-speech audio generation

## Overview

Narrators define the voice and language options available for text-to-speech (TTS) audio generation when creating questions.

## List Narrators

List all available narrators for TTS.

**Endpoint:** `GET /qsi/gather/narrators`

<CodeGroup>
  ```json Response theme={null}
  {
    "data": [
      {
        "id": "uuid",
        "name": "Default Narrator",
        "language": "en",
        "voices": [
          {
            "id": "voice-uuid",
            "name": "Voice Name",
            "gender": "male",
            "description": "Professional male voice"
          }
        ]
      }
    ],
    "meta": {
      "requestId": "uuid",
      "timestamp": "2024-01-01T00:00:00Z"
    }
  }
  ```
</CodeGroup>

## Get Narrator

Get narrator details including available voices.

**Endpoint:** `GET /qsi/gather/narrators/{narratorId}`

<ParamField path="narratorId" type="string" required>
  UUID of the narrator
</ParamField>

<CodeGroup>
  ```json Response theme={null}
  {
    "data": {
      "id": "uuid",
      "name": "Default Narrator",
      "language": "en",
      "voices": [
        {
          "id": "voice-uuid",
          "name": "Voice Name",
          "gender": "male",
          "description": "Professional male voice"
        }
      ]
    },
    "meta": {
      "requestId": "uuid",
      "timestamp": "2024-01-01T00:00:00Z"
    }
  }
  ```
</CodeGroup>

## Using Narrators

When creating questions with `generateAudio: true`, you can specify a `narratorId`:

```json theme={null}
{
  "title": "Tell me about yourself",
  "questionScript": "Tell me about yourself and your background.",
  "narratorId": "uuid",
  "generateAudio": true
}
```

<Callout type="info">
  If no `narratorId` is specified, the default narrator for your organization will be used.
</Callout>

## Related Resources

<CardGroup cols={2}>
  <Card title="Questions" icon="file-text" href="/api-reference/questions">
    Learn how to create questions with TTS audio
  </Card>

  <Card title="Creating Your First Interview" icon="book" href="/guides/creating-first-interview">
    Step-by-step guide for creating interviews
  </Card>
</CardGroup>